--- title: "빠른 시작" description: "Alpacon을 처음 사용하는 분을 위한 빠른 시작 가이드입니다. 데모를 신청해 워크스페이스를 받거나 관리자의 초대를 수락한 뒤, 전용 URL을 확인하고 첫 서버를 등록해 브라우저 터미널에서 접속하는 과정을 차근차근 안내합니다. SSH 키나 VPN 설정은 필요 없습니다." --- > Full documentation index: https://docs.alpacax.com/llms.ko.txt # 빠른 시작 Alpacon을 처음 쓰는 분을 위한 5분 가이드입니다. 워크스페이스를 받는 방법부터 첫 서버에 접속하는 방법까지 순서대로 안내합니다. ## 시작하기 전에 Alpacon을 사용하려면 다음이 필요합니다. - Alpacon 워크스페이스: 데모를 신청해 AlpacaX 팀과 설정하거나 관리자에게 초대를 받아 팀의 워크스페이스에 참여합니다 - 관리하고자 하는 서버 (Linux, macOS 또는 Windows) - 서버의 터미널 또는 관리자 접근 권한 (설치 명령 실행용) --- ## Step 1: 워크스페이스 받기 [#step-1-get-a-workspace] 워크스페이스는 서버와 팀원을 관리하는 독립적인 작업 공간입니다. **새 워크스페이스가 필요한 경우:** 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 방식 포함)는 [서버 등록하기](/use/servers/register/)를 참고하세요. ### 2-2. Alpamon 에이전트 설치 1. 생성된 설치 명령 복사 2. 서버의 터미널에서 실행 (Linux와 macOS는 `sudo` 사용, Windows는 관리자 권한 PowerShell 사용) 3. 등록이 완료되면 창이 자동으로 닫힙니다 4. 서버 목록에서 서버 상태가 **온라인**으로 표시되는지 확인 > Windows 서버를 등록하시나요? 지원 기능, 권한 모델, 문제 해결은 [Windows 서버](/reference/platforms/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의 더 많은 기능을 살펴보세요: ### 보안 강화 - [사용자 & 그룹 관리](/use/iam/) - 세밀한 권한 제어 및 팀별 권한 일괄 설정 - [모니터링](/use/audit/) - 서버 활동 로그 및 감사 ### 생산성 향상 - [Websh](/use/work-sessions/terminal/) - 팀원과 실시간 협업을 지원하는 브라우저 기반 원격 셸 터미널 - [WebFTP](/use/work-sessions/files/) - 브라우저에서 손쉽게 파일 전송 - [다중 서버 명령](/reference/work-session-features/) - 여러 서버에서 동시에 명령 실행 ### 고급 기능 - [CLI 도구](/reference/cli/) - 터미널에서 Alpacon 관리 - [API 연동](/reference/api/) - 자동화 및 커스텀 통합 --- ## 문제가 발생했나요? - [일반적인 문제](/use/troubleshooting/) - 자주 발생하는 문제 해결 - [연결 문제](/use/work-sessions/troubleshoot-connections/) - 서버 연결 관련 문제 - [에이전트 문제](/use/servers/troubleshooting/) - Alpamon 에이전트 문제 - [Support](mailto:support@alpacax.com) - 기술 지원 문의 Source: https://docs.alpacax.com/ko/learn/quickstart/