헤더, 경로 재작성, HTTP 옵션
이 페이지의 내용 섹션 11개
HTTP 요청과 응답이 터널을 통과하는 방식을 바꿉니다. 고정 헤더 추가, 서비스가 받는 Host 헤더 지정, 모든 요청 앞에 경로 붙이기, 요청 타임아웃 설정, 공개 주소의 HTTPS 전용 또는 HTTP/3 선택이 가능합니다.
시작하기 전에 #
- HTTP 터널. HTTP / HTTPS를 참고하세요.
- 설정은 터널의 설정 패널에 있습니다. 내 터널 › HTTP를 열고 터널 행에서 설정을 선택하세요.
| 설정 | HTTP | MCP 게이트웨이 |
|---|---|---|
| 헤더 | 예 | – |
| 경로 재작성 | 예 | – |
| HTTP 타임아웃 | 예 | 예 |
| HTTPS 전용 | 예 | 예 |
| HTTP/3 활성화 | 예 | 예 |
이 설정 중 어느 것도 터널을 다시 시작하지 않습니다. 변경 사항은 저장하는 즉시 실행 중인 터널에 적용됩니다.
HTTP 헤더 #
헤더 › 관리는 HTTP 헤더 대화 상자를 엽니다. 터널을 통과하는 트래픽에 고정 헤더를 추가합니다.
- 요청 헤더는 모든 요청과 함께 로컬 서비스에 전달됩니다.
- 응답 헤더는 모든 응답과 함께 방문자에게 전달됩니다.
값은 입력한 그대로 전송됩니다.
헤더 추가 #
-
헤더 유형 선택 #
대화 상자 상단에서 요청 헤더 또는 응답 헤더를 선택합니다. 각 탭에는 해당 헤더의 개수가 표시됩니다.
-
헤더 추가하기 #
헤더 추가를 선택하고 이름과 값을 입력하거나, 추천 아래에서 이름을 선택해 적절한 시작값이 채워진 행을 가져옵니다. 대화 상자가 아는 헤더라면 행의 정보 아이콘이 그 기능을 설명합니다.
-
저장 #
저장을 선택합니다. 헤더를 제거하려면 해당 행의 제거 버튼을 선택한 다음 저장을 선택하세요.
미리 만든 세트 #
응답 헤더 탭에서 미리 만든 세트를 사용하면 헤더 그룹을 한 번에 추가할 수 있습니다. 그러면 대화 상자에 "NAME이(가) 추가되었습니다. 값을 확인한 후 저장하세요."라고 표시됩니다. 세트는 이미 목록에 있는 헤더의 값이 비어 있는 경우에만 그 값을 채웁니다.
| 세트 | 추가되는 헤더 | 용도 |
|---|---|---|
| CORS 허용 |
| 다른 사이트의 웹 앱이 이 터널을 호출할 수 있게 합니다. |
| 보안 헤더 |
| HSTS, nosniff, 프레임 보호, 리퍼러 정책. |
| 캐싱 끄기 | Cache-Control: no-store | 브라우저와 프록시가 응답을 캐시하지 못하게 합니다. |
| 검색 엔진에서 숨기기 | X-Robots-Tag: noindex, nofollow | 검색 엔진에 이 주소를 색인하지 않도록 요청합니다. |
추천 헤더 #
| 헤더 | 유형 | 대화 상자의 설명 |
|---|---|---|
Host | 요청 | 서비스가 터널 주소 대신 이 호스트 이름을 받습니다. 로컬 웹 서버가 호스트 이름으로 사이트를 선택할 때 유용합니다. |
Authorization | 요청 | 모든 요청과 함께 서비스에 같은 자격 증명을 보냅니다. |
X-API-Key | 요청 | 헤더에 키가 있어야 하는 서비스를 위한 고정 키입니다. |
X-Forwarded-Proto | 요청 | 방문자가 HTTPS를 사용한다고 앱에 알려 주어, 앱이 https:// 링크와 리디렉션을 만들게 합니다. |
Origin | 요청 | 일부 서비스는 알려진 출처의 요청만 받습니다. |
Access-Control-Allow-Origin | 응답 | 브라우저에서 이 터널을 호출할 수 있는 웹사이트입니다. *는 모든 사이트를 허용합니다. |
Access-Control-Allow-Credentials | 응답 | 브라우저가 쿠키를 보내도록 허용합니다. Access-Control-Allow-Origin: *와 함께 사용할 수 없습니다. |
Strict-Transport-Security | 응답 | 브라우저가 이 주소에 항상 HTTPS를 사용하도록 알립니다. |
X-Frame-Options | 응답 | 다른 사이트가 내 페이지를 프레임 안에 표시하지 못하게 합니다. |
Content-Security-Policy | 응답 | 페이지가 스크립트, 스타일, 이미지를 불러올 수 있는 위치를 제어합니다. 엄격한 정책은 페이지를 망가뜨릴 수 있으므로 테스트하세요. |
Cache-Control | 응답 | no-store는 브라우저와 프록시가 응답을 캐시하지 못하게 합니다. |
X-Robots-Tag | 응답 | 검색 엔진에 이 주소를 색인하지 않도록 요청합니다. |
추천에는 요청용 User-Agent, Accept-Language, Cache-Control과 응답용 Access-Control-Allow-Methods, Access-Control-Allow-Headers, X-Content-Type-Options, Referrer-Policy, Permissions-Policy도 포함됩니다. 다른 헤더 이름도 직접 입력할 수 있습니다.
규칙 #
- 헤더 이름에는 영문자, 숫자, 대시를 사용할 수 있으며(예:
X-Api-Key) 최대 256자입니다. - 이름은 탭마다 한 번만 나타날 수 있습니다. 같은 이름의 두 번째 행은 "NAME은(는) 이미 목록에 있습니다."라는 메시지와 함께 거부됩니다.
- 행에는 이름이 필요합니다. 비어 있는 행은 저장할 때 무시됩니다.
Host 헤더 #
기본적으로 서비스는 요청의 호스트 이름으로 터널 주소를 받습니다. 다른 호스트 이름을 보내려면 HTTP 헤더 대화 상자에서 요청 헤더 Host를 추가하고 값을 서비스가 기대하는 이름(예: localhost 또는 shop.internal)으로 설정하세요.
로컬 웹 서버가 호스트 이름으로 사이트를 선택할 때(예: Apache나 nginx의 가상 호스트, 호스트 바인딩을 쓰는 IIS, localhost에만 응답하는 개발 서버) 사용하세요. 전체 예시는 가상 호스트를 참고하세요.
경로 재작성 #
경로 재작성은 요청이 로컬 서비스에 도달하기 전에 모든 요청 앞에 경로를 추가합니다. 방문자는 계속 짧은 주소를 사용합니다.
-
경로 재작성을 예로 전환 #
경로 재작성 대화 상자가 열립니다.
-
추가할 경로 입력 #
추가할 경로에
/api나/app/v2같은 경로를 입력하거나 자주 쓰는 경로 중 하나를 선택합니다. 경로는 슬래시로 시작하며, 슬래시를 빼면 자동으로 추가됩니다. 예시 상자에는 샘플 요청에 대한 결과가 표시됩니다. -
저장 #
저장을 선택합니다.
경로가 /api인 경우:
| 방문자가 여는 주소 | 서비스가 받는 주소 |
|---|---|
https://<YOUR_TUNNEL_ADDRESS>/orders?id=7 | /api/orders?id=7 |
터널에는 경로를 하나만 지정할 수 있으며 최대 200자입니다. 공백을 포함할 수 없고 /만으로 구성할 수 없습니다. 제거하려면 경로 재작성을 아니요로 전환하고 경로 재작성을 끌까요?에서 확인하세요. 저장된 경로가 제거되고 요청이 원래 경로 그대로 서비스에 도달합니다.
HTTP 타임아웃 #
HTTP 타임아웃 › 관리는 요청 타임아웃 대화 상자를 엽니다. 타임아웃은 터널이 서비스의 응답을 기다리는 시간입니다. 이 시간이 지나면 방문자에게 타임아웃 오류가 표시됩니다.
| 항목 | 값 |
|---|---|
| 타임아웃 | 1에서 600 사이의 정수(초)입니다. 비워 두면 서버 기본값이 적용됩니다. |
| 프리셋 | 서버 기본값, 30초, 1분, 2분, 5분, 10분 |
느린 보고서, 큰 업로드, 롱 폴링에는 타임아웃을 늘리세요. 표준값으로 돌아가려면 서버 기본값을 선택하세요.
HTTPS 전용 #
공개 URL을 HTTPS로만 제공하려면 HTTPS 전용을 예로 전환하고 HTTPS 전용을 켤까요?에서 확인하세요. 로그인이나 개인 정보가 오가는 모든 경우에 사용하면 누구도 일반 HTTP로 터널에 접근할 수 없습니다.
HTTP/3 활성화 #
클라이언트가 HTTP/3로 공개 URL에 접속하게 하려면 HTTP/3 활성화를 예로 전환하세요. HTTP/3를 지원하지 않는 클라이언트는 이전 HTTP 버전을 계속 사용합니다.
예시 #
다른 사이트의 웹 앱이 내 API를 호출하게 하기 #
프런트엔드가 https://app.example.com에서 실행되며 터널 뒤의 API를 호출합니다. 헤더 › 관리를 열고 응답 헤더로 이동해 CORS 허용을 선택합니다. 그 사이트만 API를 호출할 수 있게 하려면 Access-Control-Allow-Origin의 *를 https://app.example.com으로 바꾸고 저장을 선택하세요.
하위 경로에서 동작하는 앱 공개하기 #
애플리케이션 서버가 /app/v2 아래에서 앱을 제공하며, 방문자가 일반 터널 주소를 열게 하려고 합니다. 경로 재작성을 켜고 /app/v2를 입력하세요. 방문자가 /login을 열면 서비스의 /app/v2/login에 도달합니다.
API로 같은 설정 사용하기 #
이 설정은 /api/v2/tunnels/<TUNNEL_ID>/ 아래에서도 사용할 수 있습니다: headers, host-header, path-rewrite, http-timeout, https-only, http3. API를 참고하세요.
문제 해결 #
"헤더 이름에는 영문자, 숫자, 대시를 사용할 수 있습니다(예: X-Api-Key)."
이름에 공백이나 콜론처럼 헤더 이름에 허용되지 않는 문자가 있습니다. 이름에는 이름만, 나머지는 값에 입력하세요.
"이 헤더의 이름을 입력하거나 행을 제거하세요."
행에 값은 있지만 이름이 없습니다. 이름을 입력하거나 행을 제거하세요.
"http://와 호스트 이름 없이 경로만 입력하세요."
추가할 경로에는 전체 URL이 아니라 /api 같은 경로를 입력합니다.
"1에서 600 사이의 정수를 입력하거나 서버 기본값을 선택하세요."
타임아웃은 1초에서 600초 사이여야 합니다. 더 오래 걸리는 작업은 먼저 요청에 응답하고, 클라이언트가 나중에 결과를 요청하게 하세요.
CORS 헤더가 쿠키와 함께 작동하지 않습니다
Access-Control-Allow-Credentials는 Access-Control-Allow-Origin: *와 함께 사용할 수 없습니다. Access-Control-Allow-Origin을 호출하는 사이트의 정확한 출처로 설정하세요.
로컬 서비스가 HTTPS를 사용하는데 터널에 오류가 표시됩니다
헤더 문제가 아닙니다. SslStream 사용을 켜세요. 이는 로컬 서비스 자체가 HTTPS를 사용한다고 터널에 알려 줍니다. 설정 참조를 참고하세요.