자주 묻는 질문

Alpacon을 사용하면서 자주 묻는 질문의 답을 찾아보세요.

일반

Alpacon이란 무엇인가요?

Alpacon은 기존 SSH 키 관리를 안전한 브라우저 기반 접근으로 대체하는 제로 트러스트 서버 접근 플랫폼입니다. AI 에이전트, 엔지니어, CI/CD 파이프라인이 프로덕션 인프라에서 작업할 때 명령 실행 권한을 확인하고 작업 중 중요한 결정을 다시 평가하며, 나중에 검토할 수 있도록 활동을 기록합니다.

Alpacon은 SSH와 어떻게 다른가요?

SSH는 서버 전반의 키 관리가 필요하며 로그인 이후 실행되는 작업에 대한 감사를 제공하지 않습니다. Alpacon은 웹 대시보드를 통한 중앙화된 접근, 영구 키 대신 시간 제한 토큰, 명령 기록과 사용자별 작업 내역을 제공하며, Alpacon 접속을 위해 SSH 인바운드 포트를 열 필요가 없습니다.

Alpacon이 VPN을 대체할 수 있나요?

네, Alpacon은 서버 접근용 VPN을 대체할 수 있습니다. VPN은 네트워크 수준의 접근을 제공하지만, Alpacon은 명령 수준의 신원·정책·감사가 적용된 애플리케이션 수준의 접근을 제공합니다.

Alpacon은 어떤 플랫폼을 지원하나요?

Alpacon은 Linux(Ubuntu 18.04 이상, Debian 11 이상, RHEL·Rocky·AlmaLinux 8 이상, Oracle Linux 8 이상, Amazon Linux 2와 2023, Fedora, Raspberry Pi OS (64-bit), openSUSE Leap 15 이상, SLES 15 이상은 제한적으로 지원), Windows Server 2019/2022/2025, Windows 10 1803 이상, Windows 11, macOS 11 이상을 지원합니다. 웹 인터페이스는 Chrome 90+, Firefox 88+, Safari 14+, Edge 90+에서 사용할 수 있습니다.

보안

Alpacon은 안전한가요?

등록된 서버에서 아웃바운드 연결을 시작하므로 Alpacon 접속을 위해 SSH 인바운드 포트를 열 필요가 없습니다. 워크스페이스와 필요한 다운로드 목적지로 HTTPS 연결을 허용하세요. 연결에는 TLS가 적용되며 접근할 때 MFA나 승인이 필요할 수 있습니다.

Alpacon은 어떤 보안 표준을 따르나요?

Alpacon은 제로 트러스트 원칙에 따라 접근을 확인하고 연결에 TLS를 적용하며, 이후 검토할 수 있도록 활동을 기록합니다. 호스팅 리전은 US1(미국)과 AP1(아시아 태평양)을 운영하며, 워크스페이스를 만들 때 리전을 선택합니다. 독립 보안 기관이 정기적으로 침투 테스트를 진행하며, 가장 최근 테스트는 2026년 2분기에 완료됐습니다. SOC 2 Type 2 감사 준비가 진행 중이며 현재 내부 감사 단계입니다.

Alpacon은 어떻게 인증을 처리하나요?

Alpacon은 로그인하거나 민감한 작업을 수행할 때 MFA를 요청할 수 있습니다. Google Workspace로 로그인할 수 있고, Enterprise 워크스페이스는 Okta Integration Network를 통해 Okta를 연동할 수 있습니다. MFA에는 OTP 앱, 생체 인증, 하드웨어 보안 키를 사용할 수 있습니다. 세션 활동은 나중에 검토할 수 있도록 기록됩니다.

SSO 제공자와 통합할 수 있나요?

Google Workspace 로그인은 모든 플랜에서 사용할 수 있고, Enterprise 워크스페이스는 Okta를 Okta Integration Network로 연동하거나, 온보딩 과정에서 AlpacaX 팀과 함께 SAML IdP를 연동할 수 있습니다. 다른 IdP는 support@alpacax.com으로 문의해 주세요.

기술

역방향 연결은 어떻게 작동하나요?

등록된 서버의 에이전트가 Alpacon으로 아웃바운드 연결을 시작합니다. 서버가 NAT 뒤에 있어도 Alpacon 접속을 위해 SSH 인바운드 포트를 열 필요는 없습니다. 워크스페이스로 아웃바운드 HTTPS 연결을 허용하세요.

Alpacon은 어떤 포트를 사용하나요?

Alpacon은 아웃바운드 HTTPS(포트 443)만 필요합니다. 인바운드 포트를 열 필요가 없어 공격 표면이 크게 줄어듭니다.

Alpacon은 루트/관리자 접근이 필요한가요?

Alpacon 에이전트(alpamon)는 사용자 세션 관리, 접근 제어 적용, 감사 로그 수집, 다른 사용자로 명령 실행을 위해 루트/관리자 권한이 필요합니다. 최종 사용자는 정책으로 명시적으로 부여된 경우가 아니라면 루트 접근이 필요하지 않습니다.

Alpacon 에이전트를 어떻게 설치하나요?

서버 → 서버 등록으로 이동하여 서버 정보를 입력하고, 생성된 설치 스크립트를 복사해 서버에서 실행하세요. 스크립트가 OS를 자동으로 감지하여 적합한 에이전트를 설치합니다.

자세한 지침과 수동 설치 옵션은 설치 가이드를 참조하세요.

Alpacon을 파일 전송에 사용할 수 있나요?

네. Alpacon은 업로드/다운로드, 드래그 앤 드롭, 서버 간 전송, 자동화를 위한 CLI 사용을 지원하는 브라우저 기반 파일 관리자 WebFTP를 포함합니다.

서버를 복수의 워크스페이스에 동시에 등록해서 사용할 수 있나요?

아니요. 서버는 한 번에 하나의 워크스페이스에만 등록할 수 있습니다. 다른 워크스페이스로 이동하려면 기존 워크스페이스에서 먼저 연결을 해제한 후 새로 등록하세요.

운영

긴급 접근을 어떻게 처리하나요?

서비스 토큰의 브레이크 글래스 긴급 접근은 지정한 시간 동안 그 토큰의 IP 제한과 시간 제한만 해제합니다. 사용량 제한과 접근 제어 규칙은 그대로 적용되고, 슈퍼유저가 사유를 남겨야 하며, 활성화와 해제가 모두 기록됩니다. 평소의 프로그래밍 방식 접근에는 API 토큰을 사용합니다.

자세한 내용은 긴급 접근 절차를 참조하세요.

Alpacon이 다운되면 어떻게 되나요?

Alpacon은 가동 시간 SLA를 제공하지 않습니다. 플랫폼에 장애가 나도 서버 자체는 계속 실행됩니다. 서비스가 복구되면 에이전트가 다시 연결합니다. 이미 열려 있는 터미널 세션은 대부분 유지되고, 새 세션, API로 제출한 명령, sudo 권한 상승과 승인처럼 Alpacon의 판단이 필요한 일은 복구 뒤에 처리됩니다. 직접 SSH나 클라우드 콘솔을 따로 두었다면 그 경로를 통해 서버에 계속 접근할 수 있습니다. 실시간 서비스 상태와 과거 이력은 status.alpacax.com에서 확인할 수 있습니다.

소프트웨어 업데이트는 어떻게 처리되나요?

AlpacaX가 플랫폼 업데이트를 관리합니다. 에이전트는 자동 업데이트(권장) 또는 콘솔이나 CLI에서 하는 수동 업그레이드를 지원합니다. Alpamon 2.4.0 미만 Windows 에이전트는 스스로 업데이트하지 못하므로 바이너리를 한 번 직접 교체해야 합니다. 방법은 에이전트 업그레이드를 참고하세요. 업그레이드하면 에이전트가 다시 시작되므로, 서버에 열린 Websh나 WebFTP 세션 또는 실행 중인 명령이 있으면 기다립니다. 자동 업그레이드는 그 작업이 끝나거나 48시간이 지나면 진행되고, 수동 업그레이드는 강제로 실행하지 않는 한 거부됩니다. 강제로 실행하면 에이전트가 바로 다시 시작되고 열린 세션이 끊깁니다. 터널이나 코드 편집기 세션이 열려 있어도 업그레이드는 미뤄지지 않으므로, 에이전트가 다시 시작하면 연결이 끊깁니다.

Alpacon을 자체 호스팅할 수 있나요?

네. Alpacon Enterprise는 에어갭 환경, 데이터 주권 요구사항, 맞춤 통합 필요성이 있는 기업을 위한 자체 호스팅 배포를 지원합니다. 자세한 내용은 sales@alpacax.com으로 문의하세요.

통합

Alpacon이 CI/CD 파이프라인과 작동하나요?

네. Alpacon은 세밀한 토큰 인증 기반의 REST API와 CLI를 제공합니다. 공식 통합은 GitHub Actions이며, alpacon-setup-action, alpacon-common-action, alpacon-cp-action, alpacon-websh-action 네 가지 액션을 공개합니다. GitLab CI, Jenkins 등 다른 CI 도구는 범위를 제한한 서비스 토큰으로 CLI와 REST API를 호출해 Alpacon을 다룹니다.

예제는 통합 가이드를 참조하세요.

구성 관리 도구와 Alpacon을 사용할 수 있나요?

네. Alpacon의 REST API를 통해 구성 관리 도구와 통합하여 자동화된 워크플로우 내에서 명령을 실행할 수 있습니다.

Alpacon을 통해 서버를 어떻게 모니터링하나요?

Alpacon은 서버별 지표를 수집해 콘솔에서 보여주고, 메트릭 알림으로 Slack, Discord, Microsoft Teams, Telegram, 커스텀 HTTP 엔드포인트에 웹훅 알림을 보냅니다. Prometheus, CloudWatch, Datadog 익스포터는 제공하지 않습니다.

문제 해결

에이전트가 워크스페이스에 연결되지 않습니다

아웃바운드 HTTPS(포트 443)가 허용되어 있는지, 시스템 시간이 동기화되어 있는지, 등록 토큰이 유효하고 만료되지 않았는지, DNS 확인이 정상 작동하는지 확인하세요. 자세한 단계는 docs.alpacax.com의 연결 문제 해결 가이드를 참조하세요.

자세한 단계는 연결 문제 해결을 참조하세요.

”권한 거부” 오류

사용자에게 적절한 역할(사용자/스태프/슈퍼유저)이 있는지, 명령 ACL이 해당 작업을 허용하는지, 대상 서버가 허용된 그룹 내에 있는지, 세션이 만료되지 않았는지 확인하세요.

느린 연결 또는 지연

주요 원인으로는 위치와 Alpacon 릴레이 간의 네트워크 지연, 서버 리소스 제약, 브라우저 성능 문제, 프록시/방화벽 딥 패킷 검사가 있습니다. alpacon.io에 핑을 보내 기본 지연 시간을 확인해 보세요.

지원을 받으려면 어떻게 해야 하나요?

문서는 docs.alpacax.com에서 확인하세요. 커뮤니티 지원은 Discord(discord.gg/wadWh8VsYB)에서 받을 수 있습니다. 직접 지원은 support@alpacax.com으로 이메일을 보내세요.

마이그레이션

마이그레이션에 얼마나 걸리나요?

일반적인 소요 시간: 소규모 팀(서버 10대 미만) 1–2일, 중규모 팀(10–100대) 1–2주, 대규모 팀(100대 이상) 2–4주.

자세한 계획은 마이그레이션 가이드를 참조하세요.

SSH와 Alpacon을 병렬로 실행할 수 있나요?

네, 권장 방식입니다. SSH와 함께 Alpacon 에이전트를 설치하고, Alpacon을 통해 모든 워크플로우를 테스트한 후, 사용자를 단계적으로 마이그레이션하고, Alpacon 접근이 정상 작동함을 확인한 후 SSH를 비활성화하세요.

마이그레이션이 다운타임을 발생시키나요?

아니요. 에이전트 설치 및 등록은 서비스 재시작, 구성 변경, 다운타임이 필요 없습니다. 실행 중인 서비스는 마이그레이션 중에도 영향을 받지 않습니다.

더 궁금한 점이 있으신가요?

찾고 계신 내용을 찾을 수 없나요?

최종 수정: