TLS 터널 만들기
Desktop v7.6+ Mobile v9.9+
이 페이지의 내용 섹션 10개
TLS 터널은 공개 호스트 이름의 443 포트로 들어오는 암호화된 트래픽을 로컬 TLS 서비스로 전달합니다. 기본적으로 암호화된 연결이 그대로 서비스에 전달되며, 서비스가 자체 인증서를 제시합니다.
TLS, HTTP, TCP 중 무엇을 선택할까요? #
세 가지 모두 암호화를 사용하는 서비스를 공개할 수 있습니다. 인증서를 누가 갖고 있는지, 공개 주소가 어떤 모양인지가 다릅니다.
| 질문 | HTTP 터널 | TLS 터널 | TCP 터널 |
|---|---|---|---|
| 공개 엔드포인트 | 포트 없는 https:// 주소 | 443 포트의 호스트 이름 | 호스트 이름과 할당된 서버 포트 |
| 인증서를 제시하는 주체 | Localtonet | 기본적으로 내 서비스입니다. SSL 모드에서 선택하면 Localtonet이 제시합니다. | Localtonet은 인증서를 추가하지 않습니다. 서비스가 지금까지 하던 대로 동작합니다. |
| TLS가 끝나는 지점 | Localtonet 서버 | 패스스루 모드에서는 내 서비스 | 프로토콜이 끝나는 곳 어디든 |
| 프로토콜 | HTTP와 WebSocket | TLS 위에서 동작하는 모든 프로토콜 | 모든 TCP 프로토콜 |
| 헤더, 경로 재작성, Basic 인증, SSO, WAF, 요청 검사기 같은 HTTP 옵션 | 예 | 아니요 | 아니요 |
| URL 유형 | 랜덤 서브도메인, 커스텀 서브도메인, 커스텀 도메인 | 랜덤 서브도메인, 커스텀 서브도메인 | 랜덤 서브도메인, 커스텀 서브도메인 |
| 무료 플랜 세션 제한 | 없음 | 세션당 30분 | 세션당 30분 |
- 일반 웹사이트, API, 웹훅 수신기에는 HTTP를 선택하세요. 가장 손이 덜 갑니다.
- 서비스가 자체 인증서를 제시해야 하거나, 트래픽이 내 기기까지 암호화된 상태로 유지되어야 하거나, TLS 기반의 비HTTP 프로토콜을 443 포트에서 접근할 수 있게 해야 한다면 TLS를 선택하세요.
- 프로토콜이 첫 바이트부터 TLS가 아니거나 클라이언트가 호스트 이름을 보낼 수 없다면 TCP를 선택하세요. TCP 터널은 포트로, TLS 터널은 호스트 이름으로 접속합니다.
시작하기 전에 #
- AuthToken으로 연결된 최신 Localtonet 클라이언트가 필요합니다. TLS 페이지에 표시된 최소 버전은 Desktop v7.6과 Mobile v9.9입니다.
- TLS를 사용하며 클라이언트가 접속할 호스트 이름에 대한 인증서가 있는 로컬 서비스가 필요합니다. 서비스에 인증서가 없다면 HTTP를 참고하거나, 아래 설명대로 SSL 모드를 전환하세요.
- 커스텀 서브도메인을 사용하려면 계정에 잔액이 있어야 합니다.
단계 #
-
TLS 페이지 열기 #
내 터널 › TLS를 열고 TLS 터널 만들기를 선택하여 양식을 엽니다.
-
URL 유형, 기기, 리전 선택 #
URL 유형에서 랜덤 서브도메인 또는 커스텀 서브도메인을 선택합니다. 기기 토큰에서는 내 기기의 Localtonet 앱이 사용하는 토큰을 선택합니다. 서버 리전에서는 기기와 가까운 리전을 선택합니다.
-
엔드포인트 입력 #
필드 입력할 내용 도메인 localto.net또는 DNS 매니저에서 추가한 도메인입니다.서브도메인 커스텀 서브도메인에만 해당합니다. 도메인 앞에 붙는 이름입니다. 영문자, 숫자, 하이픈을 사용할 수 있습니다. 로컬 IP 주소 내 기기에 있는 서비스의 주소입니다. 이 기기에서는 127.0.0.1을 사용하세요.로컬 포트 TLS 서비스가 수신 대기하는 포트입니다. 예: 443또는8443.터널 만들기를 선택합니다.
-
터널 시작하기 #
작업 열의 시작 버튼을 선택합니다. URL 열에 호스트 이름이 표시되고 서버 포트 열에
443이 표시됩니다. 클라이언트는 이 호스트 이름의 443 포트로 접속합니다.
엔드포인트 #
- 모든 TLS 터널은 443 포트로 접속합니다. 로컬 포트는 어떤 포트든 상관없습니다.
- Localtonet은 클라이언트가 TLS 연결을 열 때 보내는 호스트 이름(SNI)으로 터널을 찾습니다. 따라서 클라이언트는 URL 열의 호스트 이름으로 접속해야 합니다. 이 호스트 이름 없이 서버의 IP 주소로 접속하면 터널에 도달하지 못합니다.
- 터널을 중지했다가 다시 시작해도 호스트 이름은 그대로 유지됩니다.
SSL 모드: 인증서를 누가 처리하는가 #
터널 설정을 열고 SSL 모드 옆의 관리를 선택합니다. SSL 모드 대화상자에서 이 터널의 HTTPS를 누가 처리할지 선택합니다.
| 선택지 | 동작 | 사용 시기 |
|---|---|---|
| 내 서비스가 HTTPS 처리 | 패스스루입니다. 암호화된 트래픽이 그대로 서비스에 전달되며, 서비스가 이 도메인에 대한 자체 인증서를 제시해야 합니다. Localtonet은 트래픽을 복호화하지 않습니다. | 자체 인증서나 종단 간 암호화가 필요할 때 사용합니다. 새 TLS 터널은 이 모드로 시작합니다. |
| Localtonet이 HTTPS 처리 | Localtonet이 인증서를 제공하고 갱신합니다. 내 쪽에서 설정할 것은 없습니다. Localtonet이 TLS 연결을 종료하고 복호화된 트래픽을 서비스로 전달합니다. | 서비스에 인증서가 없지만 클라이언트가 443 포트에서 TLS로 접속해야 할 때 사용합니다. |
저장을 선택합니다. 터널이 실행 중이면 새 모드로 재시작되므로 Localtonet 앱이 연결되어 있어야 합니다.
SslStream 사용 설정은 두 번째 모드에 해당합니다. Localtonet이 HTTPS를 처리하는데 로컬 서비스가 여전히 TLS 연결을 기대한다면 켜세요. 방문자의 TLS 연결이 이미 변경 없이 서비스에 도달하는 패스스루 모드에서는 꺼 두세요.
TLS 터널의 설정 #
| 설정 | 기능 | 자세히 보기 |
|---|---|---|
| SSL 모드 | Localtonet이 관리하는 SSL을 사용하거나, TLS 트래픽을 내 서비스로 그대로 전달합니다. | 이 페이지의 위쪽 |
| SslStream 사용 | 로컬 서비스가 TLS를 사용하는 경우 켜세요. | 이 페이지의 위쪽 |
| 레거시 연결 | 터널이 일반 방식으로 연결되지 않을 때 사용해 보세요. | 설정 참조 |
| 터널 IP | 서버의 IPv4 및 IPv6 주소를 확인합니다. | 설정 참조 |
| IP 제한 | 이 터널에 접근할 수 있는 클라이언트 IP 주소를 제어합니다. | 접근 제어 |
| 만료일, 속도 제한, 대역폭 제한, 대역폭 사용량, 대역폭 트래픽 | 정해진 날짜에 터널을 중지하고, 속도와 데이터 사용량에 상한을 두고, 데이터 카운터를 초기화하며, 시간에 따른 트래픽을 확인합니다. | 제한 및 만료 |
| 요청 로그, 활동 로그, 터널 상태 점검 | 터널에 대한 연결, 시작, 중지, 설정 변경 내역과 상태 점검 결과를 확인합니다. | 로그 및 검사 |
| 인수 | 이 터널을 기기의 특정 네트워크로 보냅니다. | 네트워크 선택 |
| 아웃바운드 포트 | 엄격한 방화벽 환경을 위해 Localtonet 앱이 서버에 연결할 때 고정 아웃바운드 포트를 사용합니다. | 포트 |
| 터널 메모 | 이 터널을 구분하는 데 도움이 되는 비공개 메모를 저장합니다. | 설정 참조 |
| 로드 밸런스 | 여러 기기에 트래픽을 분산하거나 백업 대상을 사용합니다. | 로드 밸런싱 |
TLS 터널에는 서버 포트 설정과 예약 포트가 없습니다. 포트는 항상 443입니다.
예시 #
자체 인증서를 사용하는 웹 서버 #
웹 서버가 127.0.0.1:443에서 수신 대기하고 있고 secure.example.com에 대한 인증서가 있습니다. DNS 매니저에 example.com을 추가했고 계정에 잔액이 있습니다.
| 필드 | 값 |
|---|---|
| URL 유형 | 커스텀 서브도메인 |
| 서브도메인 | secure |
| 도메인 | example.com |
| 로컬 IP 주소 | 127.0.0.1 |
| 로컬 포트 | 443 |
터널을 시작하고 https://secure.example.com을 엽니다. 브라우저에 내 서버의 인증서가 표시됩니다. OpenSSL로 어떤 인증서가 제시되는지 확인할 수 있습니다.
openssl s_client -connect <TUNNEL_HOST>:443 -servername <TUNNEL_HOST>TLS를 사용하는 비HTTP 서비스 #
내 기기의 메시지 브로커가 로컬 포트 8883에서 TLS 연결을 받습니다. 로컬 포트를 8883으로 하여 TLS 터널을 만드세요. 그러면 클라이언트는 TLS를 켜고 터널의 호스트 이름의 443 포트로 접속합니다. 클라이언트는 호스트 이름(SNI)을 보내야 하며, 이름으로 접속하면 TLS 라이브러리가 자동으로 보냅니다.
인증서가 없는 서비스를 443 포트의 TLS로 제공하기 #
서비스의 일반 포트로 터널을 만든 다음 SSL 모드를 열고 Localtonet이 HTTPS 처리를 선택합니다. 클라이언트는 TLS로 접속하며 Localtonet이 발급한 인증서를 받습니다. 서비스는 계속 암호화되지 않은 트래픽을 받습니다.
무료 플랜에서 #
무료 플랜에서는 TLS 터널이 30분 후에 중지됩니다. 월간 대역폭이 남아 있다면 시작을 선택하여 새 세션을 시작하세요. 호스트 이름은 바뀌지 않습니다. 플랜 및 잔액을 참고하세요.
문제 해결 #
클라이언트에 인증서 경고가 표시됩니다
패스스루 모드에서는 클라이언트가 내 서비스의 인증서를 보게 됩니다. 이 인증서는 터널의 호스트 이름에 유효해야 하고 클라이언트가 신뢰해야 합니다. 서비스에 일치하는 인증서를 설치하거나, SSL 모드를 Localtonet이 HTTPS 처리로 전환하세요.
연결이 열리자마자 닫힙니다
패스스루 모드에서는 로컬 서비스가 TLS 핸드셰이크에 직접 응답해야 합니다. 로컬 포트의 서비스가 일반 HTTP나 일반 TCP를 사용한다면 SSL 모드를 Localtonet이 HTTPS 처리로 전환하거나 HTTP 또는 TCP 터널을 사용하세요. 또한 패스스루 모드에서는 SslStream 사용이 꺼져 있는지 확인하세요.
"Localtonet 앱을 시작하거나 업데이트하세요."
기기에서 터널을 시작할 수 없었습니다. TLS 터널에는 Localtonet Desktop v7.6 또는 Mobile v9.9 이상이 필요합니다. 다운로드 페이지에서 클라이언트를 업데이트한 다음 터널을 다시 시작하세요.
"기기 연결을 확인하세요."
Localtonet 앱이 오프라인인 동안 SSL 모드나 실행 중인 터널을 재시작해야 하는 다른 설정을 저장했습니다. 앱을 연결하고 다시 저장하거나, 먼저 터널을 중지하세요.
"이 기능을 사용하려면 잔액을 구매해야 합니다."
커스텀 서브도메인은 잔액이 필요합니다. 랜덤 서브도메인을 사용하거나 잔액에서 잔액을 충전하세요.
터널이 30분 후에 중지되었습니다
무료 세션 제한 때문입니다. 중지된 터널은 목록에 세션 종료로 표시됩니다. 다시 시작하거나 잔액을 충전하여 제한을 해제하세요.