---
title: "터널 문제 해결"
description: "Alpacon 터널 연결에 실패했을 때 CLI 메시지와 서버 오류 코드에 맞는 조치를 찾습니다. 로그인 방식과 서버 설정, 로컬 및 원격 포트, 작업 세션 상태를 확인하세요. 세션 종료로 터널이 닫힌 경우에는 로컬 명령어의 결과를 살펴보고, 접속 권한과 에이전트 지원 여부를 점검하세요."
---

> Full documentation index: https://docs.alpacax.com/llms.ko.txt

# 터널 문제 해결

작업 세션이 활성 상태이며 대상 서버와 포트 포워딩 기능을 포함하는지 확인하세요. 토큰으로는 터널을 열 수 없습니다. `-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`에 해당하는 코드를 찾으세요. 따옴표 안은 콘솔의 오류 메시지입니다. 마지막 두 행은 코드 에디터 세션에 적용됩니다.

서버의 터널 설정 위치는 [서버 설정](/use/servers/manage/#터널과-코드-에디터)을 참고하세요. 세션 접근이 거부되면 [작업 세션 게이트 에러](/reference/cli/work-session/#게이트-에러)를 확인하세요.

Source: https://docs.alpacax.com/ko/use/work-sessions/tunnels/troubleshooting/