터널 문제 해결

작업 세션이 활성 상태이며 대상 서버와 포트 포워딩 기능을 포함하는지 확인하세요. 토큰으로는 터널을 열 수 없습니다. -t 없이 alpacon login으로 로그인하세요.

CLI 메시지

아래 메시지에서 <v>는 입력한 포트이며, …는 운영체제나 연결 오류의 상세 내용입니다.

메시지	의미와 조치
`a token cannot open a tunnel; run 'alpacon login' without -t (on a machine without a browser, open the printed URL on another device) and try again`	`-t` 없이 로그인한 뒤 활성 세션을 연결하고 재시도
`invalid remote port: port must be between 1 and 65535`	`-r`에 해당 범위의 포트 지정
`invalid local port: port "<v>" is not a number`	로컬 포트를 숫자로 지정하거나 `-l 0`으로 빈 포트 선택
`failed to listen on local port: …`	상세 오류 확인. 포트가 사용 중이면 다른 포트나 `-l 0` 사용
`failed to establish tunnel connection: …`	상세 오류와 서버 연결을 확인한 뒤 재시도
`Error: tunnel connection lost: session closed by remote`	작업 세션의 완료, 만료, 철회 여부 확인. 활성 세션으로 다시 연결
`Warning: Tunnel closed: session closed by remote`	`-- COMMAND`로 실행한 터널이 닫혀 로컬 명령어가 중단됨. 명령어의 결과를 확인한 뒤 재시도

CLI의 터널 생성 오류에는 request failed (code: X)가 포함될 수 있습니다. 아래에서 X에 해당하는 코드를 찾으세요. 따옴표 안은 콘솔의 오류 메시지입니다. 마지막 두 행은 코드 에디터 세션에 적용됩니다.

코드	의미	조치
`tunnel_not_enabled`#	"이 서버에서는 터널이 활성화되어 있지 않아요." 서버의 터널 설정이 꺼져 있습니다.	관리자에게 서버의 터널 설정을 켜 달라고 요청하세요.
`tunnel_requirements_not_met`#	"터널 기능을 사용하려면 에이전트 버전 2.0.0 이상이 필요해요. 에이전트를 먼저 업그레이드해 주세요." 지원하지 않는 에이전트에서 터널 설정을 켤 때 표시됩니다.	관리자에게 Alpamon 업그레이드를 요청한 뒤 터널 설정을 켜세요.
`tunnel_invalid_port`#	"포트는 1에서 65535 사이여야 해요."	`-r`에 1~65535 범위의 포트를 지정하세요.
`tunnel_multiple_clients_not_allowed`#	"터널당 클라이언트는 하나만 사용할 수 있어요."	클라이언트마다 별도의 터널을 여세요.
`tunnel_multiple_agents_not_allowed`#	"터널당 에이전트는 하나만 사용할 수 있어요."	별도의 터널을 여세요.
`tunnel_session_closed`#	"이미 종료된 세션이에요. 코드 에디터를 다시 열어 주세요." 닫힌 에디터 세션에 다시 연결할 때 표시됩니다.	작업 세션에서 코드 에디터를 다시 여세요.
`tunnel_not_editor`#	"코드 에디터 세션에서만 사용할 수 있는 기능이에요."	코드 에디터 세션에서만 해당 기능을 쓰세요.

서버의 터널 설정 위치는 서버 설정을 참고하세요. 세션 접근이 거부되면 작업 세션 게이트 에러를 확인하세요.