HTTP 头、路径重写和 HTTP 选项
本页内容 11 个章节
更改 HTTP 请求和响应通过隧道的方式:添加固定的头,设置你的服务收到的 Host 头,在每个请求前加上一个路径,设置请求超时,并为公共地址选择仅限 HTTPS 或 HTTP/3。
开始之前 #
- 一个 HTTP 隧道。参见 HTTP / HTTPS。
- 这些设置位于隧道的设置面板中:打开 我的隧道 › HTTP,然后在该隧道所在行选择设置。
| 设置项 | HTTP | MCP 网关 |
|---|---|---|
| HTTP 头 | 是 | – |
| 重写路径? | 是 | – |
| HTTP 超时 | 是 | 是 |
| 仅限 HTTPS? | 是 | 是 |
| 启用 HTTP/3? | 是 | 是 |
这些设置都不会重启隧道。更改在保存后会立即应用到正在运行的隧道。
HTTP 头 #
HTTP 头 › 管理会打开 HTTP 头对话框。它可以为通过隧道的流量添加固定的头:
- 请求头会随每个请求发送到你的本地服务。
- 响应头会随每个响应发送给访客。
值会按你输入的内容原样发送。
添加头 #
-
选择头的类型 #
在对话框顶部选择请求头或响应头。每个标签页都会显示它包含多少个头。
-
添加头 #
选择添加头并填写名称和值,或者在建议下选择一个名称,得到一个带有合理初始值的行。对于对话框已知的头,行中的信息图标会说明它的作用。
-
保存 #
选择保存。若要移除某个头,请选择该行的移除按钮,然后选择保存。
现成组合 #
在响应头标签页上,现成组合可以一步添加一组头。随后对话框会提示“已添加 NAME。请检查各项值后保存。”只有当列表中已有某个头的值为空时,组合才会填写该头。
| 组合 | 添加的头 | 适用于 |
|---|---|---|
| 允许 CORS |
| 允许其他网站上的 Web 应用调用此隧道。 |
| 安全头 |
| HSTS、nosniff、框架保护和引用来源策略。 |
| 关闭缓存 | Cache-Control: no-store | 防止浏览器和代理缓存响应。 |
| 不被搜索引擎收录 | X-Robots-Tag: noindex, nofollow | 请求搜索引擎不要收录此地址。 |
建议的头 #
| 头 | 类型 | 对话框对它的说明 |
|---|---|---|
Host | 请求 | 你的服务收到的是这个主机名,而不是隧道地址。当本地 Web 服务器按主机名选择站点时很有用。 |
Authorization | 请求 | 在每个请求中向你的服务发送相同的凭据。 |
X-API-Key | 请求 | 为期望在头中携带固定密钥的服务提供的固定密钥。 |
X-Forwarded-Proto | 请求 | 告诉你的应用访客使用的是 HTTPS,这样它就会生成 https:// 链接和重定向。 |
Origin | 请求 | 有些服务只接受来自已知来源的请求。 |
Access-Control-Allow-Origin | 响应 | 哪些网站可以从浏览器调用此隧道。* 表示允许任何网站。 |
Access-Control-Allow-Credentials | 响应 | 允许浏览器发送 Cookie。它不能与 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。
当本地 Web 服务器按主机名选择站点时请使用它,例如 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? #
将仅限 HTTPS?切换为是,并确认开启仅限 HTTPS?,即可让公共 URL 只通过 HTTPS 提供服务。对于任何涉及登录或个人数据的内容,请使用它,这样就没有人能通过明文 HTTP 访问隧道。
启用 HTTP/3? #
将启用 HTTP/3?切换为是,即可让客户端通过 HTTP/3 访问公共 URL。不支持 HTTP/3 的客户端会继续使用较早的 HTTP 版本。
示例 #
让其他网站上的 Web 应用调用你的 API #
你的前端运行在 https://app.example.com 上,并调用隧道后面的 API。打开 HTTP 头 › 管理,进入响应头并选择允许 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:// 和主机名。”
要添加的路径接受像 /api 这样的路径,而不是完整的 URL。
“请输入 1 到 600 之间的整数,或选择‘服务器默认值’。”
超时时间必须在 1 到 600 秒之间。对于耗时更长的任务,请先应答请求,再让客户端稍后获取结果。
我的 CORS 头在带 Cookie 时不起作用
Access-Control-Allow-Credentials 不能与 Access-Control-Allow-Origin: * 同时使用。请将 Access-Control-Allow-Origin 设置为调用方网站的确切来源。
我的本地服务使用 HTTPS,隧道却显示错误
这不是头的问题。请开启本地 HTTPS?,它会告诉隧道你的本地服务本身使用 HTTPS。参见设置参考。