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

TCP 서비스 공개하기

이 페이지 도움받기
이 페이지의 내용 섹션 8개
  1. 시작하기 전에
  2. 단계
  3. TCP - UDP 페이지 열기
  4. 양식 작성하기
  5. 터널 시작하기
  6. 엔드포인트에 연결하기
  7. 엔드포인트: 호스트 이름과 서버 포트
  8. 예약 포트
  9. 서버 포트 직접 선택하기
  10. 터널 IP
  11. TCP 터널 설정
  12. PROXY 프로토콜
  13. 예시
  14. SSH
  15. 데이터베이스
  16. 더 많은 서비스
  17. 무료 플랜에서
  18. 문제 해결
  19. 관련 페이지

TCP 터널은 SSH, 데이터베이스, 게임 서버 같은 로컬 TCP 서비스에 공개 호스트 이름과 포트를 부여합니다. UDP 및 UDP - TCP 터널도 함께 있는 TCP - UDP 페이지에서 만듭니다.

시작하기 전에 #

  • 기기에 Localtonet 클라이언트가 설치되어 있고 AuthToken으로 연결되어 있어야 합니다. 아직 아니라면 빠른 시작을 따라 하세요.
  • 서비스가 실행 중이며 포트를 알고 있어야 합니다. 예를 들어 SSH는 22입니다.
  • 커스텀 서브도메인, 예약 포트, 원하는 서버 포트를 쓰려면 계정에 잔액이 필요합니다.

새 터널은 공개적으로 접근할 수 있습니다. 주소를 아는 사람은 누구나 포트에 연결할 수 있습니다. 서비스에 강력한 인증을 유지하고, 잔액이 필요한 IP 제한도 고려하세요.

단계 #

  1. TCP - UDP 페이지 열기 #

    내 터널 › TCP - UDP를 열고 TCP - UDP 터널 만들기를 선택해 양식을 엽니다.

  2. 양식 작성하기 #

    필드입력할 내용
    프로토콜TCP. 다른 선택지는 UDP와 UDP - TCP입니다.
    기기 토큰기기의 Localtonet 앱이 사용하는 토큰입니다.
    서버 리전지연 시간을 줄이려면 기기와 가까운 리전을 선택하세요.
    로컬 IP 주소기기에서 서비스가 있는 주소입니다. 이 기기라면 127.0.0.1을, 네트워크의 다른 컴퓨터라면 그 컴퓨터의 주소를 사용합니다.
    로컬 포트로컬 서비스가 수신 대기하는 포트이며 1에서 65535 사이입니다.
    URL 유형랜덤 서브도메인은 호스트 이름을 자동으로 만듭니다. 커스텀 서브도메인은 서브도메인에 직접 입력할 수 있으며 잔액이 필요합니다.
    도메인localto.net 또는 DNS 매니저에 추가한 도메인입니다.

    터널 만들기를 선택합니다. 터널이 내 터널 아래에 나타납니다.

  3. 터널 시작하기 #

    작업 열에서 시작 버튼을 선택합니다. 서버 포트는 터널이 시작될 때 Localtonet이 할당합니다. 그때까지 서버 포트 열에는 대시가 표시됩니다.

  4. 엔드포인트에 연결하기 #

    URL 열에는 엔드포인트가 호스트 이름과 포트로 표시됩니다(예: <SUBDOMAIN>.localto.net:<SERVER_PORT>). 선택하면 복사됩니다. 클라이언트에서는 로컬 주소 대신 이 호스트와 포트를 사용하세요.

엔드포인트: 호스트 이름과 서버 포트 #

TCP 터널에는 포트가 두 개 있습니다. 로컬 포트는 기기에서 서비스가 수신 대기하는 포트입니다. 서버 포트는 사람들이 Localtonet 서버에서 접속하는 포트입니다. 두 번호가 같지 않아도 됩니다.

열표시 내용
URL호스트 이름과 서버 포트가 함께 표시되며 바로 복사할 수 있습니다.
서버 포트서버 포트만 표시되며, 포트가 예약되었는지를 알려 주는 아이콘이 함께 있습니다.
프로토콜 유형TCP, UDP 또는 UDP_TCP.

예약 포트 #

예약된 포트는 터널이나 Localtonet 앱을 다시 시작해도 그대로 유지됩니다. 예약되지 않은 포트는 터널이나 앱을 다시 시작하면 바뀌므로, 공유한 주소가 더 이상 작동하지 않습니다.

  • 잔액이 있으면 터널이 예약 포트로 만들어집니다. 처음 시작할 때 받은 포트가 계속 유지됩니다.
  • 무료 플랜에서는 포트가 예약되지 않습니다. 잔액을 충전한 다음 터널 설정에서 포트 예약을 켜면 포트가 고정됩니다.
  • 기존 터널의 포트를 예약하려면 터널을 시작한 다음 포트 예약을 켜거나, 포트 옆 아이콘을 선택하고 포트 예약을 선택하세요. 포트는 터널이 실행 중일 때만 예약할 수 있으므로, 중지된 터널에서는 같은 팝업에 터널을 시작하는 시작하여 예약이 표시됩니다.
  • 포트를 반납하려면 포트 예약을 끄고 해제를 확인하세요. 다음 재시작 후 포트가 바뀔 수 있습니다.

서버 포트 직접 선택하기 #

터널 설정에서 서버 포트 옆의 변경을 선택하고 501에서 65535 사이의 번호를 입력합니다. 4040 포트는 사용할 수 없습니다. 저장하면 이 터널에 포트가 예약되고 터널이 다시 시작되므로 기기가 온라인이어야 합니다. 같은 서버의 다른 터널이 이미 그 포트를 사용 중이면 다른 포트를 선택하라는 메시지가 표시됩니다. 서버 포트를 변경하려면 잔액이 필요합니다. 포트를 참고하세요.

터널 IP #

터널 설정의 터널 IP에는 서버의 IPv4 주소가 표시되며, IPv6 주소가 있으면 함께 표시됩니다. 클라이언트는 호스트 이름 대신 이 주소로 연결할 수 있습니다. 서버 IP 주소는 바뀔 수 있으므로 앱과 스크립트에서는 가능하면 호스트 이름을 사용하세요.

TCP 터널 설정 #

작업 열의 설정 버튼을 선택하면 터널 설정 패널이 열립니다. 터널 상세에서 엔드포인트를 복사하고, 터널 이름을 바꾸고, 로컬 IP 주소와 로컬 포트를 변경할 수 있습니다.

설정기능자세히 보기
포트 예약터널을 다시 시작해도 같은 서버 포트를 유지합니다.이 페이지의 위쪽
서버 포트클라이언트가 이 터널에 연결할 때 사용하는 포트를 변경합니다.포트
SslStream 사용Localtonet 앱이 TLS로 로컬 서비스에 연결합니다. 로컬 서비스 자체가 TLS를 사용할 때 켜세요.이 페이지
PROXY 프로토콜원래 클라이언트 주소를 PROXY 프로토콜 헤더에 담아 서비스로 전달합니다.이 페이지의 아래쪽
레거시 연결터널이 일반 방식으로 연결되지 않을 때 시도해 보세요.설정 참조
터널 IP클라이언트가 이 터널에 접속할 때 사용하는 IPv4 및 IPv6 주소를 확인합니다.이 페이지의 위쪽
IP 제한이 터널에 접근할 수 있는 클라이언트 IP 주소를 제어합니다.접근 제어
만료일, 속도 제한, 대역폭 제한, 대역폭 사용량, 대역폭 트래픽정해진 날짜에 터널을 중지하고, 속도와 데이터 사용량에 상한을 두고, 데이터 카운터를 초기화하고, 시간에 따른 트래픽을 확인합니다.제한 및 만료
요청 로그, 활동 로그, 터널 상태 점검터널에 들어온 연결, 시작, 중지, 설정 변경, 상태 점검을 확인합니다.로그 및 검사
인수이 터널을 기기의 특정 네트워크로 보냅니다.네트워크 선택
아웃바운드 포트엄격한 방화벽 환경에서 Localtonet 앱의 서버 연결에 고정 아웃바운드 포트를 사용합니다.포트
터널 메모이 터널을 구분하는 데 도움이 되는 비공개 메모를 저장합니다.설정 참조
로드 밸런스여러 기기에 트래픽을 분산하거나 백업 대상을 사용합니다.로드 밸런싱
SSH 명령어 보기Localtonet 앱을 설치하지 않고 일반 SSH만으로 이 터널을 시작합니다. TCP 터널에서만 제공되며 UDP나 UDP - TCP 터널에서는 제공되지 않습니다.설치 없는 SSH

실행 중인 터널에서 SslStream 사용, PROXY 프로토콜, 레거시 연결 또는 서버 포트를 변경하면 터널이 다시 시작됩니다. Localtonet 앱이 연결되어 있어야 하며, 그렇지 않으면 “기기 연결을 확인하세요.”라는 메시지가 표시됩니다.

PROXY 프로토콜 #

터널을 거치면 서비스에는 모든 연결이 실제 방문자가 아니라 기기의 Localtonet 앱에서 오는 것으로 보입니다. PROXY 프로토콜을 켜면 앱이 각 연결의 시작 부분에, 방문자의 데이터보다 앞서 PROXY 프로토콜 줄(버전 1, 일반 텍스트) 하나를 씁니다.

연결의 첫 줄
PROXY TCP4 <VISITOR_IP> <LOCAL_IP> <VISITOR_PORT> <LOCAL_PORT>

IPv6 방문자의 경우 줄이 PROXY TCP6로 시작합니다.

서비스가 필요로 할 때만 켜세요. PROXY 프로토콜을 이해하지 못하는 서비스는 추가된 줄을 데이터로 처리하고 연결을 거부합니다. 많은 서버에 관련 설정이 있습니다(예: nginx의 proxy_protocol, HAProxy의 accept-proxy). 사용 중인 서비스의 문서를 확인하세요.

예시 #

SSH #

로컬 IP 주소 127.0.0.1, 로컬 포트 22로 TCP 터널을 만들고 시작하세요. URL 열의 호스트와 서버 포트로 어디서든 연결할 수 있습니다.

터미널
ssh -p <SERVER_PORT> <USER>@<SUBDOMAIN>.localto.net

전체 가이드는 Localtonet으로 SSH 사용하기에 있습니다.

데이터베이스 #

데이터베이스 포트로 TCP 터널을 만듭니다. 예를 들어 PostgreSQL은 5432, MySQL은 3306입니다. 그런 다음 데이터베이스 클라이언트에서 터널의 호스트와 서버 포트를 사용하세요.

PostgreSQL
psql -h <SUBDOMAIN>.localto.net -p <SERVER_PORT> -U <DB_USER> <DB_NAME>
MySQL
mysql -h <SUBDOMAIN>.localto.net -P <SERVER_PORT> -u <DB_USER> -p

데이터베이스는 입력한 로컬 주소에서 연결을 받아야 합니다. 가이드: PostgreSQL, MySQL, SQL Server, MongoDB.

더 많은 서비스 #

무료 플랜에서 #

대시보드는 무료 세션 한도를 다음과 같이 안내합니다. TCP/UDP, TLS, 프록시, 로테이팅 프록시 터널은 30분 후 중지됩니다. 다시 시작하려면 월 대역폭이 남아 있는 경우 시작을 선택해 새 세션을 시작하고, Localtonet 클라이언트를 연결된 상태로 유지하세요. 중지된 터널은 목록에 세션 종료로 표시됩니다.

무료 터널의 포트는 예약되지 않으므로 다음 시작 후 서버 포트가 달라질 수 있습니다. 잔액이 0보다 크면 세션 제한이 사라지고 포트를 예약할 수 있습니다. 플랜 및 잔액을 참고하세요.

문제 해결 #

클라이언트가 엔드포인트에 연결할 수 없습니다

목록에서 세 가지를 확인하세요. 터널이 시작되었는지, 연결 열에 켜짐이 표시되어 Localtonet 앱이 연결되어 있는지, 클라이언트의 호스트와 포트가 URL 열과 일치하는지 확인합니다. 포트가 예약되지 않았다면 서버 포트는 재시작 후 바뀝니다. 그런 다음 서비스가 터널의 로컬 IP 주소와 포트에서 수신 대기하는지 확인하세요.

“AuthToken …의 Localtonet 앱이 연결되어 있지 않습니다.”

이 터널의 토큰으로 기기에서 Localtonet 클라이언트를 시작하세요. 시작 대화상자는 앱이 연결되는 즉시 터널을 자동으로 시작합니다.

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

커스텀 서브도메인, 예약 포트, 원하는 서버 포트에는 잔액이 필요합니다. 잔액에서 충전하거나, 랜덤 서브도메인과 할당된 포트를 사용하세요.

“이 서버에서는 포트 …을(를) 사용할 수 없습니다.”

같은 서버의 다른 터널이 해당 서버 포트를 사용하거나 예약했습니다. 다른 포트를 선택하거나, 목록에서 서버 이름을 선택해 터널을 다른 서버로 옮기세요.

“501에서 65535 사이의 포트를 선택하세요.” 또는 “4040 포트는 Localtonet이 사용합니다. 다른 포트를 선택하세요.”

501 미만의 서버 포트와 4040 포트는 사용할 수 없습니다. 로컬 포트는 22나 80처럼 어떤 포트든 쓸 수 있습니다. 제한되는 것은 공개 서버 포트뿐입니다.

“예약되지 않은 포트”와 “시작하여 예약” 버튼

포트는 터널이 실행 중이고 서버 포트가 있을 때만 예약할 수 있습니다. 시작하여 예약을 선택해 터널을 시작하세요. 터널이 실행되면 포트 예약을 켜세요.

PROXY 프로토콜을 켠 뒤 서비스가 모든 연결을 거부합니다

서비스가 PROXY 프로토콜 줄을 예상하지 않습니다. 스위치를 끄거나 서비스에서 PROXY 프로토콜 지원을 켜세요.

터널이 저절로 중지되었습니다

터널 설정에서 활동 로그를 여세요. 무료 사용 한도에 도달했거나, 터널의 대역폭 제한에 도달했거나, 만료일이 지난 것처럼 중지된 이유가 표시됩니다.

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

지원