Quickstart

Alpacon을 처음 시작하는 분들을 위한 5분 가이드입니다. 이 가이드를 따라하면 워크스페이스 생성부터 첫 서버 접속까지 빠르게 경험할 수 있습니다.

시작하기 전에

Alpacon을 사용하기 위해 필요한 것:

  • Alpacon 계정 (회원가입)
  • 관리하고자 하는 서버 (Linux 기반: Ubuntu, Debian, RHEL, CentOS 등)
  • 서버에 대한 SSH 접근 권한

Step 1: 워크스페이스 생성 (1분)

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

  1. Alpacon에 로그인
  2. 화면 가운데 Start with a new workspace 클릭
  3. 워크스페이스 이름 입력 (예: my-production), URL, 그리고 국가 입력
  4. Create 클릭

생성이 완료되면 전용 워크스페이스 URL이 자동으로 발급됩니다. 예: https://alpacon.io/my-production/

💡 Tip: 개발/스테이징/프로덕션 환경별로 별도 워크스페이스를 생성하여 관리할 수 있습니다.

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

2-1. 서버 등록 시작

Alpacon 워크스페이스에서:

  1. 좌측 메뉴에서 Servers 클릭
  2. Connect Server 버튼 클릭
  3. Connect Server 퀵뷰가 열리면 다음 정보 입력:
    • Name: 서버 식별용 이름 (예: web-server-01)
    • Platform: 서버 플랫폼 선택 (Ubuntu, Debian, RHEL, CentOS 등)
    • User Groups (Optional): 서버에 접근 가능한 사용자 그룹 선택
  4. Save 클릭

2-2. Alpamon Agent 설치

  1. 생성된 설치 스크립트 복사
  2. 서버에 SSH로 접속한 후, 복사한 스크립트를 붙여넣어 실행
  3. Alpacon 화면에서 Close 클릭
  4. 서버 목록에서 등록된 서버 상태가 Connected로 표시되는지 확인

Step 3: 웹 터미널로 서버 접속 (1분)

이제 브라우저에서 바로 서버에 접속해보겠습니다.

  1. Servers 목록에서 접속할 서버 선택
  2. 우측 상단의 Terminal 아이콘 클릭하여 서버에 접속

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

Websh 주요 기능 체험하기

터미널이 열렸다면 다음 기능들을 시도해보세요:

  • 명령어 실행: ls, top, df -h 등 일반 터미널과 동일하게 사용
  • 세션 유지: 브라우저 탭을 닫아도 세션이 유지됩니다 (다시 접속하면 작업 이어가기 가능)
  • 설정 변경: 터미널 내 ⚙️ 아이콘으로 테마, 폰트 크기 조정

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

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

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

  1. 좌측 메뉴에서 IAM > Users 클릭
  2. 신규 유저 추가 버튼 클릭
  3. 초대할 멤버의 이메일 주소 입력
  4. Send Invitation 클릭

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

IAM 권한 체계

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

다음 단계

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

보안 강화

생산성 향상

고급 기능

문제가 발생했나요?

처음 사용하시는 분들께 추천하는 튜토리얼: