연결 문제

서버 연결 관련 문제 해결 가이드입니다.

서버 상태가 Disconnected로 표시될 때

서버 상태가 Disconnected로 나오는 경우 원인에 따라 아래 시나리오를 순서대로 확인하세요.

1. 서버가 종료 상태인 경우

서버가 꺼져 있으면 Alpacon과 연결을 유지할 수 없습니다.

해결 방법:

  1. 서버 전원 및 부팅 완료 여부 확인
  2. 서버 실행 후 Alpamon 에이전트가 자동으로 재연결할 때까지 잠시 대기
  3. 계속 Disconnected면 에이전트 상태 점검

2. Alpacon과의 네트워크 연결이 끊어진 경우

Alpamon 에이전트는 아웃바운드 HTTPS/WSS로 Alpacon에 연결합니다. 서버의 네트워크에서 이 연결이 막히거나 네트워크가 끊기면 Disconnected로 표시됩니다.

해결 방법:

  1. 서버 아웃바운드 인터넷 접속 확인 (예: curl -I https://alpacon.io 또는 워크스페이스 엔드포인트)
  2. 방화벽·프록시에서 아웃바운드 HTTPS(443) 및 WSS 허용 여부 확인 (네트워크 요구사항 참조)
  3. 프록시 사용 시 서버에 HTTP_PROXY, HTTPS_PROXY 설정
  4. 네트워크·방화벽 수정 후 재연결 대기; 실패 시 에이전트 재시작 또는 CLI 에이전트 재시작

3. 에이전트가 설치되지 않았거나 정상 동작하지 않는 경우

에이전트가 설치되지 않았거나 제거되었거나, 에이전트 프로세스가 동작하지 않으면 서버가 Disconnected로 표시됩니다.

해결 방법:

  1. 서버에서 Alpamon 에이전트 설치·실행 여부 확인 (Linux 예: systemctl status alpamon)
  2. 미설치 시 서버 연결에서 설치 스크립트 또는 안내에 따라 설치
  3. 설치됐으나 미실행 시 에이전트 시작 또는 재시작 (Linux 예: systemctl start alpamon, systemctl restart alpamon). 추가 명령은 서버 등록 참조
  4. 에이전트 관련 상세: 에이전트 문제 참조

Websh 접속이 안 될 때

Console(콘솔) 버튼이 보이지 않거나 비활성화된 경우

Websh 접속은 해당 서버가 Alpacon에 Connected 상태일 때만 가능합니다. Websh 접속을 위한 Console 버튼은 연결된 서버에만 표시됩니다.

해결 방법:

Websh 사용 중 터미널이 종료되는 경우

Websh 사용 도중 터미널이 갑자기 종료될 수 있습니다. Alpacon은 워크스페이스 관리자에게 원격 세션 종료 기능을 제공합니다. Staff 이상 관리자가 보안상 필요하다고 판단하면 사용 중인 Websh 세션을 임의로 종료할 수 있으며, 이 경우 해당 사용자의 터미널이 종료됩니다.

해결 방법:

  • 워크스페이스 관리자로 인한 원격 세션 종료 가능성 확인
  • 서버가 Connected 상태면 서버 목록 또는 Websh 페이지에서 새 Websh 세션 시작