Quickstart
Alpacon을 처음 시작하는 분들을 위한 5분 가이드입니다. 이 가이드를 따라하면 워크스페이스 생성부터 첫 서버 접속까지 빠르게 경험할 수 있습니다.
시작하기 전에
Alpacon을 사용하기 위해 필요한 것:
- Alpacon 계정 (회원가입)
- 관리하고자 하는 서버 (Linux, macOS 또는 Windows)
- 서버의 터미널 또는 관리자 접근 권한 (설치 명령 실행용)
Step 1: 워크스페이스 생성 (1분)
워크스페이스는 서버와 팀원을 관리하는 독립적인 작업 공간입니다.
- Alpacon에 로그인
- 화면 가운데 Start with a new workspace 클릭
- 워크스페이스 이름(예:
my-production), URL, 국가와 리전 입력 - Create 클릭
생성이 완료되면 전용 워크스페이스 URL이 자동으로 발급됩니다.
예: https://alpacon.io/my-production/
💡 Tip: 개발/스테이징/프로덕션 환경별로 별도 워크스페이스를 생성하여 관리할 수 있습니다.
Step 2: 첫 서버 등록 (2분)
2-1. 서버 등록 시작
Alpacon 워크스페이스에서:
- 좌측 메뉴에서 Servers 클릭
- 서버 등록 클릭
- 등록 방식으로 토큰으로 등록 선택
- 서버 정보 단계에서 입력:
- 서버의 OS는 무엇인가요?: OS 계열 선택 (Debian 계열, Redhat 계열, macOS, Windows)
- 서버 이름 (선택): 표시용 이름 (예:
web-server-01) - 서버 등록 토큰 (선택): 토큰을 선택하면 접근 그룹이 자동으로 설정됩니다
- 계속 클릭
전체 등록 절차(Ansible, AWS Cloud-Init, Terraform 방식 포함)는 서버 등록하기를 참고하세요.
2-2. Alpamon 에이전트 설치
- 생성된 설치 명령 복사
- 서버의 터미널에서 실행 (Linux와 macOS는
sudo사용, Windows는 관리자 권한 PowerShell 사용) - 등록이 완료되면 창이 자동으로 닫힙니다
- 서버 목록에서 서버 상태가 Connected로 표시되는지 확인
Step 3: 서버 접속 (1분)
Alpacon의 접근은 작업 세션으로 이뤄집니다. 접근을 요청하면 범위가 지정되고 시간이 제한됩니다.
- Servers 목록에서 접속할 서버 선택
- 연결 클릭
- 필요한 접근(예: 웹 터미널)과 세션 사용 시간을 선택하고 세션 시작
- 요청한 세션 범위로 브라우저 터미널이 열립니다
🎉 완료! 별도의 SSH 클라이언트 없이 브라우저에서 서버에 접속했습니다.
Websh 주요 기능 체험하기
터미널이 열렸다면 다음 기능들을 시도해보세요:
- 명령어 실행:
ls,top,df -h등 일반 터미널과 동일하게 사용 - 재연결: 작업 세션이 유지되는 동안 쉘이 살아 있으므로, 탭을 닫았다가 나중에 이어서 작업할 수 있습니다
- 설정 변경: 터미널 내 ⚙️ 아이콘으로 테마, 폰트 크기 조정
Step 4: 팀원 초대하기 (선택사항, 1분)
💎 이 기능은 Essentials 플랜 이상 (유료 버전)에서 사용 가능합니다.
팀원을 초대하여 서버 접근 권한을 공유할 수 있습니다. 스태프 또는 슈퍼유저 권한을 가진 사용자만 팀원을 초대할 수 있습니다.
- 좌측 메뉴에서 IAM > Users 클릭
- 신규 클릭
- 유저 초대 양식에서 초대할 사람의 이메일 주소 입력
- 초대 클릭
초대된 팀원은 이메일로 가입 링크를 받게 되며, 링크는 48시간 동안 유효합니다.
IAM 권한 체계
- 멤버: 일반 사용자로, 부여된 권한 범위 내에서만 리소스에 접근 가능
- 스태프: 관리 권한을 가진 사용자로, 일부 관리자 기능을 실행할 수 있음
- 슈퍼유저: 모든 관리자 기능 및 워크스페이스 전반의 설정 권한 보유
다음 단계
기본 설정을 완료했습니다! 이제 Alpacon의 더 많은 기능을 살펴보세요:
보안 강화
- 사용자 & 그룹 관리 - 세밀한 권한 제어 및 팀별 권한 일괄 설정
- 모니터링 - 서버 활동 로그 및 감사