연결 문제

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

서버 상태가 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 상태일 때만 가능합니다. Console 버튼은 연결된 서버에서만 표시됩니다.

해결 방법:

Websh 세션 중 터미널이 닫히는 경우

Websh 사용 중 터미널이 예기치 않게 닫힐 수 있습니다. Alpacon은 워크스페이스 관리자에게 원격 세션 종료 기능을 제공합니다. Staff 이상 관리자가 보안상 필요하다고 판단할 때 사용자의 활성 Websh 세션을 종료할 수 있으며, 이 경우 사용자의 터미널이 닫힙니다.

해결 방법:

  • 워크스페이스 관리자가 세션을 원격으로 종료했는지 확인
  • 서버가 여전히 Connected 상태이면 서버 목록 또는 Websh 페이지에서 새 Websh 세션 시작

Websh 세션 시작에 실패할 때

Websh 세션을 열려고 할 때 오류 메시지가 표시되면, 서버 상태나 계정 설정에 따라 원인이 다릅니다. 아래에서 일반적인 시나리오와 해결 방법을 확인하세요.

서버가 아직 커미션되지 않은 경우

서버가 Alpacon에 등록되었지만 초기 설정이 완료되지 않았습니다.

해결 방법:

  1. 서버 상세 페이지에서 서버 상태가 Not commissioned으로 표시되는지 확인
  2. 서버 설치 단계 완료—서버 연결의 안내를 참조하세요
  3. 서버가 커미션되면 Websh 연결 재시도

서버가 연결되지 않은 경우

서버가 이전에 연결되었지만 현재 오프라인이거나 접근할 수 없는 상태입니다.

해결 방법:

직접 root 접속이 비활성화된 경우

root 사용자로 연결하려 했지만, 워크스페이스 보안 정책에서 직접 root 접속을 허용하지 않습니다.

해결 방법:

  • 워크스페이스 관리자에게 워크스페이스 접근 제어 설정에서 직접 root 접속 허용을 활성화하도록 요청
  • 또는 본인 계정으로 연결한 후 sudo를 사용하여 권한이 필요한 명령어 실행

계정이 존재하지 않거나 권한이 없는 경우

서버에 등록되지 않은 사용자명 또는 그룹으로 연결하려 했거나, 해당 계정을 사용할 권한이 없습니다.

이런 경우에 발생할 수 있습니다:

  • 서버에 계정이 아직 프로비저닝되지 않은 경우
  • 적절한 접근 권한 없이 다른 사용자의 계정으로 접속하려는 경우
  • 소속 그룹이 해당 서버에 할당되지 않은 경우

해결 방법:

  1. 서버 상세 페이지의 Access 탭에서 본인 계정이 목록에 있는지 확인
  2. 계정이 목록에 없으면 워크스페이스 관리자에게 해당 서버에 적절한 그룹을 할당하거나 계정을 프로비저닝하도록 요청
  3. 시스템 계정을 사용하려는 경우 sudo 권한이 있는지 확인—Staff, Superuser 또는 그룹 Manager/Owner만 시스템 계정에 접근 가능

시스템 사용자 UID 충돌

Alpacon 계정의 UID가 서버의 기존 시스템 사용자와 충돌합니다. 이로 인해 Alpacon이 계정을 안전하게 프로비저닝할 수 없습니다.

해결 방법:

  1. 서버 상세 페이지 > Access 탭에서 Conflict 태그가 표시된 계정 확인
  2. 충돌을 해결하려면 워크스페이스 관리자가 다음 중 하나를 수행해야 합니다:
    • 서버에서 충돌하는 시스템 사용자의 UID 변경
    • IAM 사용자 설정에서 Alpacon 계정의 UID 조정
  3. 충돌이 해결된 후 Websh 연결 재시도

시스템 사용자 로그인이 비활성화되었거나 계정이 만료된 경우

서버에 계정이 존재하지만 로그인 접근이 비활성화되었거나 계정 만료일이 지났습니다.

해결 방법:

  1. 워크스페이스 관리자 또는 서버 관리자에게 시스템 사용자 계정이 비활성화되었거나 만료되었는지 확인
  2. 서버에서 직접 계정 상태 확인:
    • 로그인 셸이 유효한 셸로 설정되어 있는지 확인 (/usr/sbin/nologin 또는 /bin/false가 아닌지)
    • 계정 만료일이 지나지 않았는지 확인 (chage -l <username>으로 확인)
  3. 계정이 다시 활성화되거나 만료일이 업데이트된 후 Websh 연결 재시도