HTTP 터널 만들기
이 페이지의 내용 섹션 10개
HTTP 터널을 사용하면 기기에서 실행 중인 웹 앱, API 또는 웹훅 수신기에 공개 HTTPS 주소를 부여할 수 있습니다. 인증서는 Localtonet이 제공하므로 로컬 서비스는 일반 HTTP로 두어도 됩니다.
시작하기 전에 #
- 기기에 Localtonet 클라이언트가 설치되어 있고 AuthToken으로 연결되어 있어야 합니다. 그렇지 않다면 빠른 시작을 따라 하세요.
- 웹 서비스가 실행 중이며 해당 포트를 알고 있어야 합니다. 예:
3000. - 커스텀 서브도메인 또는 커스텀 도메인을 쓰려면 계정에 잔액이 있어야 합니다. 커스텀 도메인은 추가로 DNS 매니저에 추가한 도메인이 필요합니다. 커스텀 도메인을 참고하세요.
단계 #
-
HTTP 페이지 열기 #
내 터널 › HTTP를 열고 HTTP 터널 만들기를 선택하여 양식을 엽니다.
-
URL 유형 선택 #
URL 유형 받게 되는 주소 필요한 것 랜덤 서브도메인 선택한 도메인에 자동으로 생성된 이름이 붙습니다. 예: https://<RANDOM_NAME>.localto.net.추가로 필요한 것 없음 커스텀 서브도메인 서브도메인에 입력한 이름입니다. 예: https://myapp.localto.net. 영문자, 숫자, 하이픈을 사용할 수 있습니다.잔액 커스텀 도메인 도메인에서 선택한, 직접 소유한 도메인입니다. 잔액, 그리고 DNS 매니저에 등록된 도메인 -
기기와 리전 선택 #
기기 토큰에서 기기의 Localtonet 앱이 사용하는 토큰을 선택합니다. 서버 리전에서는 지연 시간을 줄이기 위해 기기와 가까운 리전을 선택하세요.
-
로컬 주소 입력 #
필드 입력할 내용 도메인 localto.net또는 직접 소유한 도메인 중 하나입니다. 커스텀 도메인의 경우 목록에는 직접 소유한 도메인만 표시됩니다.서브도메인 커스텀 서브도메인에서만 사용합니다. 도메인 앞에 붙는 이름입니다. 로컬 IP 주소 기기에서 실행 중인 서비스의 주소입니다. 이 기기라면 127.0.0.1을 사용하세요. 양식은 IPv4 또는 IPv6 주소, 그리고localhost를 받습니다.로컬 포트 로컬 서비스가 수신 대기하는 포트로, 1에서 65535 사이입니다. 터널 만들기를 선택합니다. 터널은 내 터널 아래에
Tunnel #뒤에 ID가 붙은 이름으로 표시됩니다. -
터널 시작하기 #
작업 열의 시작 버튼을 선택합니다. 터널이 실행되면 URL 열의 주소가 링크로 바뀝니다. 브라우저에서 열어 보세요. 이제 해당 주소로 들어오는 요청이 기기의 서비스에 전달됩니다.
해당 토큰을 쓰는 Localtonet 앱이 오프라인이면 대화상자가 알려 줍니다. 앱을 시작하거나 그래도 시작을 선택하면 앱이 연결되는 즉시 터널이 활성화됩니다.
공개 주소 #
- 주소는
https://뒤에 URL 열의 호스트 이름이 붙은 형태입니다. - HTTP 터널은 터널을 삭제할 때까지 서브도메인을 유지합니다. 중지했다가 다시 시작해도 바뀌지 않습니다.
- 주소에는 포트 번호가 없습니다. 방문자는 다른 웹사이트와 똑같이 열 수 있습니다.
- WebSocket 연결도 HTTP 터널을 통과합니다.
HTTPS와 인증서 #
방문자는 Localtonet이 제공하고 갱신하는 인증서로 HTTPS를 통해 HTTP 터널에 접속합니다. TLS는 Localtonet 서버에서 종료됩니다. 거기서부터 요청은 터널을 거쳐 기기로 전달되고, Localtonet 앱이 이를 서비스에 넘깁니다.
| 설정 | 기능 | 사용 시기 |
|---|---|---|
| HTTPS 전용 | 공개 URL을 HTTPS로만 제공합니다. http:// 요청은 같은 주소의 https://로 리디렉션됩니다. 꺼져 있는 동안에는 두 방식 모두로 응답합니다. | 로그인 정보나 비공개 데이터를 다루는 경우 켜 두세요. |
| HTTP/3 활성화 | 클라이언트가 HTTP/3로 공개 URL에 접속할 수 있게 합니다. 새 터널에서는 켜져 있습니다. | 클라이언트에서 HTTP/3 관련 문제가 있을 때만 끄세요. |
| SslStream 사용 | Localtonet 앱이 로컬 서비스에 TLS로 연결하도록 합니다. 앱은 로컬 서비스의 인증서를 그대로 받아들이므로 자체 서명 인증서도 사용할 수 있습니다. | 로컬 서비스 자체가 HTTPS를 사용할 때 켜세요. 예: https://localhost:5001의 개발 서버. |
| 레거시 연결 | 일반 방식 대신 레거시 방식으로 터널을 연결합니다. | 일반 방식으로 터널이 연결되지 않을 때 시도해 보세요. |
이 스위치는 터널 설정 패널의 설정에 있습니다. 실행 중인 터널에서 SslStream 사용 또는 레거시 연결을 변경하면 터널이 다시 시작되므로 Localtonet 앱이 연결되어 있어야 합니다.
자체 서비스까지 암호화가 필요하신가요? HTTP 터널에서는 Localtonet이 서버에서 트래픽을 복호화합니다. 서비스가 자체 인증서를 제시해야 한다면 TLS 터널을 사용하세요.
Host 헤더 #
서비스는 방문자가 사용한 호스트 이름, 즉 터널 주소를 받습니다. 일부 로컬 웹 서버는 호스트 이름으로 사이트를 선택하기 때문에 엉뚱한 사이트로 응답하거나 오류를 반환합니다. 이 경우 터널 설정에서 헤더를 열고 서버가 기대하는 이름으로 Host라는 요청 헤더를 추가하세요. 그러면 서비스는 터널 주소 대신 이 호스트 이름을 받습니다. 헤더 및 재작성 및 가상 호스트를 참고하세요.
HTTP 터널의 설정 #
작업 열의 설정 버튼을 선택하면 터널 설정 패널이 열립니다. 터널 상세에서 터널 이름을 바꾸고 로컬 IP 주소와 로컬 포트를 변경할 수 있습니다. 아래 표에는 HTTP 터널이 제공하는 나머지 기능과 해당 설명 위치가 정리되어 있습니다.
| 설정 | 기능 | 자세히 보기 |
|---|---|---|
| 로드 밸런스 | 여러 기기에 트래픽을 분산하거나 백업 대상을 사용합니다. | 로드 밸런싱 |
| SSH 명령어 보기 | Localtonet 앱을 설치하지 않고 일반 SSH만으로 이 터널을 시작합니다. | 설치 없는 SSH |
| HTTPS 전용, HTTP/3 활성화, SslStream 사용, 레거시 연결 | 방문자와 서비스가 연결되는 방식입니다. | 이 페이지의 위쪽 |
| 경로 재작성 | 요청 경로가 로컬 서비스에 도달하기 전에 변경합니다. | 헤더 및 재작성 |
| 헤더 | 이 터널의 사용자 지정 HTTP 요청 및 응답 헤더를 관리합니다. | 헤더 및 재작성 |
| HTTP 타임아웃 | 로컬 애플리케이션의 응답을 서버가 얼마나 기다릴지 1초에서 600초 사이로 설정합니다. | 헤더 및 재작성 |
| Basic 인증 | 방문자에게 사용자 이름과 비밀번호를 요구합니다. | 접근 제어 |
| IP 제한 | 이 터널에 접근할 수 있는 클라이언트 IP 주소를 제어합니다. | 접근 제어 |
| SSO 제공자 | 방문자는 터널을 열기 전에 사용자의 ID 공급자 중 하나로 로그인해야 합니다. 페이지 상단의 SSO 버튼에서 제공자를 관리합니다. | 통합 인증(SSO) |
| 작업 열의 WAF 버튼 | WAF 설정을 엽니다. 버튼은 웹 애플리케이션 방화벽이 구성되지 않았는지, 활성인지, 비활성인지 보여 줍니다. | 웹 애플리케이션 방화벽 |
| 만료일, 속도 제한, 대역폭 제한, 대역폭 사용량, 대역폭 트래픽 | 정해진 날짜에 터널을 중지하고, 속도를 제한하고, 데이터 사용량을 제한하고, 데이터 카운터를 초기화하며, 시간에 따른 트래픽을 확인합니다. | 제한 및 만료 |
| 요청 로그, 활동 로그, 터널 상태 점검 | 요청을 검사하고, 시작과 중지 및 설정 변경 내역을 확인하며, 상태 점검 결과를 봅니다. | 로그 및 검사 |
| 인수 | 이 터널을 기기의 특정 네트워크로 보냅니다. | 네트워크 선택 |
| 아웃바운드 포트 | 엄격한 방화벽 환경에서 Localtonet 앱의 서버 연결에 고정 아웃바운드 포트를 사용합니다. | 포트 |
| 터널 메모 | 이 터널을 구분하는 데 도움이 되는 비공개 메모를 저장합니다. | 설정 참조 |
팀에 속한 터널에는 SSO 제공자가 표시되지 않습니다.
예시 #
웹 앱 공유 #
앱이 Localtonet 클라이언트와 같은 컴퓨터에서 실행되며 3000번 포트에서 수신 대기합니다.
| 필드 | 값 |
|---|---|
| URL 유형 | 랜덤 서브도메인 |
| 도메인 | localto.net |
| 로컬 IP 주소 | 127.0.0.1 |
| 로컬 포트 | 3000 |
터널을 만들고 시작한 다음, 앱을 보여 줄 사람들에게 URL 열의 주소를 보내세요. 먼저 비밀번호를 요구하려면 Basic 인증을 켜세요.
앱이 네트워크의 다른 컴퓨터에서 실행된다면 로컬 IP 주소에 그 컴퓨터의 주소를 입력하세요. 예: 192.168.1.20. Localtonet 클라이언트를 실행하는 기기가 해당 컴퓨터에 접근할 수 있어야 합니다.
웹훅 수신 #
웹훅 제공업체가 이벤트를 보내려면 공개 HTTPS 주소가 필요합니다. 수신기의 포트로 HTTP 터널을 만들어 시작한 다음, 제공업체에 터널 주소와 엔드포인트 경로를 합친 주소를 입력하세요.
https://<YOUR_SUBDOMAIN>.localto.net/<YOUR_WEBHOOK_PATH>아무 컴퓨터에서나 테스트해 보세요.
curl -X POST https://<YOUR_SUBDOMAIN>.localto.net/<YOUR_WEBHOOK_PATH> \
-H "Content-Type: application/json" \
-d '{"event":"test"}'수신된 내용을 보려면 터널의 웹훅 열에 있는 아이콘(요청 및 응답 로그 보기)을 선택하세요. 먼저 터널이 시작되어 있어야 합니다. 로그 및 검사를 참고하세요.
무료 플랜에서는 웹훅을 사용하기 전에 잔액을 충전하세요. 무료 계정의 HTTP 터널로 들어오는 요청은 먼저 경고 페이지를 거치는데, 웹훅 제공업체는 이를 클릭해 넘어갈 수 없습니다. 다음 섹션을 참고하세요.
무료 플랜의 경고 페이지 #
계정에 잔액이 없으면 HTTP 터널을 처음 방문하는 사람에게 "You are about to navigate to:"라는 제목의 Localtonet 페이지가 표시되며 Cancel 및 Visit Site 버튼이 있습니다. 이 페이지는 오용을 막기 위한 것입니다. Visit Site를 누르면 방문자의 브라우저에 쿠키가 저장되고 사이트가 열립니다. 브라우저가 이 쿠키를 유지하는 동안에는 다시 묻지 않습니다.
이 페이지 자체에 이를 없애는 두 가지 방법이 안내되어 있습니다.
localtonet-skip-warning이라는 요청 헤더를 임의의 값으로 보냅니다. 직접 만든 스크립트와 API 클라이언트에 적합합니다.- 계정에 잔액을 충전합니다. 플랜 및 잔액을 참고하세요.
curl -H "localtonet-skip-warning: 1" https://<YOUR_SUBDOMAIN>.localto.net/문제 해결 #
대화상자에 토큰이 오프라인이라고 표시되거나 "AuthToken “…”의 Localtonet 앱이 연결되어 있지 않습니다."가 표시됩니다.
이 터널의 토큰을 사용하는 Localtonet 클라이언트가 실행 중이 아니거나 Localtonet에 접속할 수 없는 상태입니다. 기기에서 같은 토큰으로 클라이언트를 시작하세요. 앱이 연결되는 즉시 대화상자가 터널을 자동으로 시작합니다. 그래도 시작을 선택하면 터널이 켜지고 나중에 활성화됩니다.
"Localtonet 앱을 시작하거나 업데이트하세요."
기기에서 터널을 시작하지 못했습니다. 클라이언트가 실행 중인지 확인하고, 버전이 오래되었다면 다운로드 페이지에서 최신 버전을 설치하세요.
브라우저에 "Tunnel Recently Started or Stopped"가 표시됩니다.
요청은 Localtonet에 도달했지만 터널이 연결을 받지 않는 상태입니다. 터널이 방금 시작되었거나 중지되어 있습니다. 터널이 시작되어 있고 연결 열에 켜짐이 표시되는지 확인한 다음 페이지를 새로 고치세요.
브라우저에 내 로컬 주소가 언급된 Localtonet 오류 페이지가 표시됩니다.
이 페이지는 트래픽이 Localtonet 에이전트로 터널링되었지만 에이전트가 사용자의 로컬 IP와 포트에 있는 업스트림 서비스에 연결하지 못했다고 알려 줍니다. 제목이 곧 오류입니다. 예: ConnectionRefused. 해당 주소에서 수신 대기하는 것이 없다는 뜻입니다. 서비스를 시작한 다음 터널 상세의 로컬 IP 주소와 로컬 포트를 확인하세요. 기기에서 브라우저로 로컬 주소를 열어 서비스를 직접 테스트할 수도 있습니다.
"이 기능을 사용하려면 잔액을 구매해야 합니다."
커스텀 서브도메인과 커스텀 도메인에는 잔액이 필요합니다. 랜덤 서브도메인을 사용하거나 잔액에서 잔액을 충전하세요.
"이 유형의 터널을 하나 더 생성하려면 총 …의 잔액이 필요합니다."
잔액이 터널을 하나 더 만들기에 부족합니다. 무료 플랜에서는 유형과 관계없이 터널을 총 하나만 만들 수 있습니다. 기존 터널을 삭제한 뒤 새로 만들거나 잔액을 충전하세요.
"…은(는) 이미 존재합니다." 또는 "…은(는) 사용할 수 없습니다."
다른 터널이 해당 서브도메인을 사용 중이거나 Localtonet이 예약한 이름입니다. 다른 서브도메인을 선택하세요.
"경고! 등록된 도메인이 없습니다!"
커스텀 도메인을 선택했지만 아직 도메인을 추가하지 않았습니다. 먼저 DNS 매니저에 추가하세요. "…은(는) 이미 다른 터널에서 사용 중입니다."가 표시된다면 해당 도메인은 이미 내 터널 중 하나에 속해 있습니다. 커스텀 도메인은 터널 하나에만 사용할 수 있습니다.
"대역폭 한도를 업데이트하거나 대역폭 사용량을 초기화하세요." 또는 "만료일을 업데이트하세요."
터널이 자체 대역폭 한도 또는 만료일에 도달하여 시작할 수 없습니다. 터널 설정에서 한도나 날짜를 변경하거나 대역폭 사용량으로 카운터를 초기화하세요. 제한 및 만료를 참고하세요.
"기기 연결을 확인하세요."
Localtonet 앱이 오프라인인 상태에서 실행 중인 터널을 다시 시작하게 만드는 설정을 변경했습니다. 앱을 연결한 다음 설정을 다시 저장하거나 먼저 터널을 중지하세요.
앱이 엉뚱한 사이트로 응답하거나 http:// 링크와 리디렉션을 만듭니다.
앱이 받은 호스트 이름이나 스킴을 기준으로 동작하기 때문입니다. 앱이 고정된 호스트 이름을 기대한다면 헤더에서 Host 요청 헤더를 추가하세요. 방문자가 HTTPS를 사용한다는 것을 앱에 알리려면 값이 https인 X-Forwarded-Proto 요청 헤더를 추가하세요. 그러면 앱이 https:// 링크와 리디렉션을 만듭니다.