빠른 시작

Alpacon을 처음 쓰는 분을 위한 5분 가이드입니다. 워크스페이스를 받는 방법부터 첫 서버에 접속하는 방법까지 순서대로 안내합니다.

시작하기 전에

Alpacon을 사용하려면 다음이 필요합니다.

  • Alpacon 워크스페이스: 데모를 신청해 AlpacaX 팀과 설정하거나 관리자에게 초대를 받아 팀의 워크스페이스에 참여합니다
  • 관리하고자 하는 서버 (Linux, macOS 또는 Windows)
  • 서버의 터미널 또는 관리자 접근 권한 (설치 명령 실행용)

Step 1: 워크스페이스 받기

워크스페이스는 서버와 팀원을 관리하는 독립적인 작업 공간입니다.

새 워크스페이스가 필요한 경우:

  1. 데모를 신청합니다.
  2. 데모에서 AlpacaX 팀과 워크스페이스 이름, URL, 리전을 정합니다.
  3. 데모가 끝나면 팀이 워크스페이스를 준비하고 사용 가능한 시점을 알려드립니다.
  4. Alpacon에 로그인합니다.

팀에 이미 워크스페이스가 있는 경우:

  1. 워크스페이스 관리자에게 초대를 요청합니다.
  2. 초대 이메일의 링크를 따르거나 Alpacon에 로그인한 뒤 “아직 워크스페이스가 없어요” 화면에서 초대를 수락합니다.

워크스페이스에는 전용 URL이 있습니다. 예: https://alpacon.io/my-production/

💡 Tip: 개발/스테이징/프로덕션 환경별로 워크스페이스를 추가하려면 AlpacaX 팀에 문의하세요.

Step 2: 첫 서버 등록 (2분)

2-1. 서버 등록 시작

Alpacon 워크스페이스에서:

  1. 좌측 메뉴에서 Servers 클릭
  2. 서버 등록 클릭
  3. 등록 방식으로 토큰으로 등록 선택
  4. 정보 입력 단계에서 입력:
    • 서버의 OS는 무엇인가요?: OS 계열 선택 (Debian 계열, Redhat 계열, macOS, Windows)
    • 서버 이름 (선택): 표시용 이름 (예: web-server-01)
    • 서버 등록 토큰 (선택): 토큰을 선택하면 접근 그룹이 자동으로 설정됩니다
  5. 계속 클릭

전체 등록 절차(Ansible, AWS Cloud-Init, Terraform 방식 포함)는 서버 등록하기를 참고하세요.

2-2. Alpamon 에이전트 설치

  1. 생성된 설치 명령 복사
  2. 서버의 터미널에서 실행 (Linux와 macOS는 sudo 사용, Windows는 관리자 권한 PowerShell 사용)
  3. 등록이 완료되면 창이 자동으로 닫힙니다
  4. 서버 목록에서 서버 상태가 온라인으로 표시되는지 확인

Windows 서버를 등록하시나요? 지원 기능, 권한 모델, 문제 해결은 Windows 서버를 참고하세요.

Step 3: 서버 접속 (1분)

Alpacon의 접근은 작업 세션으로 이뤄집니다. 접근을 요청하면 범위가 지정되고 시간이 제한됩니다.

  1. Servers 목록에서 접속할 서버 선택
  2. 연결 클릭
  3. 필요한 접근(예: 웹 터미널)과 세션 사용 시간을 선택하고 세션 시작
  4. 요청한 세션 범위로 브라우저 터미널이 열립니다

워크스페이스 정책에 따라 터미널이 열리기 전에 Superuser의 승인이 필요할 수 있습니다. 이 경우 세션이 먼저 승인 대기에서 승인됨으로 바뀝니다.

🎉 완료! 별도의 SSH 클라이언트 없이 브라우저에서 서버에 접속했습니다.

Websh 주요 기능 체험하기

터미널이 열렸다면 다음 기능을 사용해 보세요.

  • 명령어 실행: ls, top, df -h 등 일반 터미널과 동일하게 사용
  • 재연결: 작업 세션이 유지되는 동안 셸이 살아 있으므로, 탭을 닫았다가 나중에 이어서 작업할 수 있습니다
  • 설정 변경: 터미널 내 ⚙️ 아이콘으로 테마, 폰트 크기 조정

Step 4: 팀원 초대하기 (선택사항, 1분)

💎 이 기능은 Essentials 플랜 이상 (유료 버전)에서 사용 가능합니다.

팀원을 초대하여 서버 접근 권한을 공유할 수 있습니다. 스태프 또는 슈퍼유저 권한을 가진 사용자만 팀원을 초대할 수 있습니다.

  1. 좌측 메뉴에서 IAM > Users 클릭
  2. Alpacon Cloud에서는 유저 초대, 자체 호스팅에서는 신규 유저 추가 클릭
  3. Alpacon Cloud의 유저 초대 양식에서 초대할 사람의 이메일 주소 입력
  4. 초대 클릭

초대된 팀원은 이메일로 초대 링크를 받으며, 링크는 48시간 동안 유효합니다.

IAM 권한 체계

  • 멤버: 일반 사용자로, 부여된 권한 범위 내에서만 리소스에 접근 가능
  • 스태프: 관리 권한을 가진 사용자로, 일부 관리자 기능을 실행할 수 있음
  • 슈퍼유저: 모든 관리자 기능 및 워크스페이스 전반의 설정 권한 보유

다음 단계

기본 설정을 완료했습니다! 이제 Alpacon의 더 많은 기능을 살펴보세요:

보안 강화

생산성 향상

  • Websh - 팀원과 실시간 협업을 지원하는 브라우저 기반 원격 셸 터미널
  • WebFTP - 브라우저에서 손쉽게 파일 전송
  • 다중 서버 명령 - 여러 서버에서 동시에 명령 실행

고급 기능

문제가 발생했나요?

최종 수정: