# Alpacon 문서

> Alpacon은 통합 서버 관리 플랫폼입니다. 페이지 URL의 끝 슬래시를 .md로 바꾸거나 페이지 URL에 text/markdown을 요청하면 마크다운 문서를 받을 수 있습니다.

## 섹션별 전문

- [Learn](https://docs.alpacax.com/llms-learn.ko.txt)
- [Use](https://docs.alpacax.com/llms-use.ko.txt)
- [Integrate](https://docs.alpacax.com/llms-integrate.ko.txt)
- [Reference](https://docs.alpacax.com/llms-reference.ko.txt)

## Integrate

- [자동화 및 연동](https://docs.alpacax.com/ko/integrate.md): Alpacon을 CI, 인증, 알림, AI 도구와 연결합니다. 자동화 주체와 접근 범위를 정한 뒤 여러 서버에 배포하고, 실행 결과와 오류를 확인하는 방법을 안내합니다. GitHub Actions와 다른 CI 환경에서 쓸 자격 증명을 준비하고 명령어 기록을 확인하세요.
- [Ansible](https://docs.alpacax.com/ko/integrate/ansible.md): alpacax.alpacon 컬렉션으로 Alpacon에서 Ansible 플레이북을 실행합니다. 서비스 토큰과 애플리케이션의 서버 계정, 접근 규칙을 설정하세요. 연결 옵션과 파일 전송 조건, sudo 제한을 확인하고 승인 대기와 실행 결과에 따라 자동화 작업을 처리할 수 있습니다.
- [자동화 오류 해결](https://docs.alpacax.com/ko/integrate/automation-failure-modes.md): Alpacon 자동화 작업의 실패 원인을 HTTP 상태와 오류 코드, 명령어 결과로 확인합니다. 토큰 승인, scope, 요청 수 제한, 계정과 ACL, sudo 문제를 구분하고 CI 작업을 다시 실행하기 전에 필요한 권한과 설정을 순서대로 점검하는 방법을 안내합니다.
- [클라우드 개요](https://docs.alpacax.com/ko/integrate/cloud.md): AWS 계정을 연결하면 Alpacon에서 EC2 인스턴스를 자동으로 탐색할 수 있습니다. 에이전트를 설치해 클라우드 서버를 등록하고 기존 서버와 같은 목록에서 관리하세요. 연결 전 알아둘 개념과 계정별 인스턴스 목록, 설치 상태를 확인하는 경로도 이 섹션에서 찾을 수 있습니다.
- [클라우드 계정 관리](https://docs.alpacax.com/ko/integrate/cloud/accounts.md): 연결된 AWS 계정의 상태, 동기화 주기, 에이전트 프로비저닝과 원격 명령 권한을 확인합니다. 필요한 계정 설정을 바꾸고 연결 문제가 생기면 자격 증명을 다시 검증하거나 연결을 해제하세요. 이 계정에서 탐색된 서버와 현재 연결 상태도 계정 화면에서 함께 살펴볼 수 있습니다.
- [AWS 계정 연결하기](https://docs.alpacax.com/ko/integrate/cloud/connect-aws.md): CloudFormation을 사용해 AWS 계정을 Alpacon에 연결합니다. 시작 전에 필요한 조건과 부여할 권한을 확인하고 안내에 따라 연결을 마친 뒤 계정 상태를 검증하세요. 연결에 실패하면 오류 메시지와 점검 항목을 살펴보고 문제를 해결한 다음 다시 검증할 수 있습니다.
- [에이전트 설치하기](https://docs.alpacax.com/ko/integrate/cloud/install-agent.md): AWS SSM으로 EC2 인스턴스에 Alpamon을 설치하거나 SSH로 수동 설치를 진행합니다. 설치 화면에서 명령 전송, 에이전트 설치, 서버 매칭 상태를 확인하세요. 원클릭 설치가 막히면 표시된 사유에 맞춰 조치하고, 등록된 새 서버를 서버 목록에서 열 수 있습니다.
- [인스턴스 인벤토리](https://docs.alpacax.com/ko/integrate/cloud/instances.md): 연결된 AWS 계정에서 탐색한 EC2 인스턴스를 목록으로 확인합니다. 자동 동기화 결과와 각 인스턴스의 정보를 살펴보고 검색과 필터로 대상 인스턴스를 찾으세요. 목록의 각 컬럼과 에이전트 상태를 읽으면 이미 등록된 서버와 추가 설치가 필요한 인스턴스를 구분할 수 있습니다.
- [GitHub Actions](https://docs.alpacax.com/ko/integrate/github-actions.md): Alpacon GitHub Actions를 사용하여 CI/CD 배포를 자동화하는 통합 가이드입니다. alpacon-setup, websh, cp, common 4가지 액션 구성, 다중 서버 배포, Docker 환경별 배포 워크플로 및 서비스 토큰 보안 모범 사례를 안내합니다.
- [GitLab CI](https://docs.alpacax.com/ko/integrate/gitlab-ci.md): 공식 Docker 컨테이너를 사용하여 Alpacon을 GitLab CI/CD 파이프라인에 통합하는 가이드입니다. 서비스 토큰 발급과 ACL 규칙, entrypoint 설정, 파이프라인 구성, 다중 환경 배포, Docker Compose 기반 배포, 이미지 태그 관리를 안내합니다.
- [Jenkins](https://docs.alpacax.com/ko/integrate/jenkins.md): Docker 컨테이너를 사용하여 Alpacon을 Jenkins 파이프라인에 통합하는 가이드입니다. 서비스 토큰 발급과 ACL 규칙, Jenkins Credential 설정, Declarative Pipeline 구성, entrypoint 오버라이드, 원격 서버 관리 자동화를 안내합니다.
- [MCP로 AI 에이전트 연결하기](https://docs.alpacax.com/ko/integrate/mcp.md): 호스팅 또는 로컬 MCP 서버를 통해 AI 클라이언트를 Alpacon에 연결하세요. 인증 방식을 선택하고 클라이언트를 설정한 뒤 연결 상태를 확인합니다. 첫 작업을 실행하는 방법과 선택할 수 있는 설정의 위치, 인증 오류를 해결하는 방법까지 실제 예시와 함께 안내합니다.
- [REST API로 자동화하기](https://docs.alpacax.com/ko/integrate/rest-api.md): 권한 범위를 지정한 서비스 토큰으로 Alpacon REST API에 연결하세요. 서버 목록을 요청하고 페이지별 응답을 읽는 방법을 예제로 설명합니다. 토큰 만료나 접근 거부가 발생했을 때 확인할 필드와 재시도 방법, 필요한 scope를 찾는 위치도 구체적으로 안내합니다.
- [Slack으로 알림과 승인 연결하기](https://docs.alpacax.com/ko/integrate/slack.md): 승인 요청과 서버 알림을 Slack 채널에서 받고 Slack에서 바로 승인하거나 반려합니다. 연결할 수 있는 사람과 플랜, 알림 채널 지정, 멤버 계정 연결, 카드에 표시되는 내용, 연결 해제, 메시지가 오지 않을 때 확인할 항목과 Slack 웹훅과의 차이를 알아봅니다.
- [SSO (싱글 사인온)](https://docs.alpacax.com/ko/integrate/sso.md): SSO로 조직의 IdP와 Alpacon을 통합하세요. Okta는 OIN Express Configuration으로 연동하고, Enterprise 워크스페이스는 온보딩 과정에서 SAML IdP를 연동할 수 있습니다.
- [Okta SSO 연동](https://docs.alpacax.com/ko/integrate/sso/okta.md): Okta Integration Network(OIN) Express Configuration을 사용하여 Alpacon SSO를 설정하세요. 원클릭 OIDC 설정과 중앙 집중식 사용자 관리로 엔터프라이즈 인증을 구현합니다.
- [웹훅으로 알림 보내기](https://docs.alpacax.com/ko/integrate/webhooks.md): Alpacon 알림을 받을 Slack, Discord, Microsoft Teams, Telegram 또는 사용자 지정 웹훅을 등록하고 전달 설정과 관리 방법을 확인하세요.

## Learn

- [학습](https://docs.alpacax.com/ko/learn.md): Alpacon을 처음 사용하는 사람을 위한 학습 경로입니다. 서버 접근 모델과 주요 개념을 이해하고 빠른 시작 또는 CLI 튜토리얼로 첫 작업을 해 보세요. 워크스페이스 관리자, 승인자, AI 에이전트 담당자에게 필요한 안내와 운영 전략 문서도 바로 찾아볼 수 있습니다.
- [워크스페이스 설정 가이드](https://docs.alpacax.com/ko/learn/admin-setup.md): 워크스페이스를 처음 설정하는 관리자를 위한 안내입니다. 팀원을 초대하고 서버를 등록한 뒤 그룹과 접근 규칙을 연결하는 순서를 확인하세요. 승인 담당자, 보안 설정, 첫 작업 세션까지 점검하면 팀이 필요한 서버에서 안전하게 작업을 시작할 수 있습니다. 관련 문서도 확인하세요.
- [AI 에이전트에 통제된 접근 권한 부여](https://docs.alpacax.com/ko/learn/ai-agents-governance.md): AI 에이전트에 서버 접근을 맡기려는 관리자를 위한 가이드입니다. MCP 연결을 준비하고 필요한 서버와 작업 범위를 정한 뒤, 요청과 승인, 실행 기록을 확인하는 흐름을 살펴보세요. 에이전트가 사용할 자격 증명과 운영 중 점검할 항목도 함께 안내합니다. 설정 예시도 확인하세요.
- [승인자 가이드](https://docs.alpacax.com/ko/learn/approver-guide.md): 작업 세션과 토큰 요청을 검토하는 승인자를 위한 가이드입니다. 요청의 대상과 범위, 정책 확인 결과를 읽고 승인하거나 거절하는 방법을 알아보세요. 실행 중인 활동과 종료 후 기록을 확인해 결정의 근거와 후속 조치까지 이어갈 수 있습니다. 실제 요청 사례도 함께 살펴보세요.
- [모니터링 전략](https://docs.alpacax.com/ko/learn/best-practices/monitoring.md): Alpacon에서 서버 상태와 성능을 살펴보는 전략을 세웁니다. CPU, 메모리, 디스크, 네트워크 메트릭 가운데 팀에 필요한 항목을 고르고 추세를 비교하세요. 알림의 우선순위를 정하고 장애 조사와 용량 계획에 기록을 활용하는 방법도 살펴봅니다. 실제 운영에 적용할 수 있습니다.
- [권한 설계](https://docs.alpacax.com/ko/learn/best-practices/permission-management.md): 팀의 실제 작업에 맞춰 Alpacon 역할, 그룹, 작업 세션 접근을 설계합니다. 사용자가 요청할 수 있는 서버를 필요한 범위로 제한하고 자동화 토큰도 작업별로 나누세요. 사람과 업무가 바뀔 때 권한을 검토할 항목과 그룹 구성 예시를 함께 살펴봅니다. 적용 순서도 확인하세요.
- [접근 보안 전략](https://docs.alpacax.com/ko/learn/best-practices/security.md): 워크스페이스 보안을 계획할 때 MFA, 복구 경로, 최소 권한, 정기적인 접근 검토를 함께 고려합니다. 팀 규모에 따라 적용할 설정과 점검 주기를 정하고, 의심스러운 활동을 발견했을 때 확인할 기록과 대응 순서를 살펴보세요. 구체적인 설정 절차는 해당 안내로 이어집니다.
- [자주 묻는 질문](https://docs.alpacax.com/ko/learn/faq.md): Alpacon을 사용하면서 자주 묻는 질문과 답을 모았습니다. 서버 설치와 접속, 인증과 보안, 자동화 연동, 서비스 장애와 복구, SSH 전환에 관한 답을 찾아보세요. 각 주제에서 자세한 설정 절차와 참고 자료로 이어지므로 현재 상황에 맞는 다음 작업을 정할 수 있습니다.
- [접근 결정 방식](https://docs.alpacax.com/ko/learn/how-access-is-decided.md): Alpacon에서 같은 작업이 허용되거나 승인을 기다리거나 거부되는 이유를 알아보세요. 사람, AI 에이전트, 자동화 작업의 신원과 서버 계정, 작업 세션 범위, 접근 규칙, MFA가 각각 어떤 판단에 쓰이는지 살펴보고, 결과에 따라 확인할 기록과 문제 해결 방법을 찾을 수 있습니다.
- [Alpacon 작동 방식](https://docs.alpacax.com/ko/learn/how-it-works.md): Alpacon에서 서버가 연결되고 사람과 자동화 작업의 접근이 결정되는 흐름을 살펴봅니다. 작업 세션을 요청하고 계정을 선택한 뒤 MFA로 확인하며 활동을 기록하는 과정을 이해하세요. 처음 서버를 등록하거나 팀의 접근 방식을 설계할 때 관련 설치 및 보안 문서로 이어집니다.
- [주요 개념](https://docs.alpacax.com/ko/learn/key-concepts.md): Alpacon에서 서버 접근을 이해하는 데 필요한 개념을 설명합니다. 워크스페이스, 사용자와 그룹, 서버, 작업 세션이 어떻게 연결되는지 살펴보세요. Websh와 WebFTP로 작업을 시작하기 전에 승인, 시간 제한, 기록의 역할을 익히고 관련 가이드로 이동할 수 있습니다.
- [AI 에이전트](https://docs.alpacax.com/ko/learn/key-concepts/ai-agents.md): AI 에이전트가 Alpacon을 통해 서버에 접근할 때 적용되는 범위와 승인 절차를 설명합니다. MCP로 연결한 에이전트의 요청이 어떻게 결정되고 기록되는지 살펴보세요. 사람의 작업 세션과 비교해 자격 증명, 실행 권한, 감사 기록을 설계할 때 확인할 사항을 정리했습니다.
- [제로 트러스트](https://docs.alpacax.com/ko/learn/key-concepts/zero-trust.md): Alpacon의 상시 권한 없는 접근 방식을 설명합니다. 신원 확인, 시간 제한이 있는 작업 세션, 승인과 기록이 서버 접근에 어떻게 적용되는지 살펴보세요. 네트워크 위치만으로 권한을 주지 않는 이유와 관리자 및 작업자가 확인해야 할 설정을 함께 정리했습니다. 예시를 살펴보세요.
- [빠른 시작](https://docs.alpacax.com/ko/learn/quickstart.md): Alpacon을 처음 사용하는 분을 위한 빠른 시작 가이드입니다. 데모를 신청해 워크스페이스를 받거나 관리자의 초대를 수락한 뒤, 전용 URL을 확인하고 첫 서버를 등록해 브라우저 터미널에서 접속하는 과정을 차근차근 안내합니다. SSH 키나 VPN 설정은 필요 없습니다.
- [보안 개요](https://docs.alpacax.com/ko/learn/security.md): Alpacon의 보안 기능을 한눈에 살펴봅니다. 데이터 암호화, 인증, 접근 제어, 감사 로깅, 컴플라이언스, 보안 아키텍처를 다룹니다.
- [인증 및 접근 제어](https://docs.alpacax.com/ko/learn/security/authentication.md): Alpacon의 로그인과 접근 제어 방식을 설명합니다. MFA와 SSO를 설정할 때 확인할 사항을 살펴보고, 사용자와 그룹, 작업 세션의 범위가 서버 접근에 어떤 영향을 주는지 알아보세요. 민감한 작업에서 추가 인증이 필요한 경우와 관련 설정 가이드도 확인할 수 있습니다.
- [데이터 보안](https://docs.alpacax.com/ko/learn/security/data-security.md): Alpacon에서 연결과 기록을 보호하는 방식을 설명합니다. TLS로 전송되는 데이터, 기록에 남는 정보와 자격 증명 마스킹 범위를 확인하세요. 저장 위치를 선택할 때 고려할 사항과 관리자 및 사용자가 직접 설정할 수 있는 보호 조치도 함께 살펴봅니다. 관련 문서도 확인하세요.
- [보안 FAQ](https://docs.alpacax.com/ko/learn/security/faq.md): Alpacon 보안에 관해 자주 묻는 질문을 모았습니다. 로그인과 MFA, 서버 연결, 작업 세션 기록, 데이터 보호 범위를 확인하세요. SSH와 비교할 때 달라지는 접근 방식과 관리자가 보안 요구 사항을 검토할 때 참고할 문서도 함께 안내합니다. 관련 문서도 확인하세요.
- [네트워크 보안](https://docs.alpacax.com/ko/learn/security/network.md): Alpacon에 서버를 연결할 때 필요한 네트워크 조건을 설명합니다. 서버의 아웃바운드 HTTPS 연결, 방화벽과 프록시 설정, 브라우저에서 사용하는 경로를 확인하세요. 연결이 끊겼을 때 서버와 새 작업 요청에 어떤 영향이 있는지도 살펴봅니다. 실제 작업 예시도 확인하세요.
- [플랫폼 보안 및 가용성](https://docs.alpacax.com/ko/learn/security/platform.md): Alpacon이 플랫폼을 보호하는 방식을 설명합니다. TLS 전송 구간 암호화, 인증서 관리, 웹 애플리케이션 방화벽과 DDoS 보호, 모니터링, 가용성 태세를 다룹니다.
- [세션 보호](https://docs.alpacax.com/ko/learn/security/session-protection.md): Alpacon 작업 세션이 서버에서 사람과 AI 에이전트를 어떻게 제한하는지 설명합니다. 명령과 sudo마다 거치는 확인, 세션이 끝날 때 닫히는 항목, Alpacon AI를 쓸 수 없을 때 확인 없이 허용되는 동작, 작업 세션 밖에서 이뤄지는 접근까지 함께 정리했습니다.
- [취약점 공개 정책](https://docs.alpacax.com/ko/learn/security/vulnerability-disclosure.md): Alpacon의 책임 있는 취약점 공개 정책입니다. 보안 문제 보고 방법, 대응 절차, 안전 항구(Safe Harbor) 정책, 보안 연구원 인정 프로그램을 다룹니다.
- [Alpacon이 확인하는 것과 확인하지 않는 것](https://docs.alpacax.com/ko/learn/security/what-alpacon-checks.md): 작업 요청의 정책 확인이 승인 전에 무엇을 검사하는지 설명합니다. 요청 범위와 조건을 읽고, 검사 결과가 승인자의 판단에 어떤 도움을 주는지 알아보세요. 자동 확인의 한계와 실제 작업을 검토할 때 함께 살펴야 할 세션 기록도 안내합니다. 실제 요청 사례도 함께 살펴보세요.
- [CLI로 첫 명령 실행](https://docs.alpacax.com/ko/learn/tutorials/cli.md): Alpacon CLI를 설치하고 워크스페이스에 로그인한 뒤 시간 제한 작업 세션을 요청합니다. 등록된 서버에서 안전한 명령을 직접 실행해 보고 결과와 기록을 확인한 다음 세션을 완료하세요. 운영체제별 설치 방법과 Websh 접속, 로그아웃 절차도 함께 익힐 수 있습니다.
- [GitHub Actions로 첫 변경 배포](https://docs.alpacax.com/ko/learn/tutorials/github-actions-setup.md): GitHub Actions로 첫 배포를 실행합니다. 애플리케이션에 범위를 제한한 서비스 토큰을 만들고 GitHub 리포에 시크릿을 설정하세요. 워크플로를 실행한 뒤 Alpacon에서 명령 기록과 토큰 상태를 확인하고, 실패했을 때 점검할 항목도 살펴봅니다. 실습에 활용하세요.

## Reference

- [참조](https://docs.alpacax.com/ko/reference.md): Alpacon의 완전한 기술 레퍼런스 문서 허브입니다. CLI 명령어 가이드, REST API 엔드포인트 문서, MCP 도구 레퍼런스, 문제 해결 가이드, 자주 묻는 질문(FAQ), 용어집, 릴리즈 노트 등 Alpacon의 모든 기술 문서를 한곳에서 확인할 수 있는 종합 레퍼런스입니다.
- [접근 규칙 참조](https://docs.alpacax.com/ko/reference/access-rules.md): Alpacon의 접근 결정을 작업 주체와 작업 종류별로 확인하세요. 세션 승인, 계정 선택, sudo, 명령어 실행의 기본값과 예외를 비교하고, 규칙 조건과 결과, 위험도 신호, 플랜 및 권한 요건을 찾을 수 있습니다. 작업이 거부되면 오류 코드와 현재 승인 상태를 함께 확인하세요.
- [Actions 레퍼런스](https://docs.alpacax.com/ko/reference/actions.md): Alpacon GitHub Actions 레퍼런스 문서. CI/CD 워크플로를 위한 4가지 전용 액션: setup, websh, cp, common의 입력값, 사용법 및 예제를 안내합니다.
- [alpacon-common-action](https://docs.alpacax.com/ko/reference/actions/common.md): CI/CD 워크플로에서 모든 Alpacon CLI 명령을 실행합니다. 서버 목록 조회, 상태 확인, 그룹 관리 등 다양한 Alpacon 작업을 수행할 수 있는 유연한 액션입니다.
- [alpacon-cp-action](https://docs.alpacax.com/ko/reference/actions/cp.md): CI/CD 워크플로에서 로컬과 원격 서버 간 파일 및 디렉터리를 복사합니다. 업로드, 다운로드, 재귀 복사, 다중 소스 파일, 사용자/그룹 옵션을 지원합니다.
- [alpacon-setup-action](https://docs.alpacax.com/ko/reference/actions/setup.md): GitHub Actions 워크플로에 Alpacon CLI를 설치합니다. 다른 Alpacon 액션을 사용하기 전에 첫 번째 단계로 실행해야 합니다.
- [alpacon-websh-action](https://docs.alpacax.com/ko/reference/actions/websh.md): CI/CD 워크플로에서 원격 서버에 셸 명령을 실행합니다. 특정 사용자 및 그룹으로 실행, 환경 변수 전달, 멀티라인 스크립트를 지원합니다.
- [Alpamon 구성](https://docs.alpacax.com/ko/reference/agent-configuration.md): Alpamon의 구성 파일 경로와 등록용 환경 변수, 프록시 및 인증서 설정을 확인합니다. Linux, macOS, Windows 서버의 INI 필드를 참고해 필요한 값을 적용하세요. 일반 설치는 워크스페이스에서 생성한 명령을 사용하고, 별도 설정이 필요한 경우 이 자료를 참고합니다.
- [API reference](https://docs.alpacax.com/ko/reference/api.md): Alpacon REST API로 접근 권한을 관리하고 명령 실행을 자동화하는 방법을 안내합니다. 서비스 토큰 생성과 승인, ACL 설정, 명령 실행과 상태 조회, 결과 기록 확인까지 순서대로 따라 해보세요. 인증 방식과 페이지 나누기, 승인 대기 응답 및 오류 코드도 함께 설명합니다.
- [접근 제어 목록](https://docs.alpacax.com/ko/reference/api/acl.md): Alpacon의 명령, 서버, 파일 접근 제어 목록 API를 설명합니다. 로그인 방식별 접근 조건과 Cloud의 쓰기 제한, 일괄 요청 형식, 토큰에 적용할 수 있는 규칙을 확인하세요. 목록 조회와 페이지 이동 방법, 요청 필드와 응답 형식, 오류 코드별 처리 조건도 함께 안내합니다.
- [알림 API 개요](https://docs.alpacax.com/ko/reference/api/alerts.md): Alpacon 알림 API를 위한 REST API 레퍼런스 개요입니다. 메트릭 임계값, 서버 오프라인, 보안 이벤트를 비롯해 워크스페이스에서 발생한 모든 알림을 열려 있든 해제됐든 읽을 수 있습니다. 알림을 확인 처리하는 기능도 제공합니다.
- [알림 API](https://docs.alpacax.com/ko/reference/api/alerts/alerts.md): Alpacon 알림을 위한 REST API 레퍼런스입니다. 메트릭 임계값, 서버 오프라인, 보안 이벤트를 비롯해 워크스페이스에서 발생한 모든 알림을 조회하고 검색·필터링할 수 있습니다. 알림을 확인 처리하는 방법도 함께 안내합니다.
- [애플리케이션](https://docs.alpacax.com/ko/reference/api/applications.md): Alpacon API로 애플리케이션을 만들고 관리합니다. 생성·조회·수정·삭제 요청, 서버 계정 설정과 연결, 호출자별 권한과 조회 가능한 필드, 플랜 한도와 오류를 확인하세요. 생성할 때 지정할 수 없는 필드와 애플리케이션 삭제가 서비스 토큰에 미치는 영향도 설명합니다.
- [명령어](https://docs.alpacax.com/ko/reference/api/commands.md): Alpacon 서버에서 명령을 실행하는 API 레퍼런스입니다. 서비스 토큰이나 작업 세션으로 명령을 실행하고 목록과 상세를 조회하고 취소하는 방법, 실행 예약과 선행 명령 지정, 스크립트 실행, 명령 상태 값의 의미와 상태 코드별 오류 응답을 빠짐없이 함께 정리했습니다.
- [IAM API 개요](https://docs.alpacax.com/ko/reference/api/iam.md): Alpacon IAM(신원 및 접근 관리) REST API 레퍼런스 개요. 사용자, 그룹, 멤버십을 프로그래매틱 방식으로 관리할 수 있습니다.
- [그룹 API](https://docs.alpacax.com/ko/reference/api/iam/groups.md): Alpacon 그룹 관리를 위한 REST API 레퍼런스. 사용자 구성 및 서버 접근 제어를 위한 그룹 목록 조회, 생성, 수정, 삭제 기능을 제공합니다.
- [멤버십 API](https://docs.alpacax.com/ko/reference/api/iam/memberships.md): Alpacon 그룹 멤버십 관리를 위한 REST API 레퍼런스. 그룹 내 사용자 역할과 권한을 제어하기 위한 멤버십 목록 조회, 생성, 수정, 삭제 기능을 제공합니다.
- [사용자 API](https://docs.alpacax.com/ko/reference/api/iam/users.md): Alpacon 사용자 API의 요청과 응답을 확인합니다. 사용자 목록 조회와 계정 생성, 프로필 수정, 접근 권한 회수에 필요한 필드와 필터를 설명합니다. 개인 API 토큰의 권한, 관리자 계정 보호 규칙, 삭제 후 서버 계정 처리와 오류 코드도 함께 확인할 수 있습니다.
- [메트릭 API 개요](https://docs.alpacax.com/ko/reference/api/metrics.md): Alpacon 메트릭 API를 위한 REST API 레퍼런스 개요. 서버의 CPU, 메모리, 디스크 사용률, 디스크 I/O, 네트워크 최신 값을 읽고, 이를 감시하는 경고 규칙을 만들고, 서버별로 규칙을 따로 지정할 수 있습니다.
- [최신 지표 API](https://docs.alpacax.com/ko/reference/api/metrics/latest.md): Alpacon 최신 지표 엔드포인트를 위한 REST API 레퍼런스. 서버 여러 대의 CPU, 메모리, 디스크, 디스크 I/O, 네트워크 최신 값을 요청 한 번으로 읽고, 서버 목록과 같은 방식으로 정렬·필터링할 수 있습니다.
- [규칙 오버라이드 API](https://docs.alpacax.com/ko/reference/api/metrics/rule-overrides.md): Alpacon 서버별 경고 규칙 오버라이드를 위한 REST API 레퍼런스. 서버 하나에만 다른 임계값·복귀 임계값·지속 시간을 지정하거나, 워크스페이스 경고 규칙에서 완전히 제외합니다.
- [경고 규칙 API](https://docs.alpacax.com/ko/reference/api/metrics/rules.md): Alpacon 지표 경고 규칙을 위한 REST API 레퍼런스. CPU, 메모리, 디스크, 네트워크 지표를 감시하는 규칙을 만들고, 방향·지속 시간·복귀 임계값·데이터 없음 감지 시간·알림 수신 대상을 설정하고, 장치 하나로 좁힐 수 있습니다.
- [워크스페이스 환경설정 API](https://docs.alpacax.com/ko/reference/api/preferences.md): API로 Alpacon 워크스페이스 환경설정을 조회하고 변경하는 방법을 안내합니다. 에이전트 업그레이드 시점을 정하는 롤아웃 정책과 유지보수 시간대, 지원 중단 예정인 이전 필드를 함께 설명합니다.
- [서버 API 개요](https://docs.alpacax.com/ko/reference/api/servers.md): Alpacon 서버 관리를 위한 REST API 레퍼런스 개요. 서버를 조회, 등록, 수정, 삭제하고 서버에 첨부된 노트를 관리할 수 있습니다.
- [에이전트 업그레이드 API](https://docs.alpacax.com/ko/reference/api/servers/agent-upgrades.md): API로 Alpacon 에이전트 업그레이드 이력을 조회하는 방법을 안내합니다. 서버별 또는 워크스페이스 전체의 자동·수동 업그레이드를 결과, 버전, 시작한 주체와 함께 확인할 수 있습니다.
- [서버 노트 API](https://docs.alpacax.com/ko/reference/api/servers/notes.md): Alpacon 서버 노트 관리를 위한 REST API 레퍼런스. 서버에 첨부된 노트의 생성, 조회, 수정, 삭제와 비공개 노트, 고정 노트, 사용자 멘션 기능을 포함합니다.
- [서버 API](https://docs.alpacax.com/ko/reference/api/servers/servers.md): Alpacon 서버 관리 API 참고 문서입니다. 서버 목록 조회, 등록, 수정, 삭제와 서버 에이전트 업그레이드 및 재시작 방법을 설명합니다.
- [서비스 토큰](https://docs.alpacax.com/ko/reference/api/service-tokens.md): Alpacon API로 자동화에 쓸 서비스 토큰을 만들고 관리합니다. 생성과 변경에 필요한 승인, 키 교체 시 만료일과 기존 키의 처리, IP·시간·요청 수 제한, 즉시 비활성화, 긴급 접근, 변경 이력 조회 방법을 확인하세요. 호출에 필요한 권한과 오류 코드도 함께 설명합니다.
- [API 토큰](https://docs.alpacax.com/ko/reference/api/tokens.md): 로그인한 세션에서 개인 API 토큰을 생성하고 조회, 수정, 삭제하는 방법을 확인합니다. 키 교체와 토큰 복제, 승인에 따른 scope 확장, 최대 유효 기간과 유료 플랜 조건을 설명합니다. scope 목록과 프리셋, 토큰 이력 조회에 필요한 경로와 오류 코드도 함께 확인하세요.
- [작업 세션](https://docs.alpacax.com/ko/reference/api/work-sessions.md): Alpacon 작업 세션 API의 생성, 승인, 수정과 연장 방법을 설명합니다. 사용자와 토큰별 권한, 상태 전환 조건, 승인 대기 응답을 확인하세요. 타임라인과 녹화 기록의 커서 페이지 이동, 요금제별 감사 기록 조회 기간, 요청 필드와 오류 코드도 함께 안내합니다.
- [승인 요청 유형](https://docs.alpacax.com/ko/reference/approvals.md): Alpacon 승인 대기열에 들어오는 작업 세션, 명령, sudo, 토큰, 계정 요청을 구분합니다. 작업 세션의 생성·수정·연장과 다른 요청 유형을 비교하고, 승인 전에 검토자가 바꿀 수 있는 내용과 그대로 결정해야 하는 내용을 확인하세요. 세션 연장 요청의 처리 방식도 확인하세요.
- [CLI reference](https://docs.alpacax.com/ko/reference/cli.md): 서버 접근과 파일 전송, 자동화에 사용할 Alpacon CLI 명령을 찾아보세요. 설치와 로그인 안내에서 시작해 서버 관리, 작업 세션, 사용자와 토큰, 인증서, 패키지 등 명령 그룹별 참조 문서로 이동할 수 있습니다. 각 명령의 사용법, 플래그와 실행 예제를 확인하세요.
- [alpacon agent](https://docs.alpacax.com/ko/reference/cli/agent.md): CLI에서 원격 서버의 Alpamon 에이전트를 관리합니다. 재시작, 최신 버전 업그레이드, alpamon-pam 설치 중 필요한 명령을 찾고 대상 서버를 지정하세요. 실행 전 확인을 생략하는 방법과 사용자 작업이 진행 중일 때 적용되는 제한도 각 명령의 예제에서 확인할 수 있습니다.
- [alpacon agent install-pam](https://docs.alpacax.com/ko/reference/cli/agent/install-pam.md): CLI에서 Linux 서버에 alpamon-pam을 설치하거나 이전 버전을 업그레이드합니다. sudo with MFA 설정을 확인하고, 비대화형 실행에 필요한 확인 생략 옵션을 알아보세요. 설치 요청 후 진행 상황 조회 방법, 지원하지 않는 환경과 중복 요청의 거부 사유도 설명합니다.
- [alpacon agent restart](https://docs.alpacax.com/ko/reference/cli/agent/restart.md): CLI에서 대상 서버의 Alpamon 에이전트를 재시작합니다. 실행 전 확인을 생략하는 옵션과 사용자 작업이 진행 중일 때 재시작이 거부되는 조건을 알아보세요. Websh·WebFTP 세션이나 실행 중인 명령이 있을 때 기다리거나 강제로 재시작하는 방법, 종료 코드의 의미도 설명합니다.
- [alpacon agent upgrade](https://docs.alpacax.com/ko/reference/cli/agent/upgrade.md): CLI에서 서버의 Alpamon 에이전트를 최신 버전으로 업그레이드합니다. 확인을 생략하는 방법과 사용자 작업 중 강제 실행 옵션을 알아보세요. Linux, macOS, Windows 지원 범위와 Windows 에이전트의 최소 버전, 작업 중 거부될 때의 종료 코드도 안내합니다.
- [alpacon approval](https://docs.alpacax.com/ko/reference/cli/approval.md): alpacon approval 명령으로 승인 요청과 상태를 조회하고 대기 중인 본인 요청을 취소합니다. 명령을 실행하기 전에 사용 구문과 위치 인수, 플래그의 유형 및 기본값을 확인하세요. 예제에 나온 명령을 참고해 필요한 값을 지정하고 작업에 맞게 실행할 수 있습니다.
- [alpacon approval approve](https://docs.alpacax.com/ko/reference/cli/approval/approve.md): 승인 요청은 Alpacon 웹 콘솔 또는 Slack에서 승인합니다. alpacon approval approve 명령은 오류만 반환하며 요청을 승인하지 않습니다. 명령의 사용법과 출력 플래그를 확인하고, 승인 요청 목록에서 상태를 조회하는 예제로 처리 결과를 확인하세요.
- [alpacon approval cancel](https://docs.alpacax.com/ko/reference/cli/approval/cancel.md): Alpacon CLI의 alpacon approval cancel 명령으로 대기 중인 승인 요청을 취소합니다. 명령을 실행하기 전에 사용 구문과 위치 인수, 플래그의 유형 및 기본값을 확인하세요. 예제에 나온 명령을 참고해 필요한 값을 지정하고 작업에 맞게 실행할 수 있습니다.
- [alpacon approval describe](https://docs.alpacax.com/ko/reference/cli/approval/describe.md): alpacon approval describe 명령으로 승인 요청의 상세 정보와 판단에 필요한 내용을 확인합니다. 명령을 실행하기 전에 사용 구문과 위치 인수, 플래그의 유형 및 기본값을 확인하세요. 예제에 나온 명령을 참고해 필요한 값을 지정하고 작업에 맞게 실행할 수 있습니다.
- [alpacon approval ls](https://docs.alpacax.com/ko/reference/cli/approval/ls.md): Alpacon CLI에서 대기 요청을 조회합니다. --status와 --type으로 상태와 요청 유형을 선택하고, --my로 내가 제출한 요청만 확인하세요. --my 없이 대기 이외의 상태를 조회하려면 유료 플랜이 필요하며, Free 플랜에서는 목록 대신 업그레이드 안내가 나옵니다.
- [alpacon approval reject](https://docs.alpacax.com/ko/reference/cli/approval/reject.md): 승인 요청은 Alpacon 웹 콘솔 또는 Slack에서 거절합니다. alpacon approval reject 명령은 오류만 반환하며 요청을 거절하지 않습니다. 명령의 사용법과 출력 플래그를 확인하고, 승인 요청 목록에서 상태를 조회하는 예제로 처리 결과를 확인하세요.
- [alpacon audit](https://docs.alpacax.com/ko/reference/cli/audit.md): Alpacon CLI에서 사용자 작업과 시스템 이벤트의 감사 로그를 조회합니다. 사용자, 애플리케이션, 모델로 범위를 좁히고 tail 플래그로 조회할 항목 수를 지정하세요. audit-log 별칭과 공통 출력 형식, 각 필터의 사용법과 감사 로그 조회 예제를 안내합니다.
- [alpacon authority](https://docs.alpacax.com/ko/reference/cli/authority.md): alpacon authority의 하위 명령으로 인증 기관을 생성하고 관리합니다. 기관 목록과 상세 정보를 조회하거나 설정을 수정하고, 루트 인증서와 인증서 폐기 목록을 내려받을 수 있습니다. 기관 이름을 확인한 뒤 필요한 하위 명령을 선택하고 각 명령의 사용법과 예제를 확인하세요.
- [alpacon authority create](https://docs.alpacax.com/ko/reference/cli/authority/create.md): alpacon authority create로 인증 기관을 생성합니다. 이름, 조직, 도메인, 서버와 소유자를 입력하고 루트 인증서와 발급할 인증서의 유효 기간을 설정하세요. 생성 후 표시되는 설치 스크립트는 다시 조회할 수 없으므로 설치 안내가 나타나면 보관해야 합니다.
- [alpacon authority delete](https://docs.alpacax.com/ko/reference/cli/authority/delete.md): alpacon authority delete로 인증 기관을 이름으로 지정해 삭제하며, 인증서 요청 이력이 있는 인증 기관은 삭제할 수 없습니다. 삭제할 기관을 확인한 뒤 실행하고, 확인 메시지를 생략하려면 --yes를 사용하세요. 같은 작업에는 rm 별칭도 사용할 수 있습니다.
- [alpacon authority describe](https://docs.alpacax.com/ko/reference/cli/authority/describe.md): alpacon authority describe로 인증 기관 정보를 조회합니다. authority ls에서 확인한 인증 기관 이름을 지정하면 인증서 본문과 조직 정보를 볼 수 있습니다. describe 대신 desc 별칭을 사용해도 같은 정보를 조회하며, JSON 출력도 지원합니다.
- [alpacon authority download-crl](https://docs.alpacax.com/ko/reference/cli/authority/download-crl.md): alpacon authority download-crl로 인증 기관의 인증서 폐기 목록(CRL)을 내려받습니다. 인증 기관의 이름을 인수로 지정하고 --out 또는 -o로 저장할 파일 경로를 정하세요. 폐기된 인증서를 확인할 때 사용하는 목록이며, 예제에서 경로 지정 방법을 확인하세요.
- [alpacon authority download-crt](https://docs.alpacax.com/ko/reference/cli/authority/download-crt.md): alpacon authority download-crt로 인증 기관의 루트 인증서를 내려받습니다. 인증 기관 이름을 지정하고 --out 또는 -o로 저장할 파일 경로를 정하세요. download-cert 별칭으로도 같은 인증서를 받을 수 있으며, 예제에서 이름과 저장 경로를 확인하세요.
- [alpacon authority ls](https://docs.alpacax.com/ko/reference/cli/authority/ls.md): alpacon authority ls로 인증 기관 목록을 조회합니다. 목록에서 확인한 기관 이름은 상세 조회, 설정 수정, 루트 인증서 다운로드 명령에 사용합니다. --output json으로 결과를 JSON으로 받아 다른 도구로 처리하며, ls 대신 list 별칭을 사용해도 됩니다.
- [alpacon authority update](https://docs.alpacax.com/ko/reference/cli/authority/update.md): alpacon authority update로 인증 기관 설정을 수정하며, 인증 기관 이름을 지정해 실행하면 대화형 편집기가 열립니다. 조직 정보와 인증서 유효 기간 등 수정 가능한 항목을 확인하고 변경하세요. 계정 권한에 따라 수정 가능한 항목이 다르며, 실행 예제를 제공합니다.
- [alpacon cert](https://docs.alpacax.com/ko/reference/cli/cert.md): alpacon cert의 하위 명령으로 발급된 인증서를 조회하고 내려받습니다. ls에서 인증서 ID를 찾은 뒤 describe로 인증서와 인증 기관 정보를 확인하거나 download로 파일을 저장하세요. certificate 별칭도 지원하며, 하위 명령의 사용법과 플래그를 확인하세요.
- [alpacon cert describe](https://docs.alpacax.com/ko/reference/cli/cert/describe.md): alpacon cert describe로 발급된 인증서를 조회합니다. cert ls에서 확인한 인증서 ID를 지정하면 인증서 본문과 인증 기관 정보를 볼 수 있습니다. 인증 기관 이름이 아닌 인증서 ID를 사용하며, describe 대신 desc 별칭으로도 같은 정보를 조회합니다.
- [alpacon cert download](https://docs.alpacax.com/ko/reference/cli/cert/download.md): alpacon cert download로 발급된 인증서를 파일로 내려받습니다. 인증 기관 이름이 아닌 인증서 ID를 지정해야 하며, cert ls에서 ID를 확인하고 --out 또는 -o로 저장할 파일 경로를 정하세요. 예제에서 인증서 ID와 파일 경로 지정 방법을 확인하세요.
- [alpacon cert ls](https://docs.alpacax.com/ko/reference/cli/cert/ls.md): alpacon cert ls로 발급된 인증서 목록을 조회합니다. 목록에서 확인한 인증서 ID는 describe로 상세 정보를 보거나 download로 인증서를 내려받을 때 사용합니다. --output json으로 결과를 JSON으로 받아 처리하며, ls 대신 list 별칭도 지원합니다.
- [alpacon completion](https://docs.alpacax.com/ko/reference/cli/completion.md): Alpacon CLI 명령을 탭 키로 자동 완성할 수 있도록 셸 스크립트를 생성합니다. bash, fish, PowerShell, zsh 중 사용할 셸의 명령을 선택하세요. 각 명령 페이지에서 사용법과 플래그를 확인하고, 생성한 스크립트를 셸에 불러오는 예제로 자동 완성을 설정하세요.
- [alpacon completion bash](https://docs.alpacax.com/ko/reference/cli/completion/bash.md): bash에서 Alpacon CLI 명령을 탭 키로 자동 완성하는 스크립트를 생성합니다. 스크립트를 표준 출력으로 확인하고, 자동 완성 설명을 생략하는 플래그를 알아보세요. 현재 셸에서 생성한 스크립트를 불러오는 실행 예제와 명령 도움말을 참고해 셸에 맞게 자동 완성을 설정하세요.
- [alpacon completion fish](https://docs.alpacax.com/ko/reference/cli/completion/fish.md): fish에서 Alpacon CLI 명령을 탭 키로 자동 완성하는 스크립트를 생성합니다. 스크립트를 표준 출력으로 확인하고, 자동 완성 설명을 생략하는 플래그를 알아보세요. 현재 셸에서 생성한 스크립트를 불러오는 실행 예제와 명령 도움말을 참고해 셸에 맞게 자동 완성을 설정하세요.
- [alpacon completion powershell](https://docs.alpacax.com/ko/reference/cli/completion/powershell.md): PowerShell에서 Alpacon CLI 명령을 탭 키로 자동 완성하는 스크립트를 생성합니다. 스크립트를 표준 출력으로 확인하고, 자동 완성 설명을 생략하는 플래그를 알아보세요. 셸에서 생성한 스크립트를 불러오는 실행 예제와 명령 도움말을 참고해 셸에 맞게 자동 완성을 설정하세요.
- [alpacon completion zsh](https://docs.alpacax.com/ko/reference/cli/completion/zsh.md): zsh에서 Alpacon CLI 명령을 탭 키로 자동 완성하는 스크립트를 생성합니다. 스크립트를 표준 출력으로 확인하고, 자동 완성 설명을 생략하는 플래그를 알아보세요. 현재 셸에서 생성한 스크립트를 불러오는 실행 예제와 명령 도움말을 참고해 셸에 맞게 자동 완성을 설정하세요.
- [alpacon cp](https://docs.alpacax.com/ko/reference/cli/cp.md): Alpacon CLI로 로컬 컴퓨터와 원격 서버 사이에서 파일을 복사합니다. 원격 경로에 사용자와 서버를 지정하고 여러 원본 파일을 하나의 대상 경로로 전송하세요. 업로드와 다운로드 예제, 파일 전송 플래그, 작업 세션 선택 방법과 파일 전송에 필요한 권한을 안내합니다.
- [alpacon csr](https://docs.alpacax.com/ko/reference/cli/csr.md): alpacon csr의 하위 명령으로 인증서 서명 요청을 관리하며, create로 요청을 생성하고 ls로 진행 상태를 확인하세요. 요청을 승인하거나 거절하고, 실패한 요청을 재시도하거나 발급된 인증서를 내려받을 수 있습니다. 작업에 필요한 요청 ID와 하위 명령의 사용법을 확인합니다.
- [alpacon csr approve](https://docs.alpacax.com/ko/reference/cli/csr/approve.md): alpacon csr approve로 인증서 서명 요청을 승인하며, 승인할 요청의 CSR_ID를 지정하면 인증서 발급을 위한 서명 절차가 진행됩니다. 승인 후에는 csr ls로 요청 상태를 확인하세요. 요청 ID를 넣는 사용법과 예제를 제공하며, 공통 출력 플래그도 확인할 수 있습니다.
- [alpacon csr create](https://docs.alpacax.com/ko/reference/cli/csr/create.md): alpacon csr create로 인증서 서명 요청을 생성합니다. --domain 또는 --ip를 지정하면 비대화형으로 실행하며, --key와 --out으로 개인 키와 CSR 파일 경로를 정합니다. 유효 기간은 양의 정수로 지정하고, 생략하면 인증 기관의 기본 유효 기간을 사용합니다.
- [alpacon csr delete](https://docs.alpacax.com/ko/reference/cli/csr/delete.md): alpacon csr delete로 인증서 서명 요청을 삭제하며, 삭제할 요청의 CSR_ID를 지정하고 확인 메시지에 응답하세요. --yes 또는 -y를 사용하면 확인 메시지를 생략하며, delete 대신 rm 별칭도 지원합니다. 요청 ID 지정 예제와 확인 생략 예제를 제공합니다.
- [alpacon csr deny](https://docs.alpacax.com/ko/reference/cli/csr/deny.md): alpacon csr deny로 인증서 서명 요청을 거절하며, 거절할 요청의 CSR_ID를 지정해 실행한 뒤 csr ls에서 상태를 확인하세요. 인증서 ID가 아닌 서명 요청 ID가 필요합니다. 요청 ID를 지정하는 사용법과 예제를 제공하며, 도움말과 공통 출력 플래그를 확인하세요.
- [alpacon csr describe](https://docs.alpacax.com/ko/reference/cli/csr/describe.md): alpacon csr describe로 인증서 서명 요청의 정보를 보며, csr ls에서 확인한 요청 ID를 인수로 지정하세요. describe 대신 desc 별칭을 사용해도 같은 요청 정보를 조회합니다. 요청 ID를 지정하는 예제를 제공하며, 출력 형식을 선택하는 방법도 확인합니다.
- [alpacon csr download-crt](https://docs.alpacax.com/ko/reference/cli/csr/download-crt.md): alpacon csr download-crt로 서명 요청에 대해 발급된 인증서를 내려받습니다. 인증서 ID가 아닌 서명 요청의 CSR_ID를 지정하고, --out 또는 -o로 저장할 파일 경로를 정하세요. 요청 ID와 저장 경로를 지정하는 예제를 제공하며, 대상 요청을 먼저 확인하세요.
- [alpacon csr ls](https://docs.alpacax.com/ko/reference/cli/csr/ls.md): alpacon csr ls로 인증서 서명 요청 목록을 조회하며, --status 또는 -s로 상태를 지정하면 해당 상태의 요청을 찾습니다. 목록의 요청 ID는 describe로 상세 정보를 확인하거나 다른 요청 관리 명령에 사용하세요. ls 대신 list 별칭으로도 조회할 수 있습니다.
- [alpacon csr retry](https://docs.alpacax.com/ko/reference/cli/csr/retry.md): alpacon csr retry로 실패한 인증서 서명 요청을 다시 시도하며, 요청의 CSR_ID를 지정해 실행한 뒤 csr ls에서 진행 상태를 확인하세요. 인증서 ID가 아닌 서명 요청 ID를 사용합니다. 요청 ID를 지정하는 사용법과 예제를 제공하며, 공통 플래그도 확인하세요.
- [alpacon edit](https://docs.alpacax.com/ko/reference/cli/edit.md): Alpacon CLI로 원격 파일을 내려받아 로컬 에디터에서 편집합니다. 에디터를 닫으면 수정한 파일을 서버의 원래 경로에 업로드합니다. 사용자 이름과 서버를 포함한 원격 경로 지정법, 에디터와 작업 세션 플래그, 파일 편집에 사용할 예제 및 파일 전송 권한을 확인하세요.
- [alpacon event](https://docs.alpacax.com/ko/reference/cli/event.md): CLI에서 Alpacon 이벤트를 연속으로 확인하거나 특정 결과가 나올 때까지 기다립니다. 이벤트 타입과 대상을 선택하고 watch와 wait의 차이를 알아보세요. 구독 이후의 이벤트만 받는 동작, 연결이 끊긴 동안의 이벤트 유실, 기존 명령 실행 이력 조회 방식의 대안도 설명합니다.
- [alpacon event wait](https://docs.alpacax.com/ko/reference/cli/event/wait.md): Alpacon 이벤트의 결과가 정해질 때까지 기다린 뒤 종료 코드로 다음 작업을 결정합니다. 이벤트 타입과 대상 ID, 대기 시간을 지정하는 방법을 알아보세요. 작업 세션의 성공·실패 조건, --until로 조건을 바꾸는 방법, 재연결 후 결과 확인과 종료 코드의 의미도 설명합니다.
- [alpacon event watch](https://docs.alpacax.com/ko/reference/cli/event/watch.md): CLI에서 Alpacon 이벤트를 중단할 때까지 연속으로 확인합니다. 이벤트 타입과 대상 ID를 지정하고 한 건당 한 줄로 나오는 출력이나 스크립트용 NDJSON을 선택하세요. 표준 출력과 표준 오류의 구분, 연결이 끊겼을 때 자동 재연결과 이벤트 유실 범위도 안내합니다.
- [alpacon exec](https://docs.alpacax.com/ko/reference/cli/exec.md): 대화형 터미널 세션을 열지 않고 원격 서버에서 명령어를 실행합니다. 일회성 실행, 비동기 실행, 검증된 파일 실행을 지원하며, 스크립트를 서버에 올리거나 서버에서 읽어 한 번의 명령으로 제출하는 방법과 명령어를 실행할 시스템 사용자와 그룹을 지정하는 방법도 알아보세요.
- [alpacon group](https://docs.alpacax.com/ko/reference/cli/group.md): Alpacon CLI의 alpacon group 명령으로 그룹, 구성원, 서버 접근 권한을 관리합니다. 명령을 실행하기 전에 사용 구문과 위치 인수, 플래그의 유형 및 기본값을 확인하세요. 예제에 나온 명령을 참고해 필요한 값을 지정하고 작업에 맞게 실행할 수 있습니다.
- [alpacon group create](https://docs.alpacax.com/ko/reference/cli/group/create.md): Alpacon CLI에서 그룹을 생성합니다. alpacon group create를 실행하면 그룹 이름과 서버 할당 정보를 대화형으로 묻습니다. 그룹 정보를 입력하고 생성을 마치세요. 그룹을 만든 뒤에는 alpacon group member add로 사용자를 추가할 수 있습니다.
- [alpacon group delete](https://docs.alpacax.com/ko/reference/cli/group/delete.md): Alpacon CLI의 alpacon group delete 명령으로 그룹을 삭제합니다. 명령을 실행하기 전에 사용 구문과 위치 인수, 플래그의 유형 및 기본값을 확인하세요. 본문에 나온 구체적인 명령 예제를 참고해 필요한 값을 지정하고 작업에 맞게 실행할 수 있습니다.
- [alpacon group describe](https://docs.alpacax.com/ko/reference/cli/group/describe.md): Alpacon CLI의 alpacon group describe 명령으로 그룹의 상세 정보를 확인합니다. 명령을 실행하기 전에 사용 구문과 위치 인수, 플래그의 유형 및 기본값을 확인하세요. 예제에 나온 명령을 참고해 필요한 값을 지정하고 작업에 맞게 실행할 수 있습니다.
- [alpacon group ls](https://docs.alpacax.com/ko/reference/cli/group/ls.md): Alpacon CLI에서 그룹 목록과 그룹 이름, 구성원, 서버를 조회합니다. alpacon group ls 또는 alpacon group list를 실행하세요. 기본은 표이며, 스크립트에서 구성원과 서버 할당 정보를 읽으려면 --output json으로 JSON 출력을 선택합니다.
- [alpacon group member add](https://docs.alpacax.com/ko/reference/cli/group/member-add.md): Alpacon 그룹에 사용자를 추가하고 역할을 지정합니다. --group에는 그룹, --user에는 사용자, --role에는 owner, manager, member 중 하나를 입력하세요. 플래그 없이 대화형으로 입력할 수도 있으며, 그룹 역할은 워크스페이스 RBAC 역할과 다릅니다.
- [alpacon group member delete](https://docs.alpacax.com/ko/reference/cli/group/member-delete.md): Alpacon CLI에서 구성원을 제거합니다. --group에 그룹을, --user에 사용자를 지정하거나 대화형으로 입력하세요. 제거하기 전 확인 질문이 표시되며, 스크립트에서 --yes 또는 -y로 확인을 생략할 수 있습니다. delete 대신 rm 별칭으로도 제거할 수 있습니다.
- [alpacon group member](https://docs.alpacax.com/ko/reference/cli/group/member.md): Alpacon CLI의 alpacon group member 명령으로 그룹 구성원을 추가하거나 삭제합니다. 명령을 실행하기 전에 사용 구문과 위치 인수, 플래그의 유형 및 기본값을 확인하세요. 예제에 나온 명령을 참고해 필요한 값을 지정하고 작업에 맞게 실행할 수 있습니다.
- [alpacon group update](https://docs.alpacax.com/ko/reference/cli/group/update.md): Alpacon CLI의 alpacon group update 명령으로 그룹 설정을 편집하고 저장된 결과를 확인합니다. 명령을 실행하기 전에 사용 구문과 위치 인수, 플래그의 유형 및 기본값을 확인하세요. 예제에 나온 명령을 참고해 필요한 값을 지정하고 작업에 맞게 실행할 수 있습니다.
- [alpacon log](https://docs.alpacax.com/ko/reference/cli/log.md): Alpacon CLI에서 지정한 서버의 최근 로그를 조회합니다. tail 플래그로 표시할 항목 수를 제한해 서버 활동이나 문제 원인을 확인하세요. 서버 이름을 지정하는 사용법과 logs 별칭, 표 또는 JSON 출력 형식, 각 플래그의 기본값과 서버 로그 조회 예제를 안내합니다.
- [alpacon login](https://docs.alpacax.com/ko/reference/cli/login.md): Alpacon Cloud는 워크스페이스와 리전으로, 자체 호스팅은 호스트로 CLI에 로그인합니다. 기본 브라우저 인증과 브라우저가 없는 환경의 인증 방법, 토큰 로그인을 안내합니다. 각 플래그와 예제를 확인하고 대화형 Websh 또는 터널에 필요한 로그인 방식을 선택하세요.
- [alpacon logout](https://docs.alpacax.com/ko/reference/cli/logout.md): Alpacon CLI에서 로그아웃해 로컬에 저장된 로그인 자격 증명을 삭제합니다. 별도의 위치 인수 없이 실행할 수 있으며, 이후 인증이 필요한 작업을 하려면 login 명령으로 다시 로그인해야 합니다. 명령 사용법과 공통 출력 플래그, CLI 로그아웃 예제를 확인하세요.
- [alpacon note](https://docs.alpacax.com/ko/reference/cli/note.md): Alpacon CLI의 alpacon note 명령으로 서버에 첨부된 노트를 생성하고 조회하며 관리합니다. 명령을 실행하기 전에 사용 구문과 위치 인수, 플래그의 유형 및 기본값을 확인하세요. 예제에 나온 명령을 참고해 필요한 값을 지정하고 작업에 맞게 실행할 수 있습니다.
- [alpacon note create](https://docs.alpacax.com/ko/reference/cli/note/create.md): Alpacon CLI에서 서버에 메모를 추가합니다. --server로 서버를 선택하고 --content에 최대 512자의 내용을 입력하세요. --private를 지정하면 비공개 메모로 생성됩니다. 대화형으로 작성하거나 서버와 내용을 지정할 수 있으며, 기본값은 비공개가 아닌 메모입니다.
- [alpacon note delete](https://docs.alpacax.com/ko/reference/cli/note/delete.md): Alpacon CLI의 alpacon note delete 명령으로 노트를 삭제합니다. 명령을 실행하기 전에 사용 구문과 위치 인수, 플래그의 유형 및 기본값을 확인하세요. 본문에 나온 구체적인 명령 예제를 참고해 필요한 값을 지정하고 작업에 맞게 실행할 수 있습니다.
- [alpacon note describe](https://docs.alpacax.com/ko/reference/cli/note/describe.md): Alpacon CLI의 alpacon note describe 명령으로 노트의 상세 정보를 확인합니다. 명령을 실행하기 전에 사용 구문과 위치 인수, 플래그의 유형 및 기본값을 확인하세요. 예제에 나온 명령을 참고해 필요한 값을 지정하고 작업에 맞게 실행할 수 있습니다.
- [alpacon note ls](https://docs.alpacax.com/ko/reference/cli/note/ls.md): Alpacon 서버 메모를 최신순으로 조회합니다. 기본값은 최근 25개이며, --tail로 개수를 바꾸고 --server로 서버를 고르세요. 고정 메모만 보려면 --pinned를 사용합니다. ls 대신 list 별칭을 지원하며, 스크립트에서 --output json으로 목록을 읽습니다.
- [alpacon note update](https://docs.alpacax.com/ko/reference/cli/note/update.md): Alpacon CLI의 alpacon note update 명령으로 노트 내용과 공개 여부를 편집합니다. 명령을 실행하기 전에 사용 구문과 위치 인수, 플래그의 유형 및 기본값을 확인하세요. 예제에 나온 명령을 참고해 필요한 값을 지정하고 작업에 맞게 실행할 수 있습니다.
- [alpacon package](https://docs.alpacax.com/ko/reference/cli/package.md): Alpacon 워크스페이스에서 Python 패키지와 시스템 패키지를 관리합니다. 패키지 종류에 맞는 하위 명령을 선택해 파일을 업로드하고, 등록된 패키지 목록을 조회하거나 로컬 디렉터리로 내려받는 방법을 확인하세요. 각 패키지 하위 명령의 사용법과 예제를 함께 안내합니다.
- [alpacon package python download](https://docs.alpacax.com/ko/reference/cli/package/python-download.md): Alpacon 워크스페이스에 등록된 Python wheel 패키지를 로컬로 내려받습니다. 패키지 목록에 표시된 이름과 저장할 디렉터리를 인수로 지정하는 방법을 확인하세요. 현재 디렉터리에 저장할 때는 점을 사용하며, 예제에서 파일 이름과 저장 경로를 필요한 값으로 바꿔 실행하세요.
- [alpacon package python ls](https://docs.alpacax.com/ko/reference/cli/package/python-ls.md): Alpacon 워크스페이스에 등록된 Python wheel 패키지 목록을 조회합니다. 대상 이름이나 ID 없이 명령을 실행하고, 목록에 표시된 패키지 이름을 다운로드할 때 사용하는 방법을 확인하세요. 표 형식으로 결과를 읽거나 JSON 형식을 선택해 스크립트에서 처리할 수 있습니다.
- [alpacon package python upload](https://docs.alpacax.com/ko/reference/cli/package/python-upload.md): 로컬 Python wheel 파일을 Alpacon 워크스페이스에 업로드합니다. 파일의 상대 경로나 절대 경로를 인수로 지정하는 방법과 실행 예제를 확인하세요. 업로드한 패키지는 같은 워크스페이스의 서버에서 사용할 수 있으며, 패키지 목록에서 찾아 필요한 곳에 배포할 수 있습니다.
- [alpacon package python](https://docs.alpacax.com/ko/reference/cli/package/python.md): Alpacon 워크스페이스에 Python wheel 파일을 등록하고 조회하거나 내려받습니다. 업로드할 로컬 wheel 파일 경로와 다운로드할 패키지 이름, 저장할 디렉터리를 지정하는 방법을 확인하세요. 목록에서 패키지를 찾은 뒤 필요한 작업의 하위 명령으로 이어갈 수 있습니다.
- [alpacon package system download](https://docs.alpacax.com/ko/reference/cli/package/system-download.md): Alpacon 워크스페이스에 등록된 시스템 패키지를 로컬 디렉터리로 내려받습니다. 목록에서 확인한 패키지 이름과 파일을 저장할 디렉터리를 차례로 지정하세요. 현재 디렉터리에 저장하는 예제와 다른 경로에 저장하는 예제를 확인하고, 필요한 파일 이름과 저장 경로로 바꿔 실행할 수 있습니다.
- [alpacon package system ls](https://docs.alpacax.com/ko/reference/cli/package/system-ls.md): Alpacon 워크스페이스에 등록된 시스템 패키지 목록을 조회합니다. 별도의 대상 인수 없이 목록을 확인하고, 내려받을 패키지의 이름을 찾아 다운로드 명령에 지정하세요. 기본 표 형식과 JSON 출력 형식의 사용법을 안내하므로 직접 확인하거나 스크립트에서 결과를 처리할 수 있습니다.
- [alpacon package system upload](https://docs.alpacax.com/ko/reference/cli/package/system-upload.md): 로컬 시스템 패키지 파일을 Alpacon 워크스페이스에 업로드합니다. 파일을 가리키는 상대 경로나 절대 경로를 인수로 지정하고 명령을 실행하는 방법을 확인하세요. 등록한 패키지를 같은 워크스페이스의 서버에서 사용할 수 있도록 준비하며, 목록에서 업로드한 파일을 찾을 수 있습니다.
- [alpacon package system](https://docs.alpacax.com/ko/reference/cli/package/system.md): Alpacon 워크스페이스에 등록된 시스템 패키지를 관리합니다. 로컬에 있는 패키지 파일을 업로드하고, 목록에서 필요한 패키지를 찾아 원하는 디렉터리로 내려받는 방법을 안내합니다. 업로드와 다운로드에 필요한 인수를 확인한 뒤 패키지 종류에 맞는 하위 명령을 실행하세요.
- [alpacon revoke](https://docs.alpacax.com/ko/reference/cli/revoke.md): alpacon revoke의 하위 명령으로 인증서 폐기 요청을 관리하며, create로 요청을 만들고 ls로 상태를 확인하세요. 요청 ID를 지정해 승인, 거절, 취소하거나 실패한 요청을 다시 시도합니다. revoke-request 별칭도 지원하며, 하위 명령의 사용법을 확인하세요.
- [alpacon revoke approve](https://docs.alpacax.com/ko/reference/cli/revoke/approve.md): alpacon revoke approve로 인증서 폐기 요청을 승인하며, 인증서 ID가 아닌 폐기 요청의 REQUEST_ID를 지정합니다. 승인 후에는 revoke ls에서 요청 상태를 확인하세요. 요청 ID를 지정하는 사용법과 예제를 제공하며, 도움말과 공통 출력 플래그를 확인합니다.
- [alpacon revoke cancel](https://docs.alpacax.com/ko/reference/cli/revoke/cancel.md): alpacon revoke cancel로 대기 중인 폐기 요청을 취소하며, 취소할 요청의 REQUEST_ID를 지정하고 확인 메시지에 응답하세요. --yes 또는 -y를 사용하면 확인 메시지를 생략합니다. 취소와 확인 생략 예제를 제공하며, 인증서 ID 대신 요청 ID를 사용합니다.
- [alpacon revoke create](https://docs.alpacax.com/ko/reference/cli/revoke/create.md): alpacon revoke create로 인증서 폐기를 요청하며, --certificate로 인증서 ID를 지정하고 --reason으로 사유 코드를 입력하세요. --requested-reason으로 설명을 덧붙이며, 생략한 값은 대화형으로 입력합니다. 사유 코드와 예제를 확인하세요.
- [alpacon revoke deny](https://docs.alpacax.com/ko/reference/cli/revoke/deny.md): alpacon revoke deny로 인증서 폐기 요청을 거절하며, 인증서 ID가 아닌 폐기 요청의 REQUEST_ID를 지정해 실행하세요. 실행 후 revoke ls에서 요청 상태를 확인합니다. 요청 ID를 지정하는 사용법과 예제를 제공하며, 도움말과 공통 출력 플래그를 확인합니다.
- [alpacon revoke describe](https://docs.alpacax.com/ko/reference/cli/revoke/describe.md): alpacon revoke describe로 인증서 폐기 요청의 상세 정보를 조회하며, revoke ls에서 확인한 요청 ID를 인수로 지정하고, 인증서 ID와 구분하세요. describe 대신 desc 별칭도 사용할 수 있습니다. 요청 ID를 지정하는 사용법과 실행 예제를 확인합니다.
- [alpacon revoke ls](https://docs.alpacax.com/ko/reference/cli/revoke/ls.md): alpacon revoke ls로 인증서 폐기 요청 목록을 조회하며, --status로 요청 상태를 지정하거나 --certificate로 인증서 ID를 지정해 목록을 좁힙니다. 결과의 요청 ID는 describe로 조회할 때 사용하세요. ls 대신 list 별칭으로도 조회합니다.
- [alpacon revoke retry](https://docs.alpacax.com/ko/reference/cli/revoke/retry.md): alpacon revoke retry로 실패한 인증서 폐기 요청을 다시 시도하며, 요청의 REQUEST_ID를 지정해 실행하고 revoke ls에서 진행 상태를 확인하세요. 인증서 ID가 아닌 폐기 요청 ID가 필요합니다. 요청 ID 지정 방법과 실행 예제, 공통 플래그를 확인하세요.
- [alpacon server](https://docs.alpacax.com/ko/reference/cli/server.md): Alpacon에 등록된 서버와 서버 등록 토큰을 CLI에서 관리합니다. 서버를 등록하거나 목록과 상세 정보를 조회하고, 설정을 수정하거나 시스템 정보를 갱신하는 명령을 찾아보세요. 서버 삭제와 등록 토큰 생성, 조회, 삭제 명령의 사용법도 각 하위 명령 페이지에서 확인할 수 있습니다.
- [alpacon server create](https://docs.alpacax.com/ko/reference/cli/server/create.md): Alpamon을 설치해 서버를 등록하는 안내를 생성합니다. 운영체제와 등록 토큰을 선택하고, 토큰 설치 방식과 Ansible 방식에 맞는 명령을 확인하세요. 기존 토큰을 쓰거나 새 토큰을 만들 수 있으며, 서버 이름 지정과 대화형 입력 없이 실행하기, JSON 출력 방법도 안내합니다.
- [alpacon server delete](https://docs.alpacax.com/ko/reference/cli/server/delete.md): Alpacon 워크스페이스에 등록된 서버를 이름으로 지정해 삭제합니다. 삭제할 서버 이름을 확인하고 확인 질문에 응답하는 방법과, 스크립트에서 확인 질문을 생략하는 플래그를 안내합니다. 명령 사용법과 예제를 참고해 대상을 지정하고, 실행 전에 삭제할 서버가 맞는지 확인하세요.
- [alpacon server describe](https://docs.alpacax.com/ko/reference/cli/server/describe.md): Alpacon에 등록된 서버의 상태와 설정을 이름으로 조회합니다. 서버 목록에서 대상 이름을 확인해 인수로 지정하고, describe 대신 별칭 desc로 실행하는 방법을 알아보세요. 명령 사용법과 예제를 확인하고 기본 표 형식이나 JSON 형식으로 조회 결과를 읽을 수 있습니다.
- [alpacon server ls](https://docs.alpacax.com/ko/reference/cli/server/ls.md): Alpacon 워크스페이스에 등록된 서버 목록을 조회합니다. 대상 이름 없이 명령을 실행하고, 목록에 표시된 서버 이름을 상세 조회나 관리 명령에 사용하는 방법을 확인하세요. 표 형식으로 결과를 읽거나 JSON 출력을 선택해 스크립트에서 처리할 수 있으며 list 별칭도 지원합니다.
- [alpacon server refresh](https://docs.alpacax.com/ko/reference/cli/server/refresh.md): Alpacon에 등록된 서버의 시스템 정보를 갱신하도록 요청합니다. 서버 이름을 인수로 지정하면 별도의 확인 질문 없이 요청이 실행됩니다. 목록에서 대상 서버를 찾은 뒤 갱신하는 명령 사용법과 예제를 확인하고, 상세 조회 명령으로 이어가 서버의 현재 상태와 설정을 살펴볼 수 있습니다.
- [alpacon server token create](https://docs.alpacax.com/ko/reference/cli/server/token-create.md): Alpamon으로 서버를 등록할 때 사용할 토큰을 생성합니다. 이번 설치에 필요한 최소한의 그룹과 유효 기간을 지정하고, 한 번만 표시되는 토큰 키를 안전하게 보관하세요. 대화형 입력으로 생성하는 방법과 이름, 그룹, 만료일을 플래그로 지정해 생성하는 예제를 함께 확인할 수 있습니다.
- [alpacon server token delete](https://docs.alpacax.com/ko/reference/cli/server/token-delete.md): 서버 등록 토큰을 이름으로 지정해 삭제합니다. 삭제한 토큰으로는 Alpamon 서버를 새로 등록할 수 없으므로, 목록에서 토큰 이름을 확인한 뒤 실행하세요. 삭제 확인 질문에 응답하는 방법과 확인을 생략하는 플래그를 안내하며, 예제의 이름을 실제 삭제할 토큰 이름으로 바꿔 사용합니다.
- [alpacon server token ls](https://docs.alpacax.com/ko/reference/cli/server/token-ls.md): Alpamon 서버 등록 토큰 목록을 조회합니다. 대상 인수 없이 토큰을 확인하고, 목록에 표시된 이름을 서버 설치 안내 생성 명령에 사용하는 방법을 안내합니다. 기본 표 형식으로 결과를 확인하거나 JSON 출력 형식을 선택해 스크립트에서 처리할 수 있으며 list 별칭도 지원합니다.
- [alpacon server token](https://docs.alpacax.com/ko/reference/cli/server/token.md): Alpamon 서버 등록에 사용하는 토큰을 생성하고 조회하거나 삭제합니다. 설치할 서버에 맞는 그룹과 유효 기간을 지정하는 방법을 확인하고, 목록에서 토큰 이름을 찾아 서버 설치 안내를 생성할 때 사용하세요. 더 이상 필요하지 않은 토큰을 삭제하는 명령도 함께 안내합니다.
- [alpacon server update](https://docs.alpacax.com/ko/reference/cli/server/update.md): Alpacon에 등록된 서버의 설정을 대화형 편집기에서 수정합니다. 서버 목록에서 대상 이름을 확인하고 update 명령의 인수로 지정해 편집기를 여는 방법을 안내합니다. 명령 사용법과 예제를 참고해 필요한 설정을 변경한 뒤 저장하고, 서버 상세 조회 명령으로 현재 설정을 확인하세요.
- [alpacon token](https://docs.alpacax.com/ko/reference/cli/token.md): Alpacon CLI의 alpacon token 명령으로 API 토큰, 권한 범위, 접근 규칙을 관리합니다. 명령을 실행하기 전에 사용 구문과 위치 인수, 플래그의 유형 및 기본값을 확인하세요. 예제에 나온 명령을 참고해 필요한 값을 지정하고 작업에 맞게 실행할 수 있습니다.
- [alpacon token acl command add](https://docs.alpacax.com/ko/reference/cli/token/acl-command-add.md): alpacon token acl command add 명령으로 토큰의 셸 명령 ACL을 관리합니다. 명령 패턴 지정법과 플래그를 확인하세요. 새 개인 API 토큰에는 명령 실행 권한을 부여할 수 없으며, command_acl_moved 오류가 나면 웹 콘솔에서 서비스 토큰을 관리하세요.
- [alpacon token acl command delete](https://docs.alpacax.com/ko/reference/cli/token/acl-command-delete.md): alpacon token acl command delete 명령에 규칙 ID를 지정해 명령 ACL을 삭제합니다. 규칙을 삭제하는 구문과 출력 플래그를 확인하세요. command_acl_moved 오류가 나오면 개인 토큰 명령 대신 웹 콘솔에서 서비스 토큰의 명령 접근 규칙을 관리하세요.
- [alpacon token acl command ls](https://docs.alpacax.com/ko/reference/cli/token/acl-command-ls.md): alpacon token acl command ls 명령으로 토큰의 명령 ACL 규칙을 조회합니다. 명령을 실행하기 전에 사용 구문과 위치 인수, 플래그의 유형 및 기본값을 확인하세요. 예제에 나온 명령을 참고해 필요한 인수와 값을 지정해 실행 방법을 익힐 수 있습니다.
- [alpacon token acl command](https://docs.alpacax.com/ko/reference/cli/token/acl-command.md): Alpacon CLI의 alpacon token acl command 명령으로 토큰의 명령 ACL 규칙을 관리합니다. 명령을 실행하기 전에 사용 구문과 위치 인수, 플래그의 유형 및 기본값을 확인하세요. 예제에 나온 명령을 참고해 필요한 값을 지정하고 작업에 맞게 실행할 수 있습니다.
- [alpacon token acl file add](https://docs.alpacax.com/ko/reference/cli/token/acl-file-add.md): alpacon token acl file add 명령으로 경로 패턴에 해당하는 파일을 토큰으로 전송하도록 허용합니다. 명령을 실행하기 전에 사용 구문과 위치 인수, 플래그의 유형 및 기본값을 확인하세요. 예제에 나온 명령을 참고해 필요한 값을 지정하고 작업에 맞게 실행할 수 있습니다.
- [alpacon token acl file delete](https://docs.alpacax.com/ko/reference/cli/token/acl-file-delete.md): alpacon token acl file delete 명령에 규칙 ID를 지정해 파일 ACL을 삭제합니다. 삭제 전 파일 ACL 목록에서 대상 ID를 확인하고, 예제의 ID를 삭제할 규칙의 값으로 바꾸어 실행하세요. 명령 사용법과 공통 출력 플래그의 허용 값 및 기본값도 안내합니다.
- [alpacon token acl file ls](https://docs.alpacax.com/ko/reference/cli/token/acl-file-ls.md): Alpacon CLI의 alpacon token acl file ls 명령으로 토큰의 파일 ACL 규칙을 조회합니다. 명령을 실행하기 전에 사용 구문과 위치 인수, 플래그의 유형 및 기본값을 확인하세요. 예제에 나온 명령을 참고해 필요한 값을 지정하고 작업에 맞게 실행할 수 있습니다.
- [alpacon token acl file](https://docs.alpacax.com/ko/reference/cli/token/acl-file.md): Alpacon CLI의 alpacon token acl file 명령으로 토큰의 파일 ACL 규칙을 관리합니다. 명령을 실행하기 전에 사용 구문과 위치 인수, 플래그의 유형 및 기본값을 확인하세요. 예제에 나온 명령을 참고해 필요한 값을 지정하고 작업에 맞게 실행할 수 있습니다.
- [alpacon token acl server add](https://docs.alpacax.com/ko/reference/cli/token/acl-server-add.md): alpacon token acl server add 명령으로 토큰에 하나 이상의 서버 접근 권한을 부여합니다. 명령을 실행하기 전에 사용 구문과 위치 인수, 플래그의 유형 및 기본값을 확인하세요. 예제에 나온 명령을 참고해 필요한 값을 지정하고 작업에 맞게 실행할 수 있습니다.
- [alpacon token acl server delete](https://docs.alpacax.com/ko/reference/cli/token/acl-server-delete.md): alpacon token acl server delete 명령으로 서버 ACL 규칙 하나를 삭제하거나 여러 서버의 접근 권한을 회수합니다. 명령을 실행하기 전에 명령 구문과 플래그의 유형, 기본값을 확인하세요. 사용 예제를 참고해 필요한 값을 지정하고 작업에 맞게 실행할 수 있습니다.
- [alpacon token acl server ls](https://docs.alpacax.com/ko/reference/cli/token/acl-server-ls.md): alpacon token acl server ls 명령으로 토큰의 서버 ACL 규칙을 조회합니다. 명령을 실행하기 전에 사용 구문과 위치 인수, 플래그의 유형 및 기본값을 확인하세요. 예제에 나온 명령을 참고해 필요한 인수와 값을 지정해 실행 방법을 익힐 수 있습니다.
- [alpacon token acl server](https://docs.alpacax.com/ko/reference/cli/token/acl-server.md): Alpacon CLI의 alpacon token acl server 명령으로 토큰의 서버 ACL 규칙을 관리합니다. 명령을 실행하기 전에 사용 구문과 위치 인수, 플래그의 유형 및 기본값을 확인하세요. 예제에 나온 명령을 참고해 필요한 값을 지정하고 작업에 맞게 실행할 수 있습니다.
- [alpacon token acl](https://docs.alpacax.com/ko/reference/cli/token/acl.md): Alpacon CLI의 alpacon token acl 명령으로 토큰의 서버, 명령, 파일 접근 규칙을 관리합니다. 명령을 실행하기 전에 사용 구문과 위치 인수, 플래그의 유형 및 기본값을 확인하세요. 예제에 나온 명령을 참고해 필요한 값을 지정하고 작업에 맞게 실행할 수 있습니다.
- [alpacon token create](https://docs.alpacax.com/ko/reference/cli/token/create.md): alpacon token create로 개인 API 토큰을 생성합니다. 대화형 질문에 답하거나 플래그로 이름, 만료 기간, 권한 범위를 지정하세요. 만료 기간에 0을 지정하면 워크스페이스의 최대 토큰 수명을 적용하며, 명령 실행이나 파일 전송을 자동화할 때는 서비스 토큰을 사용합니다.
- [alpacon token delete](https://docs.alpacax.com/ko/reference/cli/token/delete.md): Alpacon CLI의 alpacon token delete 명령으로 API 토큰을 삭제합니다. 명령을 실행하기 전에 사용 구문과 위치 인수, 플래그의 유형 및 기본값을 확인하세요. 본문에 나온 구체적인 명령 예제를 참고해 필요한 값을 지정하고 작업에 맞게 실행할 수 있습니다.
- [alpacon token duplicate](https://docs.alpacax.com/ko/reference/cli/token/duplicate.md): alpacon token duplicate 명령으로 토큰의 권한 범위와 ACL 규칙을 함께 복제합니다. 명령을 실행하기 전에 사용 구문과 위치 인수, 플래그의 유형 및 기본값을 확인하세요. 예제에 나온 명령을 참고해 필요한 값을 지정하고 작업에 맞게 실행할 수 있습니다.
- [alpacon token ls](https://docs.alpacax.com/ko/reference/cli/token/ls.md): alpacon token ls로 발급된 API 토큰의 이름과 생성일, 만료일을 조회합니다. 토큰 이름이나 ID를 입력할 필요가 없으며, list 별칭도 사용할 수 있습니다. 기본 출력은 표이며, 스크립트에서 목록을 처리하려면 --output json으로 JSON 형식을 선택하세요.
- [alpacon token scopes](https://docs.alpacax.com/ko/reference/cli/token/scopes.md): alpacon token scopes로 사용자가 API 토큰에 부여할 수 있는 리소스와 작업을 조회합니다. 토큰 이름이나 ID는 필요하지 않습니다. 목록의 권한 범위를 token create --scopes에 지정하고, 각 권한으로 할 수 있는 작업은 접근 범위 문서에서 확인하세요.
- [alpacon tunnel](https://docs.alpacax.com/ko/reference/cli/tunnel.md): Alpacon CLI로 로컬 TCP 포트를 원격 서버의 서비스에 연결합니다. 서버의 IPv4 루프백에서 수신하는 포트로 연결하며 브라우저 로그인이 필요합니다. 포트와 작업 세션을 지정하는 플래그, 터널이 열린 동안 로컬 명령을 실행하는 방법 및 사용 예제를 확인하세요.
- [alpacon user](https://docs.alpacax.com/ko/reference/cli/user.md): Alpacon CLI의 alpacon user 명령으로 워크스페이스 사용자와 권한을 관리합니다. 명령을 실행하기 전에 사용 구문과 위치 인수, 플래그의 유형 및 기본값을 확인하세요. 본문에 나온 구체적인 명령 예제를 참고해 필요한 값을 지정하고 작업에 맞게 실행할 수 있습니다.
- [alpacon user create](https://docs.alpacax.com/ko/reference/cli/user/create.md): Alpacon CLI에서 사용자를 생성합니다. alpacon user create를 실행하면 사용자 이름과 계정 정보를 대화형으로 묻습니다. 계정 정보를 입력해 생성을 마치세요. 비밀번호는 Alpacon이 생성하며 stdout에 한 번만 출력되므로 명령을 실행한 뒤 바로 저장하세요.
- [alpacon user delete](https://docs.alpacax.com/ko/reference/cli/user/delete.md): Alpacon CLI의 alpacon user delete 명령으로 사용자를 삭제합니다. 명령을 실행하기 전에 사용 구문과 위치 인수, 플래그의 유형 및 기본값을 확인하세요. 본문에 나온 구체적인 명령 예제를 참고해 필요한 값을 지정하고 작업에 맞게 실행할 수 있습니다.
- [alpacon user describe](https://docs.alpacax.com/ko/reference/cli/user/describe.md): Alpacon CLI의 alpacon user describe 명령으로 사용자의 상세 정보를 확인합니다. 명령을 실행하기 전에 사용 구문과 위치 인수, 플래그의 유형 및 기본값을 확인하세요. 예제에 나온 명령을 참고해 필요한 값을 지정하고 작업에 맞게 실행할 수 있습니다.
- [alpacon user invite](https://docs.alpacax.com/ko/reference/cli/user/invite.md): Alpacon CLI에서 이메일로 사용자를 워크스페이스에 초대합니다. 이메일을 인수로 지정하거나 대화형으로 입력하는 방법과 초대 메일의 참여 링크를 알아보세요. 필요한 Staff 또는 Superuser 권한, Alpacon Cloud에서만 제공되는 초대 기능과 출력 플래그도 확인합니다.
- [alpacon user ls](https://docs.alpacax.com/ko/reference/cli/user/ls.md): Alpacon CLI에서 등록된 사용자 목록을 조회합니다. 사용자 이름과 이메일, 상태를 확인하려면 alpacon user ls 또는 alpacon user list를 실행하세요. 기본은 표이며, 스크립트에서 사용자 정보를 읽으려면 --output json으로 출력 형식을 바꾸세요.
- [alpacon user update](https://docs.alpacax.com/ko/reference/cli/user/update.md): Alpacon CLI의 alpacon user update 명령으로 사용자 정보를 편집하고 저장된 결과를 확인합니다. 명령을 실행하기 전에 사용 구문과 위치 인수, 플래그의 유형 및 기본값을 확인하세요. 예제에 나온 명령을 참고해 필요한 값을 지정하고 작업에 맞게 실행할 수 있습니다.
- [alpacon username](https://docs.alpacax.com/ko/reference/cli/username.md): Alpacon CLI의 alpacon username 명령으로 서버 접근에 사용할 사용자 이름을 관리합니다. 명령을 실행하기 전에 사용 구문과 위치 인수, 플래그의 유형 및 기본값을 확인하세요. 예제에 나온 명령을 참고해 필요한 값을 지정하고 작업에 맞게 실행할 수 있습니다.
- [alpacon username get](https://docs.alpacax.com/ko/reference/cli/username/get.md): 서버 접근에 사용하는 Alpacon 계정의 사용자 이름을 조회합니다. alpacon username get으로 이름을 확인하고, 스크립트에서는 --output json으로 결과를 읽으세요. 이름이 없으면 오류 안내에 따라 alpacon username set NAME으로 설정합니다.
- [alpacon username set](https://docs.alpacax.com/ko/reference/cli/username/set.md): Alpacon CLI의 alpacon username set 명령으로 서버 접근에 사용할 사용자 이름을 설정합니다. 명령을 실행하기 전에 사용 구문과 위치 인수, 플래그의 유형 및 기본값을 확인하세요. 예제에 나온 명령을 참고해 필요한 값을 지정하고 작업에 맞게 실행할 수 있습니다.
- [alpacon version](https://docs.alpacax.com/ko/reference/cli/version.md): 설치된 Alpacon CLI 버전과 업데이트 여부를 확인합니다. 스크립트에서 읽을 JSON 출력 필드와 사용 예제, 업데이트 조회에 실패했을 때의 동작을 안내합니다. 업데이트 여부를 종료 코드로 판단해야 하는 경우 update --check 명령과의 차이도 확인하세요.
- [alpacon webftp-log](https://docs.alpacax.com/ko/reference/cli/webftp-log.md): Alpacon CLI에서 WebFTP 파일 전송 로그를 조회합니다. 서버와 사용자, 전송 작업별로 내역을 좁히고 tail 플래그로 조회할 항목 수를 지정하세요. webftp-logs 별칭과 출력 형식, 각 필터의 기본값 및 파일 전송 내역을 확인하는 예제를 안내합니다.
- [alpacon webhook](https://docs.alpacax.com/ko/reference/cli/webhook.md): Alpacon CLI의 alpacon webhook 명령으로 이벤트 알림을 받을 웹훅을 설정합니다. 명령을 실행하기 전에 사용 구문과 위치 인수, 플래그의 유형 및 기본값을 확인하세요. 예제에 나온 명령을 참고해 필요한 인수와 값을 지정해 실행 방법을 익힐 수 있습니다.
- [alpacon webhook create](https://docs.alpacax.com/ko/reference/cli/webhook/create.md): Alpacon CLI에서 알림용 웹훅을 생성합니다. 이름과 URL, 제공자를 지정하거나 대화형으로 입력하세요. 제공자는 URL에서 자동 감지되며, 웹훅과 TLS 인증서 검증은 기본으로 켜집니다. --ssl-verify=false로 검증을 끄면 전송 데이터가 가로채기나 변조에 노출됩니다.
- [alpacon webhook delete](https://docs.alpacax.com/ko/reference/cli/webhook/delete.md): Alpacon CLI의 alpacon webhook delete 명령으로 웹훅을 삭제합니다. 명령을 실행하기 전에 사용 구문과 위치 인수, 플래그의 유형 및 기본값을 확인하세요. 본문에 나온 구체적인 명령 예제를 참고해 필요한 값을 지정하고 작업에 맞게 실행할 수 있습니다.
- [alpacon webhook describe](https://docs.alpacax.com/ko/reference/cli/webhook/describe.md): Alpacon CLI의 alpacon webhook describe 명령으로 웹훅의 상세 정보를 확인합니다. 명령을 실행하기 전에 사용 구문과 위치 인수, 플래그의 유형 및 기본값을 확인하세요. 예제에 나온 명령을 참고해 필요한 값을 지정하고 작업에 맞게 실행할 수 있습니다.
- [alpacon webhook ls](https://docs.alpacax.com/ko/reference/cli/webhook/ls.md): Alpacon 웹훅 목록을 CLI로 조회합니다. 웹훅 이름과 URL, 상태를 확인하려면 alpacon webhook ls 또는 alpacon webhook list를 실행하세요. 기본 출력은 표입니다. 스크립트에서 웹훅 정보를 JSON으로 읽으려면 --output json을 사용하세요.
- [alpacon webhook update](https://docs.alpacax.com/ko/reference/cli/webhook/update.md): alpacon webhook update 명령으로 웹훅 설정을 편집하고 저장된 결과를 확인합니다. 명령을 실행하기 전에 사용 구문과 위치 인수, 플래그의 유형 및 기본값을 확인하세요. 예제에 나온 명령을 참고해 필요한 인수와 값을 지정해 실행 방법을 익힐 수 있습니다.
- [alpacon websh](https://docs.alpacax.com/ko/reference/cli/websh.md): Alpacon CLI로 Websh 터미널을 열거나 서버에서 명령을 실행합니다. 실행 계정을 선택하고 작업 세션을 연결하는 방법과 터미널 공유, 환경 변수 지정 예제를 확인하세요. 모든 플래그는 서버 이름 앞에 지정해야 하며, 서버 이름 뒤의 내용은 원격 명령으로 전달됩니다.
- [alpacon websh close](https://docs.alpacax.com/ko/reference/cli/websh/close.md): 활성 Websh 터미널 세션을 세션 ID로 지정해 종료합니다. 작업을 마친 세션을 종료하면 연결된 클라이언트도 연결이 끊깁니다. 세션 목록에서 ID를 확인하고 종료 명령에 지정하는 방법과 실행 예제를 안내하므로, 종료할 대상을 확인한 뒤 실제 세션 ID로 바꿔 명령을 실행하세요.
- [alpacon websh describe](https://docs.alpacax.com/ko/reference/cli/websh/describe.md): Websh 세션 ID로 세션의 상세 정보를 조회합니다. 목록에서 확인한 ID를 인수로 지정해 서버, 사용자, 상태와 연결 정보를 살펴보세요. describe 대신 desc 별칭을 사용하는 방법과 명령 예제를 안내하며, 기본 표 형식 또는 JSON 출력 형식으로 결과를 확인하세요.
- [alpacon websh force-close](https://docs.alpacax.com/ko/reference/cli/websh/force-close.md): Websh 세션의 현재 상태와 관계없이 강제로 종료합니다. 슈퍼유저 권한이 필요하며, 대상 세션 ID를 지정하면 세션을 즉시 종료합니다. 일반 종료 명령으로 처리할 수 없는 세션을 정리할 때 사용할 명령 구문과 플래그, 실행 예제를 확인하고 종료할 세션의 ID를 정확히 지정하세요.
- [alpacon websh invite](https://docs.alpacax.com/ko/reference/cli/websh/invite.md): 활성 Websh 세션에 이메일로 사용자를 초대합니다. 세션 ID를 지정하고 이메일 플래그를 반복해 여러 사람에게 초대를 보내는 방법을 확인하세요. 터미널을 보기만 해야 하는 사용자에게는 읽기 전용 권한을 부여할 수 있으며, 예제에서 대상 세션과 이메일 주소를 바꿔 실행할 수 있습니다.
- [alpacon websh join](https://docs.alpacax.com/ko/reference/cli/websh/join.md): 공유된 Websh 터미널에 참여합니다. 터미널을 공유한 사람이 제공한 URL과 비밀번호를 모두 지정하고, 토큰 대신 브라우저 로그인으로 인증한 CLI에서 명령을 실행하세요. 공유 정보를 받는 방법과 참여 명령의 필수 플래그를 확인하고, 예제의 URL과 비밀번호를 실제 값으로 바꾸세요.
- [alpacon websh ls](https://docs.alpacax.com/ko/reference/cli/websh/ls.md): Alpacon 워크스페이스의 Websh 세션 목록을 최신순으로 조회합니다. 기본으로 25개 세션을 표시하며, tail 플래그로 조회할 개수를 지정할 수 있습니다. 대상 인수 없이 조회하고, 표시된 세션 ID를 상세 조회나 종료 명령에 사용하세요. 표와 JSON 출력 형식도 지원합니다.
- [alpacon websh records](https://docs.alpacax.com/ko/reference/cli/websh/records.md): Websh 세션에 기록된 터미널 내용을 조회하거나 명령어 텍스트로 검색합니다. 민감한 정보가 가려진 기록에서 필요한 내용을 찾고, 조회할 최대 개수를 지정하는 방법을 확인하세요. 기본으로 100개 기록을 조회하며, 유료 플랜에서 사용할 수 있는 검색 플래그와 실행 예제를 안내합니다.
- [alpacon websh watch](https://docs.alpacax.com/ko/reference/cli/websh/watch.md): Websh 세션의 터미널을 조작하지 않고 읽기 전용으로 지켜봅니다. 스태프 또는 슈퍼유저 권한이 필요하며, API 토큰이나 서비스 토큰으로는 사용할 수 없습니다. 브라우저 로그인으로 인증한 뒤 대상 세션 ID를 지정하는 방법과 예제를 확인하세요. 관찰을 마치려면 Ctrl+C를 누르세요.
- [alpacon whoami](https://docs.alpacax.com/ko/reference/cli/whoami.md): Alpacon CLI에서 현재 로그인한 사용자와 워크스페이스, 권한을 확인합니다. 서버 명령을 실행하기 전에 인증 정보를 점검하고 작업 세션이 필요한지, 어떤 세션이 활성 상태인지 확인하세요. 명령 사용법과 JSON 출력 플래그, 현재 로그인한 사용자 조회 예제를 안내합니다.
- [alpacon work-session](https://docs.alpacax.com/ko/reference/cli/work-session.md): CLI에서 서버 접근에 필요한 Alpacon 작업 세션을 생성하고 조회·관리합니다. 기능별 대상 작업, 승인부터 종료까지의 상태 변화, 명령에 연결할 세션의 선택 순서를 확인하세요. 각 작업에 사용할 하위 명령의 참조 문서와 사용 예제, 접근 거부 오류를 함께 안내합니다.
- [alpacon work-session activate](https://docs.alpacax.com/ko/reference/cli/work-session/activate.md): CLI에서 승인된 Alpacon 작업 세션을 예약 시작 시각보다 일찍 활성화합니다. 수동 활성화에 필요한 세션 상태와 ID 지정 방법, CLI 공통 출력 플래그를 확인하고 예제에 따라 세션을 활성화하세요. 직접 실행하지 않아도 승인된 세션은 예약 시작 시각에 활성화됩니다.
- [alpacon work-session approve](https://docs.alpacax.com/ko/reference/cli/work-session/approve.md): Alpacon 웹 콘솔에서 대기 중인 작업 세션 요청을 검토하고 승인하는 방법을 안내합니다. `alpacon work-session approve` 하위 명령어가 오류를 반환하고 요청을 승인하지 않는 이유와, 처리한 세션의 승인 결과와 현재 상태를 확인하는 방법을 알아보세요.
- [alpacon work-session cancel](https://docs.alpacax.com/ko/reference/cli/work-session/cancel.md): CLI에서 승인 대기 중인 Alpacon 작업 세션 요청을 승인자가 검토하기 전에 취소합니다. 요청자 본인 또는 Superuser만 실행할 수 있으며, 이미 활성화된 세션은 취소할 수 없습니다. 세션 ID를 지정하는 사용법과 출력 플래그, 요청 취소 예제를 확인하세요.
- [alpacon work-session complete](https://docs.alpacax.com/ko/reference/cli/work-session/complete.md): CLI에서 활성 상태인 Alpacon 작업 세션을 완료 처리합니다. 작업을 마친 세션을 종료하면 해당 세션으로는 새 서버 작업을 실행할 수 없습니다. 세션 ID를 지정하는 사용법과 CLI 공통 출력 플래그, 대상 세션을 완료 처리하는 예제를 확인해 작업 종료 시 사용하세요.
- [alpacon work-session create](https://docs.alpacax.com/ko/reference/cli/work-session/create.md): CLI에서 작업에 필요한 서버, 기능과 사용 시간을 지정해 Alpacon 작업 세션을 생성합니다. 요청과 승인 대기, 활성 세션 지정에 필요한 플래그를 확인하세요. 계정과 sudo 명령 패턴을 함께 요청하는 예제, 에이전트 세션의 제한과 sudo 패턴 작성 규칙도 안내합니다.
- [alpacon work-session current](https://docs.alpacax.com/ko/reference/cli/work-session/current.md): 현재 워크스페이스에서 선택한 Alpacon 작업 세션을 CLI로 확인합니다. 이후 exec, websh, cp, tunnel 명령에 기본으로 어떤 세션이 연결되는지 확인하세요. 활성 세션을 지정하는 use 및 create 명령과의 관계, 출력 플래그, 명령 사용 예제를 안내합니다.
- [alpacon work-session describe](https://docs.alpacax.com/ko/reference/cli/work-session/describe.md): CLI에서 Alpacon 작업 세션의 상태와 요청 내용을 상세히 확인합니다. 세션 ID를 지정해 기능, 대상 서버, 요청자, 만료 시각을 조회하고 다음 작업에 사용할 수 있는지 판단하세요. describe의 별칭인 desc와 공통 출력 플래그, 조회 예제도 안내합니다.
- [alpacon work-session extend](https://docs.alpacax.com/ko/reference/cli/work-session/extend.md): CLI에서 승인되었거나 활성 상태인 Alpacon 작업 세션의 만료 시간을 연장합니다. 사용 시간이나 절대 만료 시각과 필수 사유를 지정하세요. 워크스페이스 정책에 따라 즉시 적용되거나 승인을 기다리며, 승인 대기 중에는 기존 만료 시간이 유지되므로 상세 조회로 결과를 확인하세요.
- [alpacon work-session ls](https://docs.alpacax.com/ko/reference/cli/work-session/ls.md): CLI에서 Alpacon 작업 세션을 상태, 요청자 유형, 사용자별로 조회합니다. 기본값은 본인의 활성 세션이며, 전체 사용자의 모든 상태를 조회하거나 AI 에이전트가 요청한 세션만 찾을 수 있습니다. 필터의 허용 값, 기본값과 목적에 맞는 목록 조회 예제를 확인하세요.
- [alpacon work-session recording](https://docs.alpacax.com/ko/reference/cli/work-session/recording.md): Alpacon 작업 세션에 포함된 Websh 터미널 기록을 CLI에서 확인합니다. 인덱스는 1부터 시작하며 타임라인에 표시되는 터미널 순서와 같습니다. 첫 번째 또는 원하는 다른 터미널을 선택하는 예제와 recording의 별칭인 rec, 공통 출력 플래그를 안내합니다.
- [alpacon work-session reject](https://docs.alpacax.com/ko/reference/cli/work-session/reject.md): Alpacon 웹 콘솔에서 대기 중인 작업 세션 요청을 검토하고 반려하는 방법을 안내합니다. `alpacon work-session reject` 하위 명령어가 오류를 반환하고 요청을 반려하지 않는 이유와, 처리한 세션의 반려 결과와 현재 상태를 확인하는 방법을 알아보세요.
- [alpacon work-session revoke](https://docs.alpacax.com/ko/reference/cli/work-session/revoke.md): CLI에서 활성 상태이거나 승인된 Alpacon 작업 세션을 강제 종료합니다. Superuser만 실행할 수 있으며 철회한 세션으로는 이후 서버 작업을 실행할 수 없습니다. 대상 세션의 ID를 지정하는 사용법과 공통 출력 플래그, 실제로 실행할 세션 철회 예제를 확인하세요.
- [alpacon work-session timeline](https://docs.alpacax.com/ko/reference/cli/work-session/timeline.md): CLI에서 Alpacon 작업 세션의 활동 내역을 시간순으로 확인합니다. 세션 ID로 이벤트와 터미널 활동을 조회하고, 터미널 기록은 recording 명령으로 이어서 확인하세요. timeline의 별칭인 tl과 공통 출력 플래그, 세션 타임라인 조회 예제를 안내합니다.
- [alpacon work-session update](https://docs.alpacax.com/ko/reference/cli/work-session/update.md): CLI에서 Alpacon 작업 세션의 제목, 설명, 서버, 기능과 일정을 수정합니다. 지정한 항목만 바뀌며 서버와 기능은 기존 목록 전체를 교체합니다. sudo 명령 패턴을 추가하는 방법과 세션 상태에 따른 제한, 세션 ID 생략 시 세션 선택 순서와 예제를 확인하세요.
- [alpacon work-session use](https://docs.alpacax.com/ko/reference/cli/work-session/use.md): 현재 워크스페이스의 활성 Alpacon 작업 세션을 지정하거나 해제합니다. 이후 exec, websh, cp, tunnel 명령은 선택한 세션을 사용하며 active 상태만 지정할 수 있습니다. unset의 사용법과 에이전트 세션의 별도 지정 방법, 예제를 확인하세요.
- [alpacon workspace](https://docs.alpacax.com/ko/reference/cli/workspace.md): Alpacon CLI에서 현재 워크스페이스를 확인하고 계정에서 사용할 수 있는 다른 워크스페이스로 전환합니다. 목록 조회와 전환 명령뿐 아니라 접근 제어, 인증, MFA, 환경설정, 사용량을 확인하는 하위 명령도 안내합니다. 각 명령의 사용법과 플래그, 짧은 별칭을 찾아 실행하세요.
- [alpacon workspace access-control update](https://docs.alpacax.com/ko/reference/cli/workspace/access-control-update.md): CLI에서 현재 워크스페이스의 접근 제어 설정을 변경합니다. 기본 편집기로 열린 JSON에서 필요한 필드를 수정하고 저장한 뒤 편집기를 닫아 현재 워크스페이스에 변경 사항을 적용하세요. 명령의 사용법과 플래그, workspace 대신 ws를 쓰는 짧은 별칭의 실행 예제도 안내합니다.
- [alpacon workspace access-control](https://docs.alpacax.com/ko/reference/cli/workspace/access-control.md): CLI에서 현재 워크스페이스의 접근 제어 설정을 조회합니다. sudo, 터널링, 디렉터리 권한 등 현재 적용된 내용을 확인하고, 명령의 사용법과 플래그, 짧은 별칭을 사용하는 예제를 알아보세요. 조회한 설정을 바꿔야 할 때 사용할 update 하위 명령의 참조 페이지도 함께 제공합니다.
- [alpacon workspace authentication update](https://docs.alpacax.com/ko/reference/cli/workspace/authentication-update.md): CLI에서 현재 워크스페이스의 인증 설정을 변경합니다. 기본 편집기로 열린 JSON에서 필요한 필드를 수정하고 저장한 뒤 편집기를 닫아 현재 워크스페이스에 변경 사항을 적용하세요. 명령의 사용법과 플래그, workspace 대신 ws를 쓰는 짧은 별칭의 실행 예제도 함께 안내합니다.
- [alpacon workspace authentication](https://docs.alpacax.com/ko/reference/cli/workspace/authentication.md): CLI에서 현재 워크스페이스의 인증 설정을 조회합니다. MFA 요구사항, 제한 시간, 허용된 인증 방법 등 적용된 내용을 확인하고, 명령의 사용법과 플래그, 짧은 별칭을 사용하는 예제를 알아보세요. 조회한 설정을 바꿔야 할 때 사용할 update 하위 명령의 참조 페이지도 제공합니다.
- [alpacon workspace ls](https://docs.alpacax.com/ko/reference/cli/workspace/ls.md): Alpacon CLI에서 계정에 연결된 워크스페이스 목록을 조회합니다. 각 워크스페이스의 이름, 리전, 연결 상태를 확인한 뒤 전환할 대상을 고르세요. 브라우저 로그인(Auth0)이 필요한 조건과 ls 대신 list를 사용하는 방법, 짧은 별칭 ws로 목록을 조회하는 예제도 안내합니다.
- [alpacon workspace mfa-methods](https://docs.alpacax.com/ko/reference/cli/workspace/mfa-methods.md): Alpacon Cloud 워크스페이스의 MFA 방법을 조회합니다. 출력된 JSON의 allowed_mfa_methods 목록을 읽고, 목록이 비어 있을 때의 의미와 패스키 로그인을 MFA로 인정하는 조건을 확인하세요. MFA 방법별 허용 값과 더 이상 적용되지 않는 설정도 안내합니다.
- [alpacon workspace preferences update](https://docs.alpacax.com/ko/reference/cli/workspace/preferences-update.md): CLI에서 현재 워크스페이스의 환경설정을 변경합니다. 기본 편집기로 열린 JSON에서 필요한 필드를 수정하고 저장한 뒤 편집기를 닫아 현재 워크스페이스에 변경 사항을 적용하세요. 명령의 사용법과 플래그, workspace 대신 ws를 쓰는 짧은 별칭의 실행 예제도 함께 안내합니다.
- [alpacon workspace preferences](https://docs.alpacax.com/ko/reference/cli/workspace/preferences.md): CLI에서 현재 워크스페이스의 환경설정을 조회합니다. 언어와 시간대 등 현재 적용된 설정을 확인하고, 명령의 사용법과 플래그, 짧은 별칭을 사용하는 실행 예제를 알아보세요. 조회한 환경설정을 바꿔야 할 때 사용할 update 하위 명령의 사용법을 담은 참조 페이지도 함께 제공합니다.
- [alpacon workspace switch](https://docs.alpacax.com/ko/reference/cli/workspace/switch.md): Alpacon CLI에서 다른 워크스페이스로 전환합니다. 브라우저 로그인(Auth0) 후 사용 가능한 목록에서 대상을 고르고, 다시 로그인하지 않고 다른 리전의 워크스페이스도 선택하세요. 이후 명령에 적용되는 워크스페이스를 바꾸는 사용법과 별칭 ws로 실행하는 예제를 안내합니다.
- [alpacon workspace usage](https://docs.alpacax.com/ko/reference/cli/workspace/usage.md): Alpacon Cloud 워크스페이스의 현재 청구 기간 사용량과 예상 비용을 CLI에서 조회합니다. 사용량 확인 명령의 사용법, 플래그, 짧은 별칭 ws로 실행하는 예제를 알아보세요. 플랜과 청구 설정으로 이동해 플랜, 한도, 결제 정보를 관리할 수 있도록 관련 문서도 안내합니다.
- [오류 메시지](https://docs.alpacax.com/ko/reference/error-messages.md): Alpacon에서 요청을 완료하지 못했을 때 표시되는 오류를 코드나 화면에 나온 문구로 찾아보세요. 한국어 번역이 없는 항목은 영어로 표시됩니다. 사이트 검색이나 브라우저의 페이지 내 검색으로 메시지를 찾고, 일반적인 문제 안내에서 단계별 해결 방법을 확인할 수 있습니다.
- [Glossary](https://docs.alpacax.com/ko/reference/glossary.md): Alpacon 용어 및 개념의 포괄적인 용어집. IAM, 제로 트러스트, 인증 방법, 접근 제어, 워크스페이스 용어, 보안 개념의 정의를 알아보세요.
- [기본값과 제한](https://docs.alpacax.com/ko/reference/limits.md): 작업 세션, 명령어 실행, 파일 실행, 터미널 공유, 파일 전송의 기본값과 한도, 변경할 수 있는 설정을 확인하세요.
- [MCP 레퍼런스](https://docs.alpacax.com/ko/reference/mcp.md): Alpacon의 제로 트러스트 인프라 접근을 Claude Desktop, Claude Code, Cursor 같은 AI 어시스턴트로 확장하는 Alpacon MCP 서버 레퍼런스입니다.
- [MCP 설정 참조](https://docs.alpacax.com/ko/reference/mcp/configuration.md): Alpacon MCP에서 사용할 수 있는 전송 방식과 인증 옵션을 비교하세요. 로컬 토큰 파일과 환경 변수의 우선순위, 도구 묶음 이름과 선택 방법을 확인합니다. 클라이언트를 연결하기 전에 필요한 설정을 선택하고 사용하지 않는 도구를 제외할 때 쉽게 참고할 수 있습니다.
- [MCP 프롬프트](https://docs.alpacax.com/ko/reference/mcp/prompts.md): Alpacon의 MCP 프롬프트 4종에 대한 레퍼런스입니다. Work Session 범위 설정, 가드 실행, 인시던트 대응, 활동 감사까지 에이전트에게 알려주는 워크플로우 가이드입니다.
- [MCP 리소스](https://docs.alpacax.com/ko/reference/mcp/resources.md): Alpacon의 읽기 전용 MCP 리소스에 대한 레퍼런스입니다. alpacon:// URI로 노출되며, 도메인별 URI 패턴과 반환 내용을 정리했습니다. 도구 호출 없이 데이터를 조회하려는 MCP 클라이언트를 위한 안내서입니다.
- [MCP 도구](https://docs.alpacax.com/ko/reference/mcp/tools.md): Alpacon MCP 도구 개요. 모든 도구에 공통으로 적용되는 매개변수, 네 가지 접근 수준, 도구 범주별 안내 위치를 소개합니다.
- [감사 로그 도구](https://docs.alpacax.com/ko/reference/mcp/tools/audit.md): 워크스페이스 전체의 활동 로그, 서버 명령 실행 이력, WebFTP 전송 이력, AI 기반 세션 보안 분석을 조회하는 MCP 도구입니다.
- [인증서 도구](https://docs.alpacax.com/ko/reference/mcp/tools/certificates.md): Alpacon의 인증 기관, 서명 요청, 발급된 인증서, 폐기 요청을 관리하는 MCP 도구입니다. 내부 PKI 생명주기 전체를 다룹니다.
- [이벤트·웹훅 도구](https://docs.alpacax.com/ko/reference/mcp/tools/events.md): Alpacon MCP 이벤트·구독·웹훅 도구 레퍼런스입니다. 서버 이벤트를 조회·검색하고, 알림 구독과 웹훅 엔드포인트를 관리하는 방법을 다룹니다.
- [명령 실행 도구](https://docs.alpacax.com/ko/reference/mcp/tools/execution.md): 서버에서 셸 명령어와 검토를 마친 스크립트를 실행하고 실행 기록을 확인하는 MCP 도구입니다. 스크립트를 서버에 쓰거나 서버에서 읽어 같은 호출에서 바로 제출할 수 있습니다. 명령어 실행에는 ACL 권한이 필요하며, OAuth나 브라우저로 호출하면 작업 세션도 필요합니다.
- [파일 전송 도구](https://docs.alpacax.com/ko/reference/mcp/tools/files.md): 안전한 WebFTP 세션을 통해 내 컴퓨터와 서버 간에 파일·폴더를 전송하는 MCP 도구입니다. 단건·대량 업로드, 다운로드, 전송 이력 조회, 상태 확인을 다룹니다.
- [IAM·API 토큰 도구](https://docs.alpacax.com/ko/reference/mcp/tools/iam.md): 워크스페이스 사용자, 그룹, 멤버십, 머신 애플리케이션과 프로그래밍 방식 접근을 위한 API 토큰을 관리하는 MCP 도구입니다. 계정 온보딩부터 토큰 생성, 로테이션, 폐기까지 다룹니다.
- [모니터링·알림 도구](https://docs.alpacax.com/ko/reference/mcp/tools/monitoring.md): Alpacon MCP 모니터링·알림 도구 레퍼런스입니다. CPU, 메모리, 디스크, 네트워크 메트릭 조회부터 리소스 사용량 기준 서버 순위 비교, 알림 규칙 생성·수정·삭제, 서버별 규칙 예외까지 다룹니다. AI 클라이언트로 인프라 상태를 점검하고 알림을 구성할 때 참고하세요.
- [접근 제어·승인 도구](https://docs.alpacax.com/ko/reference/mcp/tools/security.md): 명령·서버·파일 ACL과 승인 요청, sudo 정책을 관리하는 MCP 도구입니다. 요청을 승인하는 결정은 항상 사람이 MCP 외부에서 내립니다.
- [서버 관리 도구](https://docs.alpacax.com/ko/reference/mcp/tools/servers.md): 서버 자체를 관리하는 Alpacon MCP 도구. 서버 검색과 정보 수정, 메모 관리, 에이전트 재시작 및 업그레이드, 새 호스트 등록에 사용
- [시스템 정보·패키지 도구](https://docs.alpacax.com/ko/reference/mcp/tools/system.md): 서버의 하드웨어, OS, 사용자, 그룹, 네트워크, 디스크 정보를 조회하고 OS 패키지·Python 패키지를 설치·제거하는 Alpacon MCP 도구 레퍼런스입니다.
- [작업 세션 도구](https://docs.alpacax.com/ko/reference/mcp/tools/work-sessions.md): 인프라를 변경하는 MCP 액션의 범위를 제한하는 승인 기반 단위인 Work Session을 생성, 조회, 수정, 연장, 종료하는 MCP 도구입니다.
- [워크스페이스 관리 도구](https://docs.alpacax.com/ko/reference/mcp/tools/workspace-settings.md): 워크스페이스 전체 설정을 다루는 MCP 도구입니다. 접근 제어 정책과 보안·MFA 설정, 타임존·결제 이메일 같은 환경설정을 조회하고 수정합니다.
- [알림 이벤트와 전달 경로](https://docs.alpacax.com/ko/reference/notifications.md): Alpacon에서 어떤 활동이 알림을 만드는지 확인하세요. 승인 요청, 서버 연결 끊김, 직접 로그인, 메트릭 경고가 누구에게 어떤 채널로 전달되는지 설명합니다. 이메일과 앱 내 피드, 브라우저 알림, Slack과 웹훅의 차이 및 요금제 조건도 함께 확인할 수 있습니다.
- [역할과 권한](https://docs.alpacax.com/ko/reference/permissions.md): 워크스페이스 역할과 그룹 역할이 어떤 권한을 주는지 확인하세요. 기본 역할과 사용자 정의 역할, 권한 이름, 그룹을 통한 권한 상속 방식을 정리합니다. 사용자나 그룹에 역할을 부여하기 전에 서버 접근과 관리 작업에서 실제로 허용되는 범위를 살펴볼 때 참고할 수 있습니다.
- [지원 플랫폼](https://docs.alpacax.com/ko/reference/platforms.md): Alpamon을 설치할 수 있는 Linux, macOS, Windows 버전과 아키텍처를 확인합니다. 서버 등록 전에 플랫폼별 지원 기능, Windows 제약, 필요한 권한과 네트워크 연결을 살펴보세요. 환경에 맞는 설치 경로를 선택할 때 필요한 기준을 한곳에서 찾을 수 있습니다.
- [Windows 지원 기능](https://docs.alpacax.com/ko/reference/platforms/windows.md): Windows에서 Alpamon이 지원하는 버전과 기능을 확인합니다. Websh, WebFTP, 명령 실행과 포트 포워딩의 조건을 살펴보고 SYSTEM 계정으로 작업이 실행되는 점을 이해하세요. 설치, 업그레이드, 제거 및 복구 절차를 시작하기 전에 플랫폼 차이를 확인할 수 있습니다.
- [Private SSL 상태와 사유](https://docs.alpacax.com/ko/reference/private-ssl.md): Private SSL에서 인증 기관과 인증서가 가질 수 있는 상태를 확인하세요. 서명 요청과 폐기 요청이 승인 대기부터 완료 또는 실패까지 어떻게 표시되는지 설명합니다. 인증서를 폐기할 때 선택할 사유 코드와 각 상태에서 할 수 있는 작업의 차이도 찾아볼 수 있습니다.
- [릴리즈 노트](https://docs.alpacax.com/ko/reference/release-notes.md): 출시 월별로 묶어 최신순으로 정리한 Alpacon 릴리스 노트입니다. 웹 콘솔, CLI, 에이전트의 새 기능과 개선 사항, 주요 수정 사항을 확인할 수 있습니다.
- [접근 범위](https://docs.alpacax.com/ko/reference/scopes.md): Alpacon 역할과 토큰에 부여할 scope를 선택하는 참조 문서입니다. 리소스별로 허용하는 작업과 ACL에 따른 제한, 콘솔에서만 가능한 작업을 확인하세요. 작업 세션과 사용자 관리에 필요한 권한도 살펴보고, 역할이나 토큰을 구성할 때 어떤 scope가 필요한지 확인할 수 있습니다.
- [터미널 키보드 단축키](https://docs.alpacax.com/ko/reference/terminal-shortcuts.md): Websh 터미널에서 복사와 붙여넣기, 확대·축소, 링크 열기에 사용할 키보드 단축키를 확인합니다. 텍스트를 선택하거나 셸 명령 기록을 탐색할 때의 키도 살펴보세요. 브라우저와 셸이 같은 키를 다르게 처리하는 경우를 구분하면 원하는 동작을 더 쉽게 실행할 수 있습니다.
- [토큰 유형과 사용 기간](https://docs.alpacax.com/ko/reference/tokens.md): 개인 API 토큰, 서비스 토큰, 서버 등록 토큰의 소유자와 용도를 비교합니다. 키가 표시되는 시점과 만료 조건을 확인하고 각 토큰의 관리 방법을 찾으세요. 자동화 작업에 맞는 자격 증명을 고르고 서버, 명령어, 파일 접근 규칙이 적용되는 방식도 직접 자세히 확인하세요.
- [토큰 명령어 매칭](https://docs.alpacax.com/ko/reference/tokens/command-patterns.md): 토큰의 명령어 규칙이 입력한 명령줄, 와일드카드, 실행 계정 및 sudo와 어떻게 매칭되는지 확인합니다. 거부 코드와 감사 기록으로 원인을 구분합니다. 실제 실행 전에 명령어가 허용되지 않거나 권한 상승이 막혔을 때 어떤 규칙을 확인하고 어떻게 수정할지 미리 알아보세요.
- [작업 세션 기능](https://docs.alpacax.com/ko/reference/work-session-features.md): Alpacon 작업 세션에서 사용할 수 있는 주요 기능인 웹 터미널, 파일 전송, 명령 실행, 포트 포워딩, 코드 에디터, sudo를 알아봅니다. 기능별로 브라우저에서 여는지 CLI에서 사용하는지 확인하세요. 승인 후 기능을 바꾸는 경우와 필요한 권한도 함께 살펴봅니다.
- [작업 세션 수명 주기](https://docs.alpacax.com/ko/reference/work-session-lifecycle.md): 작업 세션이 요청, 승인, 활성화, 종료까지 어떤 상태를 거치는지 확인하세요. 각 상태의 의미와 상태를 바꿀 수 있는 사람, 예약 시작과 만료 조건을 정리합니다. 요청이 승인 대기 중이거나 세션이 끝났을 때 다음에 할 수 있는 작업과 확인할 기록도 함께 자세히 안내합니다.

## Use

- [Alpacon 사용하기](https://docs.alpacax.com/ko/use.md): 이 섹션에서 워크스페이스와 서버를 관리하고 팀의 접근 권한을 설정하는 방법을 찾을 수 있습니다. Websh 터미널, WebFTP 파일 전송과 배포 자동화를 사용할 때 필요한 절차를 살펴보세요. 작업 후에는 감사 기록을 검토하고 계정 및 개인 설정을 관리하는 안내도 확인할 수 있습니다.
- [요청 관리](https://docs.alpacax.com/ko/use/approvals.md): 승인 대기열에서 작업 세션, 보류된 명령, sudo, 서비스 토큰 요청을 검토합니다. 요청 사유와 위험도를 확인해 승인하거나 반려하고, 요청 유형별 승인 권한과 접근 규칙을 살펴보세요. 자동 승인 조건과 결정 이후 남는 기록을 확인해 각 요청이 어떻게 처리되었는지 추적할 수 있습니다.
- [요청 검토](https://docs.alpacax.com/ko/use/approvals/reviewing.md): Alpacon Approvals에서 요청의 위험도와 사유를 검토하고, 작업 세션에는 AI 사전 검토 결과도 확인합니다. 요청을 조정하거나 승인·반려할 수 있으며 긴급 세션과 일괄 처리의 조건도 살펴보세요. 승인 전에 바꿀 수 있는 항목은 요청 유형에 따라 서로 다릅니다.
- [감사 기록 개요](https://docs.alpacax.com/ko/use/audit.md): 워크스페이스 전체의 활동을 한곳에서 검토하고, 세션·sudo 권한 부여·명령어·파일 전송·승인 결정을 추적해 규정 준수와 사고 조사에 활용합니다. 역할에 따라 표시되는 범위가 다르므로 필요한 페이지를 고른 뒤 사용자, 서버, 날짜로 기록을 좁혀 당시의 작업 흐름을 확인하세요.
- [승인된 파일 실행 검토](https://docs.alpacax.com/ko/use/audit/approved-file-executions.md): 검증된 스크립트 실행의 상시 승인 목록을 확인합니다. 승인된 파일과 적용 범위, 승인자를 살펴보고 더 이상 필요하지 않은 승인을 철회하는 절차를 안내합니다. 승인 기록에서 현재 허용된 작업을 다시 확인할 수 있습니다. 철회할 때 필요한 권한과 적용 시점도 함께 설명합니다.
- [이벤트 개요](https://docs.alpacax.com/ko/use/audit/events.md): Alpacon에서 기록한 Websh 접속, sudo, 명령 실행, 파일 전송을 감사합니다. 이벤트 유형별 목록에서 사용자와 서버, 시간을 확인하고 필요한 기록을 찾으세요. 명령은 작업 세션 밖에서도 실행될 수 있으므로 관련 세션이 없는 기록도 구분해 자세히 살펴봅니다.
- [명령](https://docs.alpacax.com/ko/use/audit/events/commands.md): Alpacon 명령 기록에서 각 명령을 누가 어느 서버와 계정으로 실행했고 어떻게 끝났는지 확인합니다. 결과 칸의 상태, 옆 패널의 출력과 처리 단계, 실행 제어 판단, 명령이 반려된 이유와 다음에 할 일을 알아보고 운영 문제를 조사하거나 감사 기록을 확인할 때 활용하세요.
- [파일 전송 기록](https://docs.alpacax.com/ko/use/audit/events/file-transfers.md): WebFTP 전송 기록에서 파일의 업로드와 다운로드 결과를 확인합니다. 목록에는 파일 이름과 크기, 전송 시각, 작업자, 서버가 표시되며 행을 열면 전체 경로를 볼 수 있습니다. 일반 사용자는 본인의 기록만, 관리자는 워크스페이스의 모든 기록을 조회해 파일 이동을 추적합니다.
- [Privilege elevation](https://docs.alpacax.com/ko/use/audit/events/sudo.md): Alpacon으로 서버에서 실행된 모든 sudo의 허가와 거부 기록을 확인합니다. 누가 어느 서버와 계정에서 권한을 올렸는지, 어떤 방식으로 허가되었거나 어느 검사에서 막혔는지, 거부되었을 때 다음에 무엇을 해야 하는지 거부 사유별 안내와 함께 이 페이지에서 알 수 있습니다.
- [Web terminal](https://docs.alpacax.com/ko/use/audit/events/websh.md): Websh 감사 기록에서 접속한 사람, 서버와 계정, 시각 및 IP 주소를 확인합니다. 녹화를 사용할 수 있으면 세션 상세에서 재생하며 실행한 명령을 검토하세요. API에서는 AI 분석 완료 여부와 완료 시각으로 목록을 좁힐 수 있으며, 일반 사용자는 본인이 연 세션만 볼 수 있습니다.
- [Websh 세션 분석](https://docs.alpacax.com/ko/use/audit/events/websh/analysis.md): Websh 세션의 AI 분석은 실험 기능으로, 워크스페이스에 따라 사용하지 못할 수 있습니다. 사용할 수 있다면 세션이 끝난 뒤 위험도와 요약, 탐지된 위협과 권장 조치를 검토하세요. 분석을 직접 요청하는 방법과 아직 결과가 없을 때 표시되는 상태도 확인할 수 있습니다.
- [거버넌스 개요](https://docs.alpacax.com/ko/use/audit/governance.md): 거버넌스에서 승인 결정, 워크스페이스 활동, Alpacon을 거치지 않은 로그인의 감사 기록을 검토합니다. 역할에 따라 열 수 있는 페이지가 다르므로 필요한 기록을 고른 뒤 누가 언제 무엇을 결정했고 그 이유가 무엇인지 확인하세요. 페이지별 조회 권한도 함께 확인하세요.
- [활동 로그](https://docs.alpacax.com/ko/use/audit/governance/activity-log.md): 워크스페이스 활동 로그에서 로그인, 권한 변경과 설정 변경 등 관리자 작업을 추적합니다. 기간을 골라 특정 이벤트를 찾고 상세 내용을 검토하거나 API로 기록을 조회하세요. 어떤 활동이 남는지와 각 기록에 표시되는 정보를 확인해 워크스페이스 변경 이력을 살펴볼 수 있습니다.
- [Approval history](https://docs.alpacax.com/ko/use/audit/governance/approvals.md): 처리가 끝난 승인 요청에서 누가 무엇을 요청했고 누가 결정했는지 검토합니다. 기간이나 요청 유형으로 목록을 좁히고 상세 기록에서 결정 결과와 사유를 확인하세요. 이 기록에 접근할 수 있는 역할과 플랜 조건도 살펴보고, 요청이 처리된 흐름을 워크스페이스 감사에 활용할 수 있습니다.
- [External access](https://docs.alpacax.com/ko/use/audit/governance/external-access.md): Alpacon을 거치지 않고 서버에 도달한 SSH, 콘솔, su 직접 로그인을 검토합니다. 로그인 분류와 알림, 검토 권한, 플랜별 제공 기능을 알아봅니다. 탐지를 켜는 방법과 발견 사항이 생기는 기준을 확인하고, 팀이 직접 로그인을 검토할 때 필요한 알림과 권한도 살펴보세요.
- [직접 로그인 탐지 범위](https://docs.alpacax.com/ko/use/audit/governance/external-access/coverage.md): 서버가 직접 로그인 기록을 보고할 수 있는지 탐지 범위를 확인합니다. 서버별·날짜별 상태와 탐지 대상의 의미를 살펴보고, 로그인이 탐지되지 않는 원인을 해결하세요. 기록이 없는 기간을 해석할 때는 그 기간에 서버가 로그인 활동을 보고할 수 있었는지 먼저 확인해야 합니다.
- [요약과 증거](https://docs.alpacax.com/ko/use/audit/governance/external-access/evidence.md): 감사 기간의 직접 로그인 요약에서 분류별 건수와 발견 사항, 상시 허용 항목의 검토 내역을 확인합니다. 서버별·날짜별 탐지 범위와 보관 기간 밖의 날짜를 구분하세요. Essentials와 Enterprise에서는 CSV 기록이 담긴 증거 ZIP을 내려받을 수 있습니다.
- [직접 로그인 검토](https://docs.alpacax.com/ko/use/audit/governance/external-access/review.md): External access에서 검토가 필요한 직접 로그인을 확인합니다. 발견 사항에 묶인 로그인과 당사자의 답변을 읽고 개별 또는 일괄로 처리 결과를 남기세요. 예상한 접근은 상시 허용 항목으로 관리하고, 아직 처리하지 않은 항목은 검토 대기열에서 찾아볼 수 있습니다.
- [정기 리포트 검토](https://docs.alpacax.com/ko/use/audit/governance/periodic-reports.md): 정기 리포트에서 기간별 활동과 발견 사항, 연결된 감사 기록을 확인합니다. 기간과 활동 여부로 목록을 좁히고 각 발견 사항에 검토 결과와 이유를 남기는 방법을 안내합니다. 조회와 결정 기록에 필요한 권한을 확인하고, 근거가 부족한 항목을 검토할 때 살펴볼 사항을 알아봅니다.
- [Session history](https://docs.alpacax.com/ko/use/audit/sessions.md): 종료된 작업 세션의 실행 주체, 서버, 종료 상태와 승인 범위를 검토합니다. 세션 목록을 상태와 기간으로 좁히고 행을 열어 명령, 파일 전송, sudo 권한 부여를 살펴보세요. AI 분석을 사용하는 배포에서는 위험도도 확인할 수 있으며, 조회 범위는 사용자 역할에 따라 달라집니다.
- [세션 종료 후](https://docs.alpacax.com/ko/use/audit/sessions/review.md): 작업 세션이 끝나면 기록 탭에서 명령과 파일 전송 등 활동 타임라인을 검토합니다. 유료 플랜에서는 터미널 녹화를 재생할 수 있으며, AI 분석 탭에서는 세션이 종료된 뒤 위험도와 요약, 탐지된 위협, 권장 조치를 확인하세요. 분석 전인 세션에는 결과를 요청할 수 있습니다.
- [위협 분석 조사](https://docs.alpacax.com/ko/use/audit/threat-analysis.md): 위협 분석에서 세션 기록에 나타난 공격 패턴을 살펴봅니다. 기간과 요청자, 위험도로 범위를 좁히고 기법에 연결된 세션 기록을 열어 조사하는 방법을 안내합니다. 조사할 사건의 관련 활동을 한곳에서 확인할 수 있습니다. 표시된 위험 신호와 실제 세션의 관계를 검토해 보세요.
- [접근 제어 개요](https://docs.alpacax.com/ko/use/iam.md): Alpacon IAM에서 워크스페이스 자원의 접근 권한을 관리합니다. 사용자 역할과 그룹, 기능 권한이 함께 작동하는 방식을 살펴보고, 새 팀원을 초대하거나 서버 접근을 바꾸기 전에 확인할 항목을 찾아보세요. 역할별 권한과 그룹 멤버의 서버 접근 상속 방식도 함께 살펴보세요.
- [Applications](https://docs.alpacax.com/ko/use/iam/applications.md): Alpacon Application으로 CI/CD, 모니터링, 자동화, AI 에이전트의 접근을 분리합니다. 개인 자격 증명을 공유하지 않고 주체별 서비스 토큰을 발급할 수 있습니다. 생성할 때 이름, 설명, 서비스 타입을 설정하고 상세에서 서버 접근, 역할, 활동 기록을 확인하세요.
- [프로비저닝](https://docs.alpacax.com/ko/use/iam/applications/provisioning.md): Alpacon Application이 사용할 서버 계정의 이름, shell, 홈 디렉터리와 UID를 설정합니다. 비활성, Lazy, 자동 프로비저닝 모드에 따라 계정이 생성되는 시점을 확인하세요. 시스템 사용자 설정과 변경한 값이 서버에 반영되는 시점도 함께 살펴볼 수 있습니다.
- [서비스 토큰](https://docs.alpacax.com/ko/use/iam/applications/service-tokens.md): Alpacon 서비스 토큰으로 자동화 작업을 구성합니다. 애플리케이션 계정과 역할, scope와 접근 규칙을 설정하고 승인 절차를 확인하세요. 키 교체와 만료, Cloud와 자체 호스팅의 sudo 조건을 이해하고 CI 작업에 필요한 자격 증명을 관리하는 방법을 안내합니다.
- [서비스 토큰으로 명령어 허용](https://docs.alpacax.com/ko/use/iam/applications/service-tokens/command-patterns.md): 애플리케이션 서비스 토큰에 허용 명령어를 등록하고 sudo 동작을 확인합니다. 위험도 검사나 접근 규칙이 자동화 명령어를 거부할 때 조치할 수 있습니다. 실제 작업 전에 실행할 명령어와 일치하는 규칙을 작성하고, 거부된 명령어의 기록에서 원인을 먼저 확인하는 방법을 알아보세요.
- [그룹](https://docs.alpacax.com/ko/use/iam/groups.md): 그룹으로 같은 서버 접근이 필요한 사용자를 묶고 멤버와 역할을 관리합니다. 그룹에 서버를 할당하면 구성원이 해당 권한을 함께 받으므로 서버 접근 범위를 확인하세요. 이 섹션에서 그룹 생성, 구성원 변경, 서버 권한 설정과 활동 기록 검토에 필요한 절차를 찾을 수 있습니다.
- [그룹에 사용자 할당](https://docs.alpacax.com/ko/use/iam/groups/assign-users.md): 사용자를 그룹에 추가하거나 제거해 서버 접근 범위를 조정합니다. 그룹 소유자·관리자·멤버의 역할을 확인하고, 역할에 따라 누가 구성원을 바꿀 수 있는지 살펴보세요. 그룹 멤버는 할당된 서버의 권한을 받으므로 변경 뒤에는 멤버 목록과 실제 서버 접근 권한을 다시 확인합니다.
- [그룹 생성하기](https://docs.alpacax.com/ko/use/iam/groups/create.md): 팀이나 프로젝트의 서버 접근을 나누려면 사용자 그룹을 새로 만듭니다. 그룹 이름 규칙을 확인하고 필요한 사용자를 추가한 뒤 서버를 할당하세요. 생성 후에는 소유자·관리자·멤버 역할과 서버 접근 범위를 검토해 구성원이 필요한 서버에만 접근할 수 있도록 그룹을 설정합니다.
- [그룹 조회 및 편집](https://docs.alpacax.com/ko/use/iam/groups/manage.md): 사용자 그룹을 찾아 상세 정보와 멤버, 서버 할당, 활동 기록을 검토합니다. 그룹 정보를 수정하거나 삭제하기 전에는 해당 그룹을 사용하는 사람과 서버를 확인하세요. 변경 후 접근 권한이 달라지는 방식과 수정 또는 삭제할 수 없는 시스템 그룹도 자세히 구분할 수 있습니다.
- [그룹 권한 설정](https://docs.alpacax.com/ko/use/iam/groups/set-permissions.md): 그룹에 서버를 할당하고 Websh, WebFTP, 명령 실행 권한을 설정합니다. 구성원이 서버와 기능별 권한을 상속받는 방식을 확인한 뒤 필요한 접근을 조정하세요. 변경 후에는 그룹 멤버가 실제로 접근할 수 있는 서버와 각 작업 기능의 허용 범위를 다시 검토할 수 있습니다.
- [사용자](https://docs.alpacax.com/ko/use/iam/users.md): 워크스페이스 사용자를 초대하고 역할과 서버 계정 이름을 관리합니다. 사용자 역할과 서버에서 쓰는 이름이 접근 범위에 영향을 주므로 변경할 때 함께 확인하세요. 이 섹션에서 팀원 초대, 계정 정보 변경, 서버 권한 검토와 안전한 계정 제거에 필요한 절차를 찾을 수 있습니다.
- [팀원 초대하기](https://docs.alpacax.com/ko/use/iam/users/add.md): 워크스페이스에 팀원을 이메일로 초대하고 역할을 설정합니다. 초대 메일을 보낸 뒤 상태를 확인하거나 필요하면 초대를 취소하세요. 플랜별 멤버 수 제한과 선택한 역할이 새 구성원의 접근 범위에 미치는 영향을 검토해 초대 전에 필요한 권한과 남은 자리를 확인할 수 있습니다.
- [사용자 조회 및 편집](https://docs.alpacax.com/ko/use/iam/users/manage.md): 워크스페이스 사용자 목록에서 검색과 필터로 수정할 대상을 찾습니다. 사용자 상세 화면에서 프로필과 역할을 변경하고 비밀번호를 재설정하세요. 수정한 계정 정보가 화면에 어떻게 표시되는지, 역할 변경 후 실제 서버 접근 범위에 어떤 영향이 있는지도 함께 확인할 수 있습니다.
- [사용자 제거하기](https://docs.alpacax.com/ko/use/iam/users/remove.md): Alpacon 워크스페이스에서 사용자를 제거하기 전에 필요한 권한과 진행 중인 작업 세션을 확인하세요. 일반 삭제와 완전 삭제의 차이를 비교하고, 삭제 뒤 남는 기록과 데이터에 미치는 영향을 살펴본 뒤 알맞은 방법을 선택합니다. 사용자를 제거하기 전에 영향받는 권한을 점검하세요.
- [사용자명 충돌 해결](https://docs.alpacax.com/ko/use/iam/users/resolve-conflicts.md): 서버의 기존 사용자와 Alpacon IAM 사용자 사이에 UID 충돌이 생기면 해당 계정을 확인합니다. 상황에 맞는 해결 방법을 고르고 UID를 바꿀 때의 주의사항을 검토하세요. 같은 충돌이 다시 일어나지 않도록 사용자 설정과 서버의 기존 계정을 함께 점검할 수 있습니다.
- [사용자명 관리](https://docs.alpacax.com/ko/use/iam/users/username.md): Alpacon 사용자의 UNIX 사용자명이 서버 접근 기능에서 어떻게 쓰이는지 확인합니다. 처음 설정된 사용자명을 확인하고 변경이 필요하면 승인 절차에 따라 요청하세요. 서버 기능에서 어떤 계정 이름으로 표시되는지 살펴보면 접근할 때 사용할 사용자명을 확인할 수 있습니다.
- [실시간 활동](https://docs.alpacax.com/ko/use/live-activity.md): Live activity에서 진행 중인 작업 세션을 실시간으로 살펴봅니다. 터미널·명령·sudo·파일 전송의 최근 활동을 확인하고, 위험도가 높거나 명령이 차단된 세션을 별도로 볼 수 있습니다. 세션 상세에서는 권한에 따라 작업을 완료하거나 접근을 철회할 수 있습니다.
- [성능 메트릭 확인](https://docs.alpacax.com/ko/use/metrics.md): Metrics에서 서버의 CPU, 메모리, 디스크, 네트워크 차트를 기간별로 확인합니다. 값이 달라진 시점을 찾아 관련 알림과 서버 상세 화면으로 이동하는 방법을 안내합니다. 서버별 추이를 비교해 상태 변화를 살펴볼 수 있습니다. 차트를 사용할 수 있는 요금제 조건도 설명합니다.
- [메트릭 알림 규칙 설정](https://docs.alpacax.com/ko/use/metrics/rules.md): 메트릭 알림 규칙을 만들고 감시할 서버를 연결합니다. 임계값과 유지 시간, 복구 조건을 설정하고 심각도에 따른 알림 수신 방법을 확인합니다. 규칙이 발동했을 때 관련 내역을 찾아 조정하는 방법도 안내합니다. 기본 규칙과 직접 만든 규칙의 차이, 복구 상태를 확인하는 경로도 살펴봅니다.
- [접근 규칙](https://docs.alpacax.com/ko/use/policies/access-rules.md): Alpacon에서 세션 시작, sudo 사용, 명령어 실행에 적용할 접근 규칙을 설정하고 검증하세요. 네 가지 예제로 대상과 결과를 정하고, 규칙 순서와 미리보기 결과를 확인한 뒤 저장할 수 있습니다. 실제 실행 후에는 기록과 승인 상태를 확인해 예상한 규칙이 적용됐는지 점검하세요.
- [인증 정책 설정](https://docs.alpacax.com/ko/use/policies/authentication.md): 워크스페이스 로그인에 MFA를 적용하고 허용할 인증 수단을 정합니다. 패스키로 로그인했을 때 추가 인증이 필요한 조건과 민감한 설정을 변경할 때 재인증을 요청하는 조건을 살펴봅니다. 멤버에게 표시되는 안내도 확인할 수 있습니다. 허용된 수단을 바꿀 때 로그인에 미치는 영향도 알아봅니다.
- [서버 접근 정책 설정](https://docs.alpacax.com/ko/use/policies/server-access.md): 워크스페이스의 서버와 계정 기본값, root 및 sudo 접근, 토큰 만료 기간을 설정합니다. 실행 제어의 적용 범위를 살펴보고 정책을 바꿀 수 있는 역할과 인증 조건을 확인합니다. 새 서버와 기존 서버에 적용되는 차이도 안내합니다. 변경을 저장할 때 재인증이 필요한 경우도 설명합니다.
- [Private SSL](https://docs.alpacax.com/ko/use/private-ssl.md): Alpacon Private SSL에서 내부 SSL/TLS 인증서를 관리합니다. 인증 기관을 만들고 인증서 서명 요청을 승인한 뒤 발급, 만료와 폐기 상태를 확인하세요. 이 기능을 사용할 수 있는 워크스페이스 조건과 처음 설정할 때 필요한 절차도 이 섹션에서 살펴볼 수 있습니다.
- [인증 기관](https://docs.alpacax.com/ko/use/private-ssl/authorities.md): Alpacon Private SSL에서 인증 기관을 생성하고 관리하세요. 루트 CA 설정, 키 알고리즘 구성, 루트 인증서 및 CRL 다운로드 방법을 알아보세요. 인증 기관 목록과 상세 화면에서 상태를 확인하고, 발급에 필요한 설정을 마친 뒤 인증서와 폐기 목록을 내려받을 수 있습니다.
- [인증서](https://docs.alpacax.com/ko/use/private-ssl/certificates.md): Private SSL에서 발급된 SSL/TLS 인증서를 목록과 상세 화면에서 조회합니다. 상태와 발급 기관, 유효 기간을 살펴보고 유효한 인증서는 내려받으세요. 만료 예정 탭에서는 갱신이 필요한 인증서를 찾아 만료 시점과 서명 정보를 확인한 뒤 후속 작업을 준비할 수 있습니다.
- [요청](https://docs.alpacax.com/ko/use/private-ssl/requests.md): Private SSL에서 인증서 서명 요청과 폐기 요청을 관리합니다. 요청 유형에 따라 수행할 수 있는 작업을 확인하고 관리자 감독 아래 요청을 만들거나 승인 또는 거절하세요. 상세 화면에서는 각 요청의 승인 상태와 처리 결과를 확인해 인증서 작업의 진행 상황을 추적할 수 있습니다.
- [서버 개요](https://docs.alpacax.com/ko/use/servers.md): 클라우드와 온프레미스 서버를 한곳에서 등록하고 관리합니다. 그룹을 연결해 접근 범위를 정하고 목록에서 필요한 서버를 찾아 상태와 지표를 확인하세요. 이 섹션에는 서버 연결, 모니터링, 정보 수정과 제거에 필요한 절차가 있으므로 작업 목적에 맞는 안내로 이동할 수 있습니다.
- [서버 네트워크 준비](https://docs.alpacax.com/ko/use/servers/configure-network.md): 서버와 클라이언트에서 Alpacon 워크스페이스에 안전하게 연결할 때 필요한 아웃바운드 목적지를 확인합니다. 방화벽 허용 목록, 프록시 변수, 다운로드 호스트와 리전 선택을 점검하세요. SSH 접근을 줄이기 전에 대체 접속 경로와 연결 문제 해결 방법도 함께 미리 확인하세요.
- [서버 접속하기](https://docs.alpacax.com/ko/use/servers/connect.md): 등록된 서버에 접속하려면 서버 상태와 그룹 할당을 확인하고 작업 세션에서 필요한 기능을 선택합니다. 세션이 활성화되면 터미널, 에디터 또는 파일 전송을 열고 접속 계정에 따른 인증을 마치세요. 연결이 되지 않을 때는 서버와 접근 조건을 확인하고 안내된 해결 절차를 따를 수 있습니다.
- [서버 접근 제어하기](https://docs.alpacax.com/ko/use/servers/groups.md): 그룹을 서버에 연결하면 멤버의 서버 접근 범위를 정할 수 있습니다. 그룹별 서버와 상속된 권한을 검토하고 서버 maintainer나 범위를 지정한 사용자 역할도 함께 확인하세요. 작업 세션과 sudo 정책이 적용되는 대상 범위까지 살펴보면 실제 접근 권한을 파악할 수 있습니다.
- [서버 관리](https://docs.alpacax.com/ko/use/servers/manage.md): 등록된 서버의 정보를 바꾸고 원격 관리 작업을 수행합니다. 서버 목록과 상세 화면에서 가능한 작업을 확인한 뒤 터널과 코드 에디터를 켜거나 끄고, Alpamon 에이전트를 재시작하거나 업그레이드하세요. 설정 변경 이력과 업그레이드가 끝난 뒤의 기록도 확인할 수 있습니다.
- [SSH에서 Alpacon으로 전환](https://docs.alpacax.com/ko/use/servers/migrate-from-ssh.md): 기존 SSH 접근을 Alpacon 작업 세션으로 단계적으로 전환합니다. 현재 사용자와 키를 조사하고 두 경로를 함께 운영하면서 접속, 자동화, 파일 전송을 검증하세요. SSH 포트를 닫기 전에는 비상 접속 경로를 남기고, 문제가 생겼을 때 되돌리는 절차를 꼭 준비합니다.
- [서버 상태 확인](https://docs.alpacax.com/ko/use/servers/monitor.md): 서버의 온라인 상태와 오프라인 알림을 확인합니다. 계획된 작업 동안 알림을 일시 중지하고 연결 이력과 로그를 살펴보는 방법을 안내합니다. 서버의 응답이 끊겼을 때 알림이 발생하고 해제되는 조건도 확인할 수 있습니다. 서버에 다시 연결된 후 기록을 찾는 경로도 살펴봅니다.
- [서버 등록하기](https://docs.alpacax.com/ko/use/servers/register.md): Alpamon 에이전트를 설치해 클라우드나 온프레미스 서버를 Alpacon에 등록합니다. 등록 전에 지원 플랫폼과 필수 요구사항을 확인하고 설치 후 서버가 온라인으로 표시되는지 살펴보세요. 연결 오류가 나면 상태를 점검하고 이 페이지의 해결 절차에 따라 다시 연결할 수 있습니다.
- [Alpamon 설치](https://docs.alpacax.com/ko/use/servers/register/install.md): 지원되는 Linux, macOS, Windows 서버에 Alpamon을 설치하고 워크스페이스에 등록합니다. 생성된 설치 명령을 사용하거나 플랫폼에 맞는 수동 방법을 선택하세요. 등록 결과를 확인하고, 인증서나 프록시 등 별도 구성이 필요할 때 참고할 자료도 찾을 수 있습니다.
- [서버 등록 토큰 관리](https://docs.alpacax.com/ko/use/servers/register/tokens.md): 서버 자동 등록에 쓸 토큰의 허용 그룹과 만료일을 설정합니다. 등록 흐름에서 새 토큰을 만들거나 기존 토큰을 선택하고, 새 서버가 속할 사용자 그룹을 확인하세요. 토큰에 허용된 그룹은 새 서버에 접근할 수 있는 사용자 범위에 영향을 주므로 실제 등록 전에 검토해야 합니다.
- [서버 제거하기](https://docs.alpacax.com/ko/use/servers/remove.md): 서버를 제거할 때는 먼저 Alpamon 에이전트를 해제합니다. 필요하다면 워크스페이스에 남은 서버 등록 기록도 별도로 삭제하세요. 여러 서버를 일괄 삭제하거나 오프라인 서버를 처리할 때의 주의사항을 확인하고, 해제 후 남는 정보와 삭제되는 기록을 정확히 구분할 수 있습니다.
- [에이전트 문제](https://docs.alpacax.com/ko/use/servers/troubleshooting.md): Alpamon 에이전트가 설치되지 않거나 서버에 연결되지 않을 때 원인을 확인하세요. 업그레이드가 멈춘 경우에도 서비스 상태, 로그, 운영체제 권한을 점검할 수 있습니다. 각 증상에 맞는 복구 절차와 다시 시도하기 전에 확인할 설치 조건, 관리자에게 전달할 정보까지 안내합니다.
- [개요](https://docs.alpacax.com/ko/use/settings.md): 사용자 설정에서 계정 정보, 보안과 인증, Websh 터미널, 표시 언어와 테마를 관리합니다. 각 메뉴에서 로그인 보안과 화면 표시 방식을 조정하고 현재 적용된 설정을 확인하세요. 필요한 항목을 바꾼 뒤에는 설정 화면에서 로그아웃하는 방법도 확인해 안전하게 작업을 마칠 수 있습니다.
- [계정 설정](https://docs.alpacax.com/ko/use/settings/account.md): 계정 설정에서 이름, 이메일, 전화번호와 기본 워크스페이스를 수정합니다. 가입일과 마지막 로그인 시각·IP를 확인하고, 로그인 기록에서 브라우저와 기기별 세션을 살펴보세요. 이메일 변경에는 인증이 필요하며 Google 계정의 제한과 되돌릴 수 없는 계정 삭제 조건도 확인할 수 있습니다.
- [개인 API 토큰 관리](https://docs.alpacax.com/ko/use/settings/api-tokens.md): Alpacon API를 제한된 권한으로 호출할 개인 API 접근 토큰을 만듭니다. 접근 범위와 만료일을 설정하고 서버 ACL 규칙을 검토하세요. 기존 토큰은 명령·파일 권한을 유지할 수 있지만 새 개인 토큰에는 부여할 수 없습니다. 자동화와 CI에는 서비스 토큰을 사용합니다.
- [언어 및 테마](https://docs.alpacax.com/ko/use/settings/language-theme.md): Alpacon에서 표시 언어를 한국어 또는 영어로 바꾸고 화면 테마를 시스템 설정, 다크, 라이트 중에서 선택합니다. 설정한 언어와 테마는 특정 페이지에만 적용되는 것이 아니라 화면 전체에 적용됩니다. 현재 작업 환경에 맞는 조합을 고르고, 각 옵션에서 선택할 수 있는 값을 확인하세요.
- [알림 수신 설정](https://docs.alpacax.com/ko/use/settings/notifications.md): 이메일, 푸시, Slack DM으로 받을 개인 알림을 선택합니다. 알림 종류나 채널 전체의 수신을 끄고 가능한 경우 특정 이벤트만 끄는 방법을 안내합니다.
- [보안 설정](https://docs.alpacax.com/ko/use/settings/security.md): 보안 설정에서 현재 비밀번호를 사용해 새 비밀번호를 정하고 MFA 인증 수단을 등록하거나 관리합니다. 여러 인증 수단의 우선순위를 조정하고 복구 코드를 확인하세요. 추가 인증이 필요한 상황과 MFA를 다시 요구하는 경우도 살펴보면 로그인 때 사용할 인증 수단을 준비할 수 있습니다.
- [Websh 설정](https://docs.alpacax.com/ko/use/settings/websh.md): Websh 터미널의 세션 관리와 공유 설정, 테마·글꼴·클립보드 등 화면과 입력 설정을 구성하는 방법을 안내합니다. 세션과 터미널 탭에서 각각 설정을 바꾸고, 연결 유지 시간과 공유 조건을 확인한 뒤 작업 환경을 조정하세요. 두 탭에서 적용되는 설정의 범위도 확인할 수 있습니다.
- [일반적인 문제](https://docs.alpacax.com/ko/use/troubleshooting.md): Alpacon을 사용할 때 자주 겪는 로그인, 접근, 연결, 설정 문제를 해결하세요. 화면에 나타난 증상에 따라 확인할 항목과 다음 작업을 안내합니다. 해결되지 않으면 관련 작업 가이드에서 더 자세한 절차와 필요한 권한, 다시 시도하기 전에 확인할 조건을 찾아볼 수 있습니다.
- [작업 세션 개요](https://docs.alpacax.com/ko/use/work-sessions.md): 작업 세션을 요청할 때 서버, 사용할 기능과 이용 시간을 지정합니다. 접근 규칙에 따라 승인 여부가 정해지고, 세션이 활성화되면 터미널·파일 전송·에디터·명령 실행 기능을 사용할 수 있습니다. 요청 상태별로 가능한 작업을 확인하고 세션이 끝난 뒤 활동 기록을 검토하세요.
- [계정 선택](https://docs.alpacax.com/ko/use/work-sessions/account-selection.md): 작업 세션을 만들 때 서버 접속 계정의 선택 범위를 확인합니다. 이 계정은 Websh, WebFTP, 코드 에디터에 적용됩니다. 서버 역할별로 선택할 수 있는 계정이 다르고, 본인 계정이 아닌 계정에는 MFA가 필요할 수 있으므로 요청 전에 조건과 계정 선택 범위를 함께 확인하세요.
- [명령 실행](https://docs.alpacax.com/ko/use/work-sessions/commands.md): Alpacon 서버에서 exec로 명령어를 실행하는 방법을 살펴봅니다. 작업에 맞는 접속 방식과 계정을 선택하고, 감사 기록과 실시간 활동에서 결과를 확인하세요. 명령줄과 스크립트의 입력 제한, 실시간 출력과 저장된 결과의 차이, 실행 시간과 대기 시간을 구분해 작업을 준비하세요.
- [검증된 파일 실행](https://docs.alpacax.com/ko/use/work-sessions/commands/file-execution.md): 검토한 내용과 같은 스크립트를 서버에서 실행하는 방법을 살펴봅니다. 로컬 사본, 업로드, 서버 파일 중 입력 방식을 선택하고 파일 크기와 경로, 인수 제한을 확인하세요. 상시 승인이 적용되는 조건과 재사용 기간, 철회 후 동작을 이해하고 실행에 필요한 작업 세션 기능을 준비하세요.
- [명령 실행하기](https://docs.alpacax.com/ko/use/work-sessions/commands/run.md): 승인받은 작업 세션과 계정으로 Alpacon 명령어를 실행합니다. 목적을 전달하고 시크릿은 환경 변수로 넘기는 방법을 알아보세요. 오래 걸리는 작업은 detach로 제출한 뒤 같은 작업의 결과를 조회하고, 승인 대기와 실행 시간 초과, CLI 대기 종료를 구분해 중복 실행을 피하세요.
- [명령 실행 문제 해결](https://docs.alpacax.com/ko/use/work-sessions/commands/troubleshooting.md): Alpacon 명령어가 거부되거나 보류되고, 실행 중 멈춘 이유를 확인합니다. 실제 오류 메시지와 종료 코드를 조치 방법에 맞춰 살펴보세요. 작업 세션 권한과 실행 목적, 환경 변수, 파일 실행 조건을 점검하고 같은 작업의 상태를 확인한 뒤 재시도해 중복 실행을 피하세요.
- [세션 요청하기](https://docs.alpacax.com/ko/use/work-sessions/create.md): Alpacon에서 서버 작업에 필요한 세션을 요청하는 방법을 안내합니다. 목적, 서버, 접속 계정, 기능, 사용 시간을 선택하고 제출 전에 승인 조건을 확인하세요. 다른 사용자의 세션을 요청하는 방법과 AI 에이전트가 지켜야 할 계정·기능 제한, CLI 요청 방법도 설명합니다.
- [세션 사용하기](https://docs.alpacax.com/ko/use/work-sessions/detail.md): Alpacon에서 승인된 작업 세션을 사용하는 방법을 안내합니다. 브라우저에서 기능을 실행하고 CLI에서 진입하며, 여덟 가지 상태의 의미와 전환 조건을 확인하세요. 사용 시간 제한과 만료 알림, 세션 연장·종료·취소 방법을 익히고 작업 중 접근이 끝났을 때 필요한 조치도 확인하세요.
- [코드 에디터 개요](https://docs.alpacax.com/ko/use/work-sessions/editor.md): 작업 세션에서 Alpacon Editor를 열어 서버의 파일을 브라우저에서 편집합니다. 처음 연결하면 편집 환경이 자동으로 설정되며 로컬 IDE나 SSH 설정은 필요하지 않습니다. 워크스페이스가 에디터 MFA를 요구할 때 다른 계정으로 접속하는 조건과 다시 연결하는 방법도 확인하세요.
- [에디터 접속하기](https://docs.alpacax.com/ko/use/work-sessions/editor/connect.md): Editor를 열기 전에 서버 상태와 작업 세션의 편집 권한을 확인하고 접속 계정을 고릅니다. 워크스페이스가 에디터 MFA를 요구할 때 본인 계정이 아닌 계정으로 접속하면 추가 인증을 마쳐야 합니다. 처음 연결할 때의 화면과 연결이 끊긴 뒤 기존 에디터로 돌아가는 방법도 확인하세요.
- [에디터 인터페이스](https://docs.alpacax.com/ko/use/work-sessions/editor/interface.md): Alpacon 코드 에디터에서 파일 탐색기, 여러 파일을 여는 탭, 구문 강조 편집기와 통합 터미널의 위치를 확인합니다. 로컬과 원격 서버 사이에서 텍스트를 복사·붙여넣는 방법을 살펴보고, 새 브라우저 탭에 열리는 화면과 Alpacon 테마 설정에 따라 바뀌는 표시 방식도 확인하세요.
- [에디터 세션](https://docs.alpacax.com/ko/use/work-sessions/editor/sessions.md): 열어 둔 Alpacon Editor 세션에 다시 들어가거나 종료하는 방법을 확인합니다. 브라우저 연결이 끊겨도 같은 에디터로 돌아갈 수 있는 조건과, 에디터가 자동으로 종료되는 상황을 살펴보세요. 작업을 마쳤다면 작업 세션에서 열려 있는 에디터를 직접 종료할 수 있습니다.
- [파일 관리 개요](https://docs.alpacax.com/ko/use/work-sessions/files.md): 작업 세션에서 WebFTP를 열어 브라우저와 원격 서버 사이에서 파일을 옮깁니다. 원격 서버 파일을 관리하고 업로드와 다운로드에 적용되는 보안 조건을 확인하세요. 전송을 마친 뒤에는 감사 기록에서 누가 어떤 파일을 언제 옮겼는지 확인해 작업 내역을 추적할 수 있습니다.
- [파일 다운로드하기](https://docs.alpacax.com/ko/use/work-sessions/files/download.md): WebFTP에서 서버의 파일과 폴더를 컴퓨터로 내려받습니다. 목록에서 단일 파일이나 여러 항목을 고르고, 폴더 전체는 압축 아카이브로 저장하세요. 전송 중에는 화면에 표시되는 진행 상태를 확인하고, 항목 유형에 따라 다운로드 결과가 어떻게 달라지는지 살펴볼 수 있습니다.
- [파일 및 폴더 관리](https://docs.alpacax.com/ko/use/work-sessions/files/manage.md): WebFTP 파일 메뉴에서 원격 파일과 폴더를 다운로드, 복사, 이동, 이름 변경 또는 삭제합니다. 새 폴더를 만들고 숨김 파일 표시를 바꾸거나 브레드크럼으로 현재 위치를 확인하세요. 서버 플랫폼에 따라 사용할 수 있는 파일 작업이 어떻게 달라지는지도 살펴볼 수 있습니다.
- [파일 권한 설정](https://docs.alpacax.com/ko/use/work-sessions/files/permissions.md): WebFTP에서 Linux·macOS 서버의 파일 권한과 소유권을 바꿉니다. chmod 탭에서 읽기·쓰기·실행 권한을 선택하고, chown 탭에서 소유자와 그룹을 지정하세요. 실제 적용 전에 명령어 미리보기를 확인하고, 폴더는 하위 항목까지 재귀적으로 변경할 수 있습니다.
- [WebFTP 문제](https://docs.alpacax.com/ko/use/work-sessions/files/troubleshooting.md): Alpacon에서 WebFTP 파일 전송이 실패했을 때 원인을 확인하고 해결하는 방법을 안내합니다. 파일과 폴더 이름·경로의 길이 제한, 세션 종료 시점, 목록에서 사라진 전송을 살펴보고, alpacon cp 명령어에 표시되는 오류 메시지에 맞춰 다시 전송하는 방법을 알아보세요.
- [파일 업로드하기](https://docs.alpacax.com/ko/use/work-sessions/files/upload.md): WebFTP에서 드래그 앤 드롭이나 New 메뉴로 서버에 파일과 폴더를 업로드합니다. 여러 항목을 한 번에 올리고 화면에서 각 전송 진행 상태를 확인하세요. 같은 이름의 항목이 있거나 파일과 폴더의 유형이 충돌할 때 사용자에게 제공되는 처리 방법도 살펴볼 수 있습니다.
- [터미널 접근 개요](https://docs.alpacax.com/ko/use/work-sessions/terminal.md): Websh에서는 SSH 클라이언트 없이 브라우저에서 서버 터미널을 열 수 있습니다. 작업 세션을 요청해 명령을 실행하고, 연결이 끊긴 뒤에는 활성 세션에 다시 들어가세요. 세션 기록을 검토하고 공유가 가능한 플랜에서 팀원과 함께 작업할 때 필요한 안내도 이 섹션에서 찾을 수 있습니다.
- [명령어 실행하기](https://docs.alpacax.com/ko/use/work-sessions/terminal/commands.md): Alpacon Websh 터미널에서 Linux 명령어를 실행합니다. 워크스페이스 규칙에 따라 sudo를 사용할 때 필요한 MFA를 마치고, 실행 기록을 작업 세션에서 확인하세요. 유료 플랜에서는 터미널 녹화를 재생할 수 있으며, 대량 출력이 있을 때의 동작도 확인할 수 있습니다.
- [터미널 접속하기](https://docs.alpacax.com/ko/use/work-sessions/terminal/connect.md): 작업 세션을 요청해 브라우저에서 Websh 터미널을 엽니다. 서버 접근 조건과 접속 계정을 확인한 뒤 터미널을 실행하고 명령을 입력하세요. 연결 후 사용할 수 있는 기능과 화면 표시 설정을 살펴보고, 터미널을 열 수 없을 때는 세션과 서버 연결 상태를 점검할 수 있습니다.
- [세션 관리하기](https://docs.alpacax.com/ko/use/work-sessions/terminal/sessions.md): Websh 터미널은 탭을 닫아도 작업 세션이 활성 상태인 동안 다시 연결할 수 있습니다. 종료 사유를 확인하고, Essentials 이상 플랜에서는 이메일이나 일회용 링크로 세션을 공유하세요. 공유할 때 참여자의 입력 권한과 링크 만료를 정하고 이후 참여자를 관리할 수 있습니다.
- [MFA로 sudo 사용](https://docs.alpacax.com/ko/use/work-sessions/terminal/sudo-with-mfa.md): Websh에서 sudo with MFA를 설정하고 대화형 sudo 명령어를 실행하는 방법을 안내합니다. 승인 요청이 필요한 명령어가 터미널에서 기다리는 동안 표시되는 내용과 승인·거절·시간 초과 후 해야 할 일을 설명합니다. 필요한 버전과 로그인 방식도 미리 확인하세요.
- [PAM 및 sudo 문제](https://docs.alpacax.com/ko/use/work-sessions/terminal/troubleshoot-sudo.md): Alpacon PAM과 sudo 문제를 해결하는 방법을 안내합니다. sudo-rs의 터미널 오류, sudoers 규칙 누락, 명령어 거부 코드를 확인하고 승인 대기가 끝나거나 다른 터미널에서 이미 기다리는 경우의 대응 방법을 알아봅니다. PAM 모듈 버전도 확인하세요.
- [연결 문제](https://docs.alpacax.com/ko/use/work-sessions/troubleshoot-connections.md): 작업 세션에서 서버 연결이 실패하거나 끊겼을 때 원인을 확인하세요. 서버 연결 상태, 계정 권한, 세션의 기능 범위, 네트워크 설정을 순서대로 점검합니다. 문제에 맞는 복구 절차를 따라 다시 연결하고, 세션이 끝난 경우 새 세션을 요청할 때 확인할 사항까지 안내합니다.
- [작업 세션 문제 해결](https://docs.alpacax.com/ko/use/work-sessions/troubleshooting.md): 작업 세션 요청 거부, 승인 대기, 작업 중 만료, CLI 진입 오류, 서버 계정 누락, 연장 실패에 대처하는 방법을 안내합니다. 화면과 CLI에 표시되는 메시지로 원인을 구분하고 필요한 조치를 확인하세요. 승인자에게 문의할 경우와 다른 세션을 요청해야 하는 경우도 설명합니다.
- [포트 포워딩](https://docs.alpacax.com/ko/use/work-sessions/tunnels.md): Alpacon 포트 포워딩으로 로컬 컴퓨터에서 서버의 데이터베이스나 웹 서비스에 접속합니다. 로그인과 작업 세션, 서버 설정에 필요한 조건을 확인하세요. 터널을 직접 닫거나 세션이 끝날 때의 동작, 로컬 명령어에 미치는 영향, 세션 기록에서 확인할 항목과 트래픽 기록 여부를 알아봅니다.
- [터널 열기](https://docs.alpacax.com/ko/use/work-sessions/tunnels/open.md): 승인받은 작업 세션으로 Alpacon 서버에 TCP 터널을 엽니다. 서버 설정과 로그인 방법을 확인하고 로컬 포트를 서버의 서비스 포트에 연결하세요. 터널과 함께 로컬 클라이언트를 실행하거나 CLI가 빈 포트를 선택하게 할 수 있으며, 작업과 세션을 마칠 때의 동작도 알아봅니다.
- [터널 문제 해결](https://docs.alpacax.com/ko/use/work-sessions/tunnels/troubleshooting.md): Alpacon 터널 연결에 실패했을 때 CLI 메시지와 서버 오류 코드에 맞는 조치를 찾습니다. 로그인 방식과 서버 설정, 로컬 및 원격 포트, 작업 세션 상태를 확인하세요. 세션 종료로 터널이 닫힌 경우에는 로컬 명령어의 결과를 살펴보고, 접속 권한과 에이전트 지원 여부를 점검하세요.
- [워크스페이스 개요](https://docs.alpacax.com/ko/use/workspace.md): 워크스페이스에서 서버와 팀원의 접근 권한을 관리합니다. 프로젝트마다 별도 워크스페이스를 두면 구성원과 서버 접근을 구분하고 전용 URL을 사용할 수 있습니다. 새 워크스페이스를 받거나 관리자의 초대를 통해 참여하는 방법, 멤버별 접근과 각종 설정을 바꾸는 경로를 확인하세요.
- [워크스페이스 받기](https://docs.alpacax.com/ko/use/workspace/create.md): 새 워크스페이스는 데모를 신청해 AlpacaX 팀과 이름, URL, 리전을 정하고 준비합니다. 기존 워크스페이스에는 관리자의 초대를 받아 참여하세요. Free 플랜에서는 워크스페이스 한 곳에만 소속될 수 있고, 생성 시 선택한 호스팅 리전은 나중에 변경할 수 없습니다.
- [워크스페이스 삭제하기](https://docs.alpacax.com/ko/use/workspace/delete.md): Alpacon 워크스페이스를 삭제하기 전에 멤버, 연결된 서버, 삭제 권한을 확인하세요. 삭제가 서버의 Alpamon 에이전트와 청구에 미치는 영향을 살펴보고, 오프라인 서버를 처리하는 방법과 삭제 대신 선택할 수 있는 대안도 검토합니다. 삭제는 되돌릴 수 없으므로 확인하세요.
- [유지보수 기간](https://docs.alpacax.com/ko/use/workspace/maintenance-windows.md): 유지보수나 연결 장애 중에는 서버가 정상이어도 Alpacon에서 오프라인으로 보일 수 있습니다. 배너와 서버 상태를 확인하고 어떤 알림이 멈췄다가 언제 다시 시작되는지 살펴보세요. 장애 중 이메일 안내가 오는 조건과 연결이 끊긴 동안 화면에 표시되는 정보도 확인할 수 있습니다.
- [플랜과 결제](https://docs.alpacax.com/ko/use/workspace/plans-billing.md): 콘솔 안에서 플랜을 관리하는 방법을 안내합니다. 결제 메뉴의 세 화면 구성과 한도에 걸렸을 때의 동작, 카드로 업그레이드하는 흐름을 설명합니다. 갱신 결제가 실패했을 때 나타나는 배너와 자동 재시도 일정, 구독을 해지할 때의 정산 방식, 청구서·영수증 다운로드까지 함께 다룹니다.
- [청구서와 결제 내역 확인](https://docs.alpacax.com/ko/use/workspace/plans-billing/history.md): 워크스페이스의 청구서를 찾아 제공되는 문서를 내려받습니다. 결제 영수증과 청구 금액의 세부 내역을 확인하고 크레딧의 잔액과 사용 내역을 살펴봅니다. 각 탭에 표시되는 상태와 문서 링크를 읽는 방법도 안내합니다. 결제 상태에 따라 받을 수 있는 문서와 확인할 항목도 설명합니다.
- [결제 정보 관리](https://docs.alpacax.com/ko/use/workspace/plans-billing/payment.md): 워크스페이스의 결제 수단을 추가하거나 삭제하고 기본 카드를 지정합니다. 청구서에 사용할 수신인 정보와 주소를 확인하고 수정하는 방법을 안내합니다. 업그레이드 결제에 필요한 카드와 국가, 우편번호를 확인할 수 있습니다. 기존 카드와 새 카드를 선택하는 절차도 살펴봅니다.
- [워크스페이스 설정](https://docs.alpacax.com/ko/use/workspace/settings.md): 워크스페이스의 기본 정보와 에이전트 업데이트, AI 데이터 제공, 역할, 확장 기능 설정을 찾습니다. 각 설정을 열거나 변경할 수 있는 권한을 확인합니다. 서버 정책, 개인 설정, 결제 관리로 이동하는 경로도 안내합니다. 필요한 메뉴를 빠르게 찾을 수 있도록 정리합니다.
- [에이전트 업데이트 일정 설정](https://docs.alpacax.com/ko/use/workspace/settings/agent-updates.md): Alpamon 에이전트를 자동으로 업데이트할지 정하고 유지보수 요일과 시간을 설정합니다. 수동 모드로 전환했을 때 예약된 업데이트에 미치는 영향을 확인합니다. 서버별 업그레이드 이력을 열어 결과를 검토하는 방법도 안내합니다. 새 일정과 결과를 확인하는 경로도 안내합니다.
- [AI 개선 데이터 제공 설정](https://docs.alpacax.com/ko/use/workspace/settings/ai-data.md): 워크스페이스의 가명처리한 세션 기록을 Alpacon AI 개선에 제공할지 설정합니다. 설정을 바꿀 수 있는 역할과 기본값을 확인합니다. 수집을 중지한 뒤 기존 기록에 적용되는 보관 기간과 관련 개인정보 안내를 살펴봅니다. 요금제가 바뀐 뒤 이 설정이 유지되는지도 확인합니다.
- [확장 기능 활성화](https://docs.alpacax.com/ko/use/workspace/settings/extensions.md): 요금제에서 사용할 수 있는 확장 기능을 확인하고 워크스페이스에서 켭니다. IP, DNS, Proxy 기능 사이의 의존 관계를 살펴봅니다. 기능을 끌 때 메뉴와 API 접근에 어떤 영향이 있는지 확인하고 필요한 선행 설정을 검토합니다. 요금제에 따라 켤 수 없는 기능도 확인합니다.
- [워크스페이스 기본 설정](https://docs.alpacax.com/ko/use/workspace/settings/general.md): 워크스페이스 이름과 시간대, 언어, 초대 링크 유효 기간을 설정합니다. 세션 유지 시간과 패키지 프록시도 확인하고 필요한 값을 바꾸는 방법을 안내합니다. 각 설정의 범위와 저장 후 적용되는 기본값을 함께 살펴봅니다. 값을 변경할 수 있는 역할과 적용 시점도 함께 확인합니다.
- [역할과 권한 관리](https://docs.alpacax.com/ko/use/workspace/settings/roles.md): 사용자 역할과 그룹이 서버 접근 권한을 정하는 방식을 확인합니다. 서버뿐 아니라 Websh, WebFTP와 같은 기능의 접근을 설정하고 권한 상속과 예외를 살펴보세요. 사용자 지정 역할을 적용할 때는 역할과 그룹의 설정이 함께 접근 범위에 미치는 영향을 검토할 수 있습니다.
- [워크스페이스 전환하기](https://docs.alpacax.com/ko/use/workspace/switch.md): 소속된 워크스페이스 목록에서 이동할 곳을 골라 워크스페이스를 전환합니다. 자주 쓰는 곳을 기본 워크스페이스로 설정하면 로그인할 때 자동으로 이동합니다. 전환 후 현재 활성 워크스페이스를 확인하고, 계정 메뉴에서 로그아웃하는 방법도 이 페이지에서 함께 살펴볼 수 있습니다.