본문으로 건너뛰기
Localtonet Localtonet 대시보드

터널 설정 참조

이 페이지 도움받기
이 페이지의 내용 섹션 15개
  1. 터널 설정 열기
  2. 터널 유형 페이지 열기
  3. 터널 행에서 설정 선택
  4. 설정 변경
  5. 변경 사항이 적용되는 방식
  6. 터널 유형별 설정
  7. 각 설정의 기능
  8. 터널 상세
  9. 터널 메모
  10. SslStream 사용
  11. PROXY 프로토콜
  12. 레거시 연결
  13. 로컬 서버 IP
  14. 터널 IP
  15. 터널 목록의 설정
  16. 서버 변경
  17. AuthToken 변경
  18. 웹 애플리케이션 방화벽
  19. API로 같은 설정 사용하기
  20. 문제 해결
  21. 관련 페이지

모든 터널에는 대시보드에 설정 패널이 있습니다. 이 페이지에서는 설정 패널을 여는 위치, 각 설정의 목록, 설정을 지원하는 터널 유형, 그리고 자세한 설명이 있는 페이지를 안내합니다.

터널 설정 열기 #

  1. 터널 유형 페이지 열기 #

    대시보드 메뉴에서 내 터널을 열고 유형을 선택합니다. 내 터널 › HTTP, TCP - UDP, TLS, 파일 서버, 프록시 서버, 로테이팅 프록시, MCP 게이트웨이 중에서 선택할 수 있습니다.

  2. 터널 행에서 설정 선택 #

    내 터널 목록에서 해당 터널을 찾아 작업 열의 설정을 선택합니다. 페이지 옆쪽에 터널 설정 패널이 열립니다.

  3. 설정 변경 #

    패널은 다음 부분으로 구성됩니다.

    • 터널 상세: 터널 주소, 생성일, AuthToken 이름 등의 상세 정보와, 값을 선택하여 편집할 수 있는 항목입니다. 모든 터널 유형에서 제목을 편집할 수 있고, HTTP, TCP - UDP, TLS 터널에서는 로컬 주소와 로컬 포트도 편집할 수 있습니다.
    • 로드 밸런싱 대상을 지원하는 터널 유형에서 표시되는 터널의 로드 밸런싱 대상입니다. 로드 밸런싱을 참고하세요.
    • SSH 명령어 보기: 일반 SSH로 시작할 수 있는 터널 유형에 표시됩니다. 설치 없는 SSH를 참고하세요.
    • 설정: 설정마다 한 행씩 표시됩니다. 각 행에는 예 / 아니요 스위치가 있거나, 대화상자를 여는 버튼(관리, 변경, 표시 또는 지우기)이 있습니다. 라벨 옆의 정보 아이콘은 해당 설정을 한 문장으로 설명합니다.

    대부분의 스위치는 변경하기 전에 확인을 요청합니다. 예를 들어 HTTPS 전용을 켤까요?라는 질문과 함께 켜기 및 취소 버튼이 표시됩니다. Basic 인증이나 경로 재작성을 켜면 대신 대화상자가 열리며, 실행 중인 터널에서 포트 예약을 켜면 확인 없이 바로 포트가 예약됩니다.

변경 사항이 적용되는 방식 #

일부 설정은 실행 중인 터널에 중단 없이 적용됩니다. 그 밖의 설정은 터널을 중지한 뒤 새 값으로 다시 시작하며, 이 과정에서 잠시 시간이 걸리고 열려 있는 연결이 끊어집니다.

재시작 없이 적용실행 중인 터널을 재시작
HTTPS 전용, 경로 재작성, HTTP/3 활성화, 포트 예약, 헤더, HTTP 타임아웃, 터널 메모, IP 제한, 만료일, 아웃바운드 포트, 대역폭 제한, 대역폭 사용량, WAF 스위치 터널 상세의 제목, 로컬 주소, 로컬 포트, Basic 인증, SslStream 사용, PROXY 프로토콜, 레거시 연결, 서버 포트, 인수, 로컬 서버 IP, 속도 제한, 서버 변경, AuthToken 변경

터널을 재시작하는 설정은 실행 중인 터널에서 해당 기기의 Localtonet 앱이 연결되어 있을 때만 저장할 수 있습니다. 연결되어 있지 않으면 대시보드가 "기기 연결을 확인하세요."라는 메시지를 표시하고 기존 값을 유지합니다. 중지된 터널에서는 값이 저장되며 다음 시작 때 사용됩니다.

터널 유형별 설정 #

라벨은 설정 섹션에 표시되는 것과 같습니다. "예"는 해당 터널 유형에 그 행이 있다는 뜻입니다.

설정HTTPTCP - UDPTLS파일 서버프록시 서버로테이팅 프록시MCP 게이트웨이
HTTPS 전용예–––––예
경로 재작성예––––––
Basic 인증예––예, Default 유형––예
SslStream 사용예예, UDP 제외예––––
HTTP/3 활성화예–––––예
포트 예약–예––예예–
PROXY 프로토콜–예, UDP 제외–––––
레거시 연결예예예예예–예
SSL 모드––예––––
SSO 제공자예, 팀 터널 제외––––––
게이트웨이 토큰––––––예
헤더예––––––
HTTP 타임아웃예–––––예
서버 포트–예––예, VLESS 제외예–
터널 메모예예예예예예예
로컬 서버 IP로컬 서버만로컬 서버만로컬 서버만–로컬 서버만–로컬 서버만
인수예예예–예––
IP 제한예예예예예예예
만료일예예예예예–예
속도 제한예예예예예–예
아웃바운드 포트예예예예예예예
대역폭 제한예예예예예–예
대역폭 트래픽예예예예예예예
대역폭 사용량예예예예예–예
터널 IP–예예–예예–
요청 로그예예예예예–예
활동 로그예예예예예예예
터널 상태 점검예예예–예예예

프록시 서버와 로테이팅 프록시 페이지에는 프록시 인증, 접근 제어, 업스트림 설정, VPN 액세스, 속도 테스트, 터널 토큰, IPv4 전용처럼 해당 페이지에만 있는 행이 더 있습니다. 자세한 내용은 프록시 서버와 로테이팅 프록시에 설명되어 있습니다. 로컬 서버를 사용하는 터널에는 아웃바운드 포트 행이 없습니다. "로컬 서버만"에는 서버 열에 VPN이 표시되는 터널도 포함됩니다.

각 설정의 기능 #

설정기능상세
HTTPS 전용공개 URL을 HTTPS로만 제공합니다.헤더 및 재작성
경로 재작성모든 요청이 로컬 서비스에 도달하기 전에 요청 앞에 경로를 추가합니다.헤더 및 재작성
Basic 인증방문자에게 사용자 이름과 비밀번호를 요구합니다.접근 제어
SslStream 사용로컬 서비스 자체가 HTTPS 또는 TLS를 사용한다는 것을 터널에 알려 줍니다.이 페이지
HTTP/3 활성화클라이언트가 HTTP/3로 공개 URL에 접속할 수 있게 합니다.헤더 및 재작성
포트 예약터널을 재시작해도 같은 서버 포트를 유지합니다.포트
PROXY 프로토콜원래 클라이언트 주소를 PROXY 프로토콜 헤더에 담아 서비스로 전달합니다.이 페이지
레거시 연결터널이 일반 방식으로 연결되지 않을 때 시도할 수 있는 대체 연결 방식입니다.이 페이지
SSL 모드TLS 터널에서 Localtonet이 HTTPS를 처리할지, 암호화된 트래픽을 그대로 서비스로 전달할지 선택합니다.TLS
SSO 제공자방문자가 터널을 열기 전에 등록해 둔 ID 제공자 중 하나로 로그인하도록 합니다.통합 인증(SSO)
게이트웨이 토큰MCP 클라이언트가 게이트웨이에 연결할 때 보내는 토큰을 표시합니다.MCP 게이트웨이
헤더고정된 요청 및 응답 헤더를 추가합니다.헤더 및 재작성
HTTP 타임아웃터널이 서비스의 응답을 기다리는 시간을 설정합니다.헤더 및 재작성
서버 포트사용자가 Localtonet 서버에서 접속하는 포트를 변경합니다.포트
터널 메모터널의 용도를 기억하기 위한 비공개 메모입니다.이 페이지
로컬 서버 IP로컬 서버에 접근할 수 있는 주소입니다.이 페이지
인수터널을 기기의 특정 네트워크로 보냅니다.네트워크 선택
IP 제한터널에 연결할 수 있는 IP 주소를 선택합니다.접근 제어
만료일정해진 날짜에 터널을 중지합니다.제한 및 만료
속도 제한업로드 및 다운로드 속도에 상한을 둡니다.제한 및 만료
아웃바운드 포트엄격한 방화벽 환경을 위해 Localtonet 앱이 외부로 연결하는 포트를 고정합니다.포트
대역폭 제한터널이 정해진 양의 데이터를 전송하면 터널을 중지합니다.제한 및 만료
대역폭 트래픽터널을 통과한 데이터를 차트로 보여 줍니다.제한 및 만료
대역폭 사용량터널의 데이터 카운터를 0으로 초기화합니다.제한 및 만료
터널 IP터널이 실행되는 서버의 IP 주소를 표시합니다.이 페이지
요청 로그터널에 기록된 요청 또는 연결을 표시합니다.로그 및 검사
활동 로그시작, 중지, 설정 변경 내역을 나열합니다.로그 및 검사
터널 상태 점검정기 상태 점검 결과를 표시합니다.로그 및 검사

터널 상세 #

터널 상세에서 값을 선택하면 편집할 수 있습니다. 세 항목 중 무엇을 저장하든 실행 중인 터널이 재시작됩니다. 로컬 주소와 로컬 포트는 HTTP, TCP - UDP, TLS 터널에서 편집할 수 있으며, 다른 터널 유형에는 제목만 표시됩니다.

대화상자입력할 내용규칙
터널 이름 변경터널 목록에서 알아볼 수 있는 이름입니다. 예: "Office NAS".필수 항목입니다. 최대 30자입니다. 대화상자는 100자까지 세지만, 30자를 넘는 제목은 "제목은 30자를 초과할 수 없습니다."라는 메시지와 함께 거부됩니다.
로컬 주소Localtonet 앱이 서비스를 찾는 위치입니다. 서비스가 앱과 같은 기기에서 실행되면 127.0.0.1을 사용하세요. 네트워크의 다른 기기에 연결하려면 해당 기기의 주소를 입력하세요. 예: 192.168.1.20.IPv4 주소, IPv6 주소 또는 호스트 이름입니다. http://, 경로, 포트는 넣지 않습니다.
로컬 포트서비스가 실행되는 기기에서 서비스가 수신 대기하는 포트입니다.1에서 65535 사이의 숫자입니다.

터널 메모 #

터널 메모 › 관리를 선택하면 메모 대화상자가 열립니다. 메모는 터널의 용도를 기억하기 위한 것이며, 내 계정에서만 볼 수 있습니다.

  • 메모는 최대 499자까지 쓸 수 있습니다. 입력하는 동안 대화상자가 글자 수를 세어 줍니다.
  • 라벨 아래의 선택지는 메모 앞에 라벨을 붙입니다. 프로덕션, 스테이징, 테스트, 데모, 임시 중에서 고를 수 있습니다. 그러면 메모가 예를 들어 Staging - 으로 시작합니다. 다른 라벨을 선택하면 기존 라벨이 교체됩니다.

SslStream 사용 #

로컬 서비스 자체가 HTTPS 또는 TLS를 사용하는 경우(예: https://localhost에서만 수신 대기하는 개발 서버) SslStream 사용을 켜세요. 일반 HTTP나 일반 TCP를 사용하는 서비스에서는 꺼 두세요. HTTP, TCP, TLS 터널에는 이 스위치가 있으며, UDP 터널에는 없습니다.

PROXY 프로토콜 #

PROXY 프로토콜을 켜면 터널이 원래 클라이언트 주소를 PROXY 프로토콜 헤더에 담아 서비스로 전달합니다. 서비스가 해당 헤더를 읽도록 설정되어 있을 때만 켜세요. 헤더를 예상하지 않는 서비스는 모든 연결의 시작 부분에서 알 수 없는 바이트를 받게 됩니다. TCP 터널에는 이 스위치가 있으며, UDP 터널에는 없습니다.

레거시 연결 #

레거시 연결은 터널을 대체 연결 방식으로 전환합니다. 터널이 일반 방식으로 연결되지 않을 때 사용해 보고, 도움이 되지 않으면 다시 끄세요.

로컬 서버 IP #

이 행은 서버 열에 로컬 또는 VPN이 표시되는 터널에서만 나타납니다. 로컬 서버 IP 대화상자에는 로컬 서버에 접근할 수 있는 주소가 들어 있습니다. IPv4 주소와, 선택 사항으로 IPv6 주소를 입력합니다. IPv6를 사용하지 않으면 비워 두세요. 주소는 하나 이상 필요합니다. 127.0.0.1, 0.0.0.0, ::1처럼 기기 자체에서만 동작하는 주소는 "로컬 서버 IP는 외부에서 접근할 수 있어야 합니다."라는 메시지와 함께 거부됩니다.

터널 IP #

터널 IP › 표시를 선택하면 터널이 실행되는 서버의 IPv4 주소와, 서버에 IPv6 주소가 있는 경우 IPv6 주소를 보여 주는 서버 IP 대화상자가 열립니다. 클라이언트는 도메인 이름 대신 이 주소로 터널에 연결할 수 있습니다.

서버 IP 주소는 바뀔 수 있습니다. 앱과 스크립트에서는 가능하면 도메인 이름을 사용하세요.

터널 목록의 설정 #

두 가지 설정은 패널이 아니라 터널 목록에서 변경합니다.

서버 변경 #

서버 열의 서버 코드를 선택하고, 서버 변경 대화상자에서 다른 서버를 고른 뒤 제출을 선택합니다. 실행 중인 터널은 새 서버에서 다시 시작됩니다.

  • 서버를 변경하려면 잔액이 필요합니다. 잔액이 없으면 대시보드에 "이 기능을 사용하려면 잔액을 구매해야 합니다."라는 메시지가 표시됩니다.
  • 새 서버에서 터널의 서버 포트가 이미 사용 중이면 "선택한 서버에서는 터널의 포트(PORT)를 사용할 수 없습니다. 먼저 포트를 변경하세요."라는 메시지가 표시됩니다. 포트에 설명된 대로 포트를 변경한 다음 다시 시도하세요.
  • 서버 열에 로컬 또는 VPN이 표시되는 터널은 이동할 수 없습니다.

서버를 변경하면 DNS 업데이트에 최대 3시간이 걸릴 수 있습니다.

AuthToken 변경 #

AuthToken 열의 토큰 이름을 선택하여 AuthToken 변경을 열고, 다른 AuthToken을 고른 뒤 제출을 선택합니다. 그러면 터널이 해당 토큰으로 Localtonet 앱을 실행 중인 기기로 이동합니다.

  • 실행 중인 터널은 중지된 뒤 2초를 기다렸다가 선택한 AuthToken으로 다시 시작됩니다. 중지된 터널은 중지된 상태로 유지됩니다.
  • 새 토큰을 사용하는 앱이 연결되어 있지 않아도 토큰은 변경되며, "AuthToken은 업데이트되었지만 터널을 재시작할 수 없습니다. 선택한 토큰으로 Localtonet 앱을 연결하고 터널을 시작하세요."라는 메시지가 표시됩니다.
  • 로테이팅 프록시 터널은 AuthToken 그룹을 사용합니다. 대신 그룹을 변경하세요.

AuthToken에 대한 설명은 AuthToken에 있습니다.

웹 애플리케이션 방화벽 #

HTTP 및 MCP 게이트웨이 터널에는 작업 열에 방패 버튼도 있습니다. 이 버튼은 터널의 방화벽을 엽니다. 웹 애플리케이션 방화벽을 참고하세요.

API로 같은 설정 사용하기 #

대부분의 설정은 터널 경로 아래의 API로도 조회하고 변경할 수 있습니다. 인증 방법과 전체 레퍼런스는 API에 있습니다.

설정/api/v2/tunnels/<TUNNEL_ID>/ 뒤의 경로
IP 제한ip-restrictions
헤더headers, host-header
Basic 인증authentication
만료일expiration
서버 포트server-port
HTTP 타임아웃http-timeout
속도 제한rate-limit
대역폭 제한 및 사용량bandwidth-limit, bandwidth-usage, bandwidth-usage/reset
인수arguments
HTTPS 전용, HTTP/3 활성화, 경로 재작성https-only, http3, path-rewrite
SslStream 사용, PROXY 프로토콜, SSL 모드ssl-stream, proxy-protocol, pass-through
터널 메모note
서버server

문제 해결 #

"기기 연결을 확인하세요."

설정이 터널을 재시작해야 하는데 터널 기기의 Localtonet 앱이 연결되어 있지 않은 경우입니다. 기기에서 앱을 시작하고 연결 열에 켜짐이 표시될 때까지 기다린 다음 다시 저장하세요. 먼저 터널을 중지할 수도 있습니다. 중지된 터널에서는 재시작 없이 값이 저장됩니다.

"이 기능을 사용하려면 잔액을 구매해야 합니다."

이 설정은 계정에 잔액이 있어야 합니다. 포트 예약, 사용자 지정 서버 포트, 고정 아웃바운드 포트, IP 제한, 서버 변경에 해당합니다. 플랜 및 잔액을 참고하세요.

"이 터널을 업데이트할 권한이 없습니다."

팀에서 작업 중이며 내 역할에 터널 변경 권한이 없는 경우입니다. 팀 소유자에게 해당 권한을 요청하세요. 팀 관리를 참고하세요.

표의 행 하나가 내 패널에 없습니다

패널에는 해당 터널 유형의 행만 표시되며, 일부 행은 터널 자체에 따라 달라집니다. 로컬 서버 IP는 로컬 또는 VPN 서버가 필요하고, SSO 제공자는 팀 터널에 표시되지 않으며, UDP 터널에는 SslStream 사용과 PROXY 프로토콜이 없습니다.

이 페이지에 도움이 필요하신가요? 커뮤니티에 질문하거나 지원 티켓을 만들어 주세요.

지원