跳到内容
Localtonet Localtonet 控制台

通过 Localtonet 访问虚拟主机

获取本页帮助
本页内容 10 个章节
  1. 为什么虚拟主机需要正确的 Host 头
  2. 开始之前
  3. 创建隧道
  4. 打开 HTTP 页面
  5. 填写表单
  6. 启动隧道
  7. 选项 1:在隧道中设置 Host 头
  8. 选项 2:把隧道的名称添加到虚拟主机
  9. Apache
  10. Nginx
  11. 选项 3:使用你自己的域名
  12. 多个虚拟主机
  13. 保护它
  14. 常见问题
  15. 相关页面

把本地 Apache 或 Nginx 服务器上的一个站点发布上线,包括托管多个站点的 XAMPP、WampServer 和 MAMP 环境:创建一条 HTTP 隧道,并确保 Web 服务器收到它认识的主机名。

为什么虚拟主机需要正确的 Host 头 #

使用基于名称的虚拟主机时,一台 Web 服务器可以在同一个端口上为多个站点提供服务。它根据每个请求的 Host 头来选择站点:对 mysite.test 的请求会得到配置中指定了 mysite.test 的那个站点。

HTTP 隧道会把访问者的 Host 头原样传给你的 Web 服务器。因此,访问隧道地址的访问者发送的是隧道的主机名(例如以 .localto.net 结尾的名称),而不是 mysite.test。你的 Web 服务器不认识这个名称,于是返回默认站点,通常是配置中的第一个站点,或者 XAMPP、WampServer 的起始页。

有三种方法可以解决这个问题。任选其一:

选项需要改什么最适合
在隧道中设置 Host 头隧道设置中的一个请求头。Web 服务器上无需任何改动。快速查看静态或简单的站点。
把隧道的名称添加到虚拟主机Web 服务器配置中的一行。根据主机名生成链接和重定向的应用程序。
使用你自己的域名隧道使用你拥有的域名,虚拟主机以该域名命名。需要保持固定地址的站点。

开始之前 #

  • 一个 Localtonet 账户,以及在运行 Web 服务器的电脑上通过 AuthToken 连接的 Localtonet 客户端。参见快速入门。
  • 一个能在该电脑的浏览器中正常工作的虚拟主机,例如 http://mysite.test。
  • Web 服务器监听的端口。XAMPP 和 WampServer 使用 80。MAMP 默认使用 8888,除非你改过。

创建隧道 #

  1. 打开 HTTP 页面 #

    打开我的隧道 › HTTP,展开创建 HTTP 隧道。

  2. 填写表单 #

    字段填写内容
    URL 类型选项 1 和 2 选择随机子域名。选项 3 选择自定义域名。
    设备令牌该电脑上的 Localtonet 客户端所使用的令牌。
    服务器区域选择离你的设备较近的区域,可以降低延迟。
    本地 IP 地址127.0.0.1。请填写地址,而不是虚拟主机的名称:名称是通过 Host 头传递的。
    本地端口Web 服务器的端口,例如 80。

    选择创建隧道。

  3. 启动隧道 #

    隧道会出现在你的隧道下。选择启动,并记下 URL 列中的公开地址。现在打开它,你会看到 Web 服务器的默认站点。下一步会解决这个问题。

隧道表单的完整说明见 HTTP / HTTPS 页面。

选项 1:在隧道中设置 Host 头 #

隧道可以在请求到达你的 Web 服务器之前替换 Host 头。该设置是一个名为 Host 的请求头:

  1. 在隧道所在行选择设置。
  2. 在 HTTP 头旁边选择管理。HTTP 头窗口会打开,显示请求头。
  3. 在建议下选择主机,或选择添加请求头并输入 Host 作为名称。
  4. 值填写你的虚拟主机的名称,例如 mysite.test。建议项会自动填入 localhost,请把它替换掉。只填写主机名,不要带 http://,也不要带路径。
  5. 选择保存。

控制台对主机请求头的说明是:你的服务会收到这个主机名,而不是隧道地址,这在本地 Web 服务器按主机名选择站点时很有用。如果没有 Host 请求头,你的服务会收到访问者使用的主机名。

再次打开隧道的地址。Web 服务器现在收到 Host: mysite.test,并返回该站点。要恢复原状,请删除该请求头并保存。

应用程序同样会看到本地名称。根据 Host 头或配置的站点地址来生成链接和重定向的软件,现在会把访问者带到 mysite.test,而这个名称只存在于你的电脑上。如果页面加载时没有样式,或登录后重定向到本地名称,请改用选项 2 或 3。

API 提供了与 HTTP 隧道的 Host 头覆盖相同的设置。参见 API。其他请求头和响应头见头与重写。

选项 2:把隧道的名称添加到虚拟主机 #

告诉 Web 服务器,隧道的主机名属于你的站点。从隧道的 URL 中复制主机名(不带 https://),并把它添加为别名。请让隧道的 HTTP 头保持为空。

Apache #

在 XAMPP 中,虚拟主机位于 apache\conf\extra\httpd-vhosts.conf。添加一行 ServerAlias:

httpd-vhosts.conf
<VirtualHost *:80>
    ServerName mysite.test
    ServerAlias <TUNNEL_HOST>
    DocumentRoot "C:/xampp/htdocs/mysite"
</VirtualHost>

重启 Apache。

Nginx #

把隧道的主机名添加到 server_name:

mysite.conf
server {
    listen 80;
    server_name mysite.test <TUNNEL_HOST>;
    root /var/www/mysite;
    index index.html index.php;
}

检查配置并重新加载 Nginx:

终端
sudo nginx -t && sudo nginx -s reload

HTTP 隧道会保留它的子域名,直到你删除该隧道,因此别名在重启后依然有效。

选项 3:使用你自己的域名 #

当隧道使用你拥有的域名时,访问者会在 Host 头中发送该域名,你只需用它来命名虚拟主机。不需要头覆盖,也不需要别名,应用生成的链接也是正确的。

  1. 把域名添加到你的账户,并创建 HTTP 隧道,将 URL 类型设为自定义域名。步骤见自定义域名。自定义域名需要余额。
  2. 把虚拟主机的 ServerName(Apache)或 server_name(Nginx)设为该域名,如上面的代码片段所示。

自定义子域名的做法相同,只是使用你自选的名称,而不是随机名称。它同样需要余额。

多个虚拟主机 #

一条 HTTP 隧道只有一个公开地址,只能访问一个站点。每增加一个虚拟主机,就为相同的本地 IP 地址和本地端口再创建一条 HTTP 隧道,并对它应用其中一个选项。免费版总共允许 1 条隧道。参见套餐与余额。

保护它 #

开发中的站点往往还没准备好面对陌生人。HTTP 隧道可以在请求到达你的 Web 服务器之前,要求访问者表明身份:

  • 隧道设置中的基本认证?会向访问者索要用户名和密码。
  • IP 限制 › 管理只允许你列出的地址连接。它需要余额。
  • SSO 提供商会让访问者先通过身份提供商登录。它需要余额。

这三种方式都在访问控制中介绍。对于演示,到期日期会在你设定的日期停止隧道。参见限制与到期。

常见问题 #

我看到的是 XAMPP 或 WampServer 的起始页,或者是错误的站点

Web 服务器没有识别这个主机名,于是返回了默认站点。请应用这三个选项之一。使用选项 1 时,请检查请求头的名称是 Host,并且它的值与站点的 ServerName 或 server_name 一致。使用选项 2 时,请检查别名有没有拼写错误,并重启 Web 服务器。

页面加载时没有样式,或链接指向 mysite.test

应用程序根据本地名称生成它的地址。请使用选项 2 或 3,让应用看到公开的名称。保存了站点地址的应用还需要同时修改该地址:对于 WordPress,请把站点 URL 更新为隧道的地址,或使用自定义域名。

站点重定向到 http://,浏览器显示警告或陷入循环

访问者在隧道地址上使用 HTTPS,而隧道与你的 Web 服务器之间使用普通 HTTP。自行强制 HTTPS 的应用可能没有注意到访问者已经在使用 HTTPS。在 HTTP 头中,从建议里选择请求头 X-Forwarded-Proto,值设为 https,就能告诉这类应用访问者使用的是 HTTPS。

访问者先看到 Localtonet 的警告页面

在没有余额的账户上,Localtonet 会向 HTTP 隧道的每位访问者显示一次该页面。携带 localtonet-skip-warning 头(值任意)的请求会跳过它,有余额的账户上的隧道也会跳过。

我的 Web 服务器只监听 HTTPS

把隧道的本地端口设为 HTTPS 端口(通常是 443),并在隧道的设置中开启本地 HTTPS?。该开关适用于本身使用 HTTPS 或 TLS 的本地服务。

“你需要购买余额才能使用此功能。”

自定义子域名、自定义域名、IP 限制和 SSO 提供商需要余额。请在余额中充值。

支持