跳到内容
Localtonet Localtonet 控制台

HTTP 头、路径重写和 HTTP 选项

获取本页帮助
本页内容 11 个章节
  1. 开始之前
  2. HTTP 头
  3. 添加头
  4. 选择头的类型
  5. 添加头
  6. 保存
  7. 现成组合
  8. 建议的头
  9. 规则
  10. Host 头
  11. 重写路径
  12. 将“重写路径?”切换为“是”
  13. 输入要添加的路径
  14. 保存
  15. HTTP 超时
  16. 仅限 HTTPS?
  17. 启用 HTTP/3?
  18. 示例
  19. 让其他网站上的 Web 应用调用你的 API
  20. 发布位于子路径下的应用
  21. 通过 API 使用相同的设置
  22. 故障排除
  23. 相关页面

更改 HTTP 请求和响应通过隧道的方式:添加固定的头,设置你的服务收到的 Host 头,在每个请求前加上一个路径,设置请求超时,并为公共地址选择仅限 HTTPS 或 HTTP/3。

开始之前 #

设置项HTTPMCP 网关
HTTP 头是–
重写路径?是–
HTTP 超时是是
仅限 HTTPS?是是
启用 HTTP/3?是是

这些设置都不会重启隧道。更改在保存后会立即应用到正在运行的隧道。

HTTP 头 #

HTTP 头 › 管理会打开 HTTP 头对话框。它可以为通过隧道的流量添加固定的头:

  • 请求头会随每个请求发送到你的本地服务。
  • 响应头会随每个响应发送给访客。

值会按你输入的内容原样发送。

添加头 #

  1. 选择头的类型 #

    在对话框顶部选择请求头或响应头。每个标签页都会显示它包含多少个头。

  2. 添加头 #

    选择添加头并填写名称和值,或者在建议下选择一个名称,得到一个带有合理初始值的行。对于对话框已知的头,行中的信息图标会说明它的作用。

  3. 保存 #

    选择保存。若要移除某个头,请选择该行的移除按钮,然后选择保存。

现成组合 #

在响应头标签页上,现成组合可以一步添加一组头。随后对话框会提示“已添加 NAME。请检查各项值后保存。”只有当列表中已有某个头的值为空时,组合才会填写该头。

组合添加的头适用于
允许 CORS
  • Access-Control-Allow-Origin: *
  • Access-Control-Allow-Methods: GET, POST, PUT, PATCH, DELETE, OPTIONS
  • Access-Control-Allow-Headers: Content-Type, Authorization
允许其他网站上的 Web 应用调用此隧道。
安全头
  • Strict-Transport-Security: max-age=31536000; includeSubDomains
  • X-Content-Type-Options: nosniff
  • X-Frame-Options: SAMEORIGIN
  • Referrer-Policy: strict-origin-when-cross-origin
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 应答的开发服务器。完整示例参见虚拟主机。

重写路径 #

路径重写会在每个请求到达你的本地服务之前,在其前面加上一个路径。访客仍然使用简短的地址。

  1. 将“重写路径?”切换为“是” #

    重写路径对话框随即打开。

  2. 输入要添加的路径 #

    在要添加的路径中输入,例如 /api 或 /app/v2,或选择一个常用路径。路径以斜杠开头;如果你省略了斜杠,系统会自动补上。示例框会显示示例请求的结果。

  3. 保存 #

    选择保存。

以 /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。参见设置参考。

支持