Localtonet 작동 방식
이 페이지의 내용 섹션 10개
기기의 Localtonet 클라이언트는 Localtonet 서버로 암호화된 아웃바운드 터널을 엽니다. 서버는 서비스에 공개 주소를 부여하고, 그 터널을 통해 선택한 로컬 IP 주소와 포트로 트래픽을 전달합니다.
요청의 경로 #
- 방문자가 터널의 공개 주소에 접속합니다. 이 주소는 선택한 리전의 Localtonet 서버에 속합니다.
- Localtonet 서버는 기기의 클라이언트가 이미 열어 둔 터널로 트래픽을 보냅니다.
- Localtonet 클라이언트는 트래픽을 받아 터널에 설정된 로컬 IP 주소와 포트(예:
127.0.0.1:3000)로 연결합니다. - 서비스가 응답하면 응답은 같은 경로로 되돌아갑니다.
포트 포워딩도 공용 IP도 필요 없습니다 #
연결을 시작하는 쪽이 기기이므로 인바운드 포트를 열 필요가 없습니다. 공용 IP 주소도, 라우터 설정 변경도 필요하지 않습니다. 포트 포워딩이 불가능한 가정용 및 모바일 연결의 NAT와 CGNAT 뒤에서도 작동합니다.
다만 네트워크가 아웃바운드 연결을 허용해야 합니다. 방화벽이나 엔드포인트 보안 제품이 연결을 차단할 수 있습니다.
HTTP 및 TCP 터널은 클라이언트 없이도 사용할 수 있습니다. 터널 설정에 표시되는 SSH 명령어로, SSH 클라이언트가 있는 어느 컴퓨터에서든 터널을 열 수 있습니다. 설치 없는 SSH를 참고하세요.
기기와 AuthToken #
AuthToken은 기기 하나를 계정에 연결합니다. 이 토큰으로 클라이언트를 시작하면, 이후 터널을 만들 때 그 기기를 선택할 수 있습니다.
- 기기마다 토큰 하나. 내 토큰에서 기기마다 토큰을 만들고
Office-PC처럼 알아볼 수 있는 이름을 붙이세요. 이름은 라벨일 뿐이며 토큰 자체는 Localtonet이 생성합니다. - 토큰당 연결 하나. 같은 토큰을 사용하는 새 연결은 이전 연결을 대체하므로, 같은 토큰으로 기기 두 대를 시작하지 마세요.
- 온라인과 오프라인. 내 토큰은 Localtonet 앱이 연결되어 있는 동안 기기를 온라인으로, 연결이 끊기면 터널이 구성되어 있더라도 오프라인으로 표시합니다.
- 비공개로 유지하세요. 토큰을 가진 사람은 누구나 그 기기로 앱에 로그인할 수 있습니다.
AuthToken은 터널을 보호하지 않습니다. 방문자가 아니라 기기를 식별하는 것입니다. 새 터널은 주소를 아는 누구나 접근할 수 있습니다. 방문자를 제한하려면 접근 제어를 참고하세요.
토큰에 대한 자세한 내용: AuthToken.
터널 #
터널은 공개 주소를 한 기기의 서비스에 연결하는, 저장된 설정 모음입니다. 모든 터널에는 다음이 저장됩니다.
| 설정 | 결정하는 것 |
|---|---|
| 터널 유형 | 프로토콜입니다. HTTP, TCP, UDP, TLS, 파일 서버, 프록시 서버 등이 있습니다. 터널 유형을 참고하세요. |
| 기기 토큰 | 트래픽을 받는 기기입니다. 그 기기의 클라이언트를 시작할 때 사용한 토큰입니다. |
| 서버 리전 | 공개 주소를 호스팅하는 Localtonet 서버의 위치입니다. |
| URL 유형 | 공개 주소를 정하는 방식입니다. |
| 로컬 IP 주소와 로컬 포트 | 클라이언트가 트래픽을 보내는 곳입니다. 클라이언트와 같은 기기의 서비스에는 127.0.0.1을 사용하세요. |
기기 하나로 여러 터널을 제공할 수 있습니다. 내 토큰에는 토큰마다 연결된 활성 터널 수와 전체 터널 수가 표시됩니다. 터널을 다른 기기로 옮기려면 터널 목록에서 토큰 이름을 선택하고 AuthToken 변경에서 다른 토큰을 선택하세요. 실행 중인 터널은 중지된 뒤 선택한 토큰으로 다시 시작됩니다. 로테이팅 프록시 터널은 예외로, 단일 토큰 대신 토큰 그룹을 사용합니다.
생성부터 서비스 시작까지 #
- 생성. 터널 만들기는 설정만 저장합니다. 아직 온라인 상태가 아닙니다.
- 시작. 시작을 선택합니다. 터널 토큰의 클라이언트가 연결되어 있으면 터널이 서비스를 시작합니다.
- 기기가 오프라인일 때 시작. 대시보드가 토큰이 오프라인임을 알리고 앱이 연결되기를 기다립니다. 그래도 시작을 선택하면 터널이 즉시 켜집니다. 터널은 활성으로 집계되며 앱이 연결되면 서비스를 시작합니다.
- 중지. 공개 주소가 응답하지 않습니다. 터널과 설정은 나중을 위해 보관됩니다.
- 삭제. 터널의 엔드포인트와 설정이 제거됩니다.
토큰을 삭제하면 그 토큰의 터널도 삭제됩니다. 해당 토큰을 사용하는 터널은 중지되고 삭제됩니다.
서버 리전 #
서버 리전 필드는 터널의 공개 주소를 호스팅할 위치를 정합니다. 대시보드 안내는 다음과 같습니다. 지연 시간을 줄이려면 기기와 가까운 리전을 선택하세요.
목록은 계정에 맞게 구성되며 다음이 포함됩니다.
- Localtonet 리전: 국가별로 하나씩 있습니다. 홈페이지의 네트워크 지도에서 위치를 볼 수 있습니다.
- 내 서버: 서버 매니저로 추가한 경우에 표시됩니다. 내 계정에서만 보이며, 목록에서 기본으로 내 서버가 선택됩니다.
- 로컬을 서버로 사용: 지원하는 터널 유형에서 사용할 수 있습니다. 아래를 참고하세요.
기존 터널을 옮길 수 있습니다. 터널 목록에서 터널의 서버를 선택하면 서버 변경이 열립니다. 잔액이 필요하며, 서버를 변경하면 DNS 업데이트에 최대 3시간이 걸릴 수 있습니다.
공개 주소와 URL 유형 #
터널을 만들 때 URL 유형이 공개 주소를 정하는 방식을 결정합니다.
| URL 유형 | 제공되는 것 | 플랜 |
|---|---|---|
| 랜덤 서브도메인 | Localtonet이 서브도메인을 생성합니다. 주소를 바로 받을 수 있습니다. | 무료 플랜 |
| 커스텀 서브도메인 | 서브도메인을 직접 입력하고, 그것이 속할 도메인을 선택합니다. | 잔액 필요 |
| 사용자 지정 도메인 | DNS 매니저에 추가한 자신의 도메인을 사용합니다. 커스텀 도메인을 참고하세요. | 잔액 필요 |
모든 터널 유형이 모든 URL 유형을 제공하는 것은 아닙니다.
| 터널 유형 | 랜덤 서브도메인 | 커스텀 서브도메인 | 사용자 지정 도메인 |
|---|---|---|---|
| HTTP | 예 | 예 | 예 |
| 파일 서버 | 예 | 예 | 예 |
| MCP 게이트웨이 | 예 | 예 | 예 |
| TLS | 예 | 예 | 아니요 |
| TCP, UDP, UDP / TCP 혼합 | 예 | 예 | 아니요 |
| 프록시 서버 | 예 | 예 | 아니요 |
| 로테이팅 프록시 | 예 | 예 | 아니요 |
TCP, UDP, 프록시 터널은 호스트 이름과 서버 포트로 접속합니다.
주소가 그대로 유지되나요? #
- HTTP 터널은 터널을 삭제할 때까지 서브도메인을 유지합니다.
- TCP, UDP, 프록시 터널은 잔액이 있는 계정에서 만들면 포트 예약이 켜진 상태로 시작되어 재시작해도 같은 포트가 유지됩니다. 터널마다 전환할 수 있습니다. 포트를 참고하세요.
- 무료 플랜에서는 터널이 중지되면 포트가 해제되므로 주소가 바뀔 수 있습니다.
종단 간 암호화 #
기기와 Localtonet 서버 사이의 터널은 암호화되어 있습니다. 이것은 방문자와 서비스 사이의 종단 간 암호화와는 다릅니다.
- 방문자는 Localtonet이 관리하는 인증서로 HTTPS를 통해 HTTP 터널에 접속합니다. 이 HTTPS는 서비스가 아니라 Localtonet 서버에서 종료됩니다. 거기서부터 트래픽은 암호화된 터널을 통해 기기로 전달됩니다.
- 종단 간 암호화가 필요하면 서비스가 자체 인증서를 제시하는 패스스루 모드의 TLS 터널을 사용하거나, SSH처럼 이미 암호화된 프로토콜을 사용하세요.
클라이언트 연결이 끊어지면 #
터널은 기기, Localtonet 클라이언트, 로컬 서비스, 이 세 가지가 모두 실행 중일 때만 작동합니다. 클라이언트의 연결이 끊기거나 클라이언트를 닫으면 다음과 같이 됩니다.
- 방문자가 공개 주소로 서비스에 더 이상 접속할 수 없습니다.
- 내 토큰에서 기기가 오프라인으로 표시됩니다. 터널 자체는 시작된 상태로 유지됩니다.
- 클라이언트가 스스로 다시 연결을 시도합니다. 시작된 터널은 앱이 연결되는 즉시 다시 서비스를 시작합니다.
- 시작된 터널은 기기가 오프라인이어도 시작된 동안 요금이 부과됩니다. 요금을 멈추려면 터널을 중지하세요. 플랜 및 잔액을 참고하세요.
로그아웃이나 재부팅 후에도 클라이언트가 계속 실행되게 하려면 서비스로 설치하세요: 서비스로 실행. 터널이나 토큰의 연결이 끊어졌을 때 알림을 받으려면 웹훅을 설정하세요.
로컬을 서버로 사용 #
로컬을 서버로 사용은 서버 리전 목록의 항목입니다. 이를 선택하면 Localtonet 서버가 공개 주소를 호스팅하지 않습니다. 기기의 Localtonet 클라이언트가 직접 리스너를 열고, 방문자는 기기에 직접 연결합니다. 대시보드에서는 이런 터널을 Client Relay라고도 부릅니다.
- HTTP, TCP, UDP, TLS, 프록시 서버, MCP 게이트웨이 터널을 만들 때 제공됩니다. 파일 서버와 로테이팅 프록시에서는 제공되지 않습니다.
- 이 항목을 선택하면 양식에 릴레이 서버 IP, 즉 방문자가 접속할 기기의 IP 주소를 묻습니다.
- 리스너를 호스팅하는 기기는 계속 연결되어 있어야 합니다.
- Client Relay 터널은 별도의 더 낮은 요금이 적용됩니다. 플랜 및 잔액을 참고하세요.
| 메시지 | 해결 방법 |
|---|---|
| 로컬 서버 IP를 입력하세요. | 릴레이 서버 IP를 입력하세요. |
| 로컬 서버 IP는 외부에서 접근할 수 있어야 합니다. | 127.0.0.1 같은 루프백 또는 로컬 전용 주소를 입력했습니다. 방문자가 접속할 수 있는 주소를 입력하세요. |