---
title: "포트 포워딩"
description: "Alpacon 포트 포워딩으로 로컬 컴퓨터에서 서버의 데이터베이스나 웹 서비스에 접속합니다. 로그인과 작업 세션, 서버 설정에 필요한 조건을 확인하세요. 터널을 직접 닫거나 세션이 끝날 때의 동작, 로컬 명령어에 미치는 영향, 세션 기록에서 확인할 항목과 트래픽 기록 여부를 알아봅니다."
---

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

# 포트 포워딩

포트 포워딩으로 로컬 TCP 포트에서 서버의 서비스에 접속합니다.

## 서비스 접속 조건

포트 포워딩은 로컬 TCP 포트를 서버의 데이터베이스나 웹 애플리케이션 같은 서비스에 연결합니다. 서비스는 서버의 `127.0.0.1`에서 접속할 수 있어야 합니다. `::1`에서만 연결을 받는 서비스에는 접속할 수 없습니다. [터널 열기](/use/work-sessions/tunnels/open/)에 따라 연결하세요.

## 터널에 필요한 조건

- 관리자가 서버의 **터널** 설정을 활성화해야 합니다. [서버 설정](/use/servers/manage/#터널과-코드-에디터)을 참고하세요.
- 활성 작업 세션에 대상 서버와 **포트 포워딩** 기능(`tunnel`)이 포함되어 있어야 합니다.
- `-t` 없이 `alpacon login`으로 로그인하세요. 서비스 토큰과 개인 API 토큰으로는 터널을 열 수 없습니다.
- 서버가 터널을 지원해야 합니다. 설정을 켤 때 에이전트 요구 사항 오류가 나오면 관리자에게 Alpamon 업그레이드를 요청하세요. 플랫폼별 요구 사항은 [CLI 참조](/reference/cli/tunnel/)를 참고하세요.

## 터널 종료

터널만 실행했다면 Ctrl+C로 닫으세요. [터널과 함께 로컬 명령어를 실행](/use/work-sessions/tunnels/open/#터널과-함께-로컬-명령어-실행)했다면 그 명령어가 끝날 때 터널도 닫힙니다.

작업 세션을 완료하거나, 세션이 만료되거나 철회되면 터널도 종료됩니다. 터널만 실행한 CLI는 `Error: tunnel connection lost: session closed by remote`를 출력하고 종료 코드 1로 끝납니다. 다시 연결하려면 승인받은 다른 세션을 시작하세요.

`-- COMMAND`를 쓴 경우에는 CLI가 `Warning: Tunnel closed: session closed by remote`를 출력하고 로컬 명령어를 중단시킵니다. 재시도 전에 로컬 명령어의 결과를 확인하세요.

## 기록되는 내용

터널은 트래픽을 전달하지만 기록하지는 않습니다. 실시간 활동의 **터널에는 녹화가 없어요** 안내에서 이 제한을 확인할 수 있습니다. 세션 기록에는 누가 터널을 열었는지, 언제 닫혔는지와 함께 계정, 포트, 클라이언트 종류가 남습니다.

[실시간 활동](/use/live-activity/)에서 **포트 포워딩 시작** 및 **포트 포워딩 종료** 항목을 확인하세요. 터널을 열거나 연결을 유지하는 데 실패하면 [문제 해결](/use/work-sessions/tunnels/troubleshooting/)을 참고하세요.

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