如何在 tunnelto 中使用自定义子域名？完整配置指南
项目地址: https://gitcode.com/GitHub_Trending/tu/tunnelto tunnelto 是一款能够将本地 Web 服务器暴露到互联网的工具，通过生成公共 URL 让外部用户轻松访问你的本地服务。本文将详细介绍如何在 tunnelto 中配置和使用自定义子域名，帮助你打造更个性化的访问链接。
自定义子域名的优势
使用自定义子域名不仅能让你的隧道链接更加易记，还能提升品牌辨识度和专业性。例如，你可以将随机生成的 URL 替换为 myproject.tunnelto.dev 这样的个性化地址，方便与团队成员或客户分享。
前提条件
在开始配置自定义子域名前，请确保你已满足以下条件：
- 已安装 tunnelto 客户端
- 拥有有效的 API 认证密钥（专业版功能）
- 本地 Web 服务已正常运行
快速配置步骤
1. 安装 tunnelto 客户端
如果尚未安装 tunnelto，请通过以下命令克隆仓库并编译：
git clone https://gitcode.com/GitHub_Trending/tu/tunnelto
cd tunnelto
cargo build --release
2. 存储 API 认证密钥
自定义子域名功能需要使用 API 密钥进行认证。通过以下命令将密钥存储到本地：
tunnelto set-auth -k YOUR_API_KEY
密钥将保存在用户主目录的 .tunnelto/key.token 文件中，供后续隧道连接使用。
3. 使用自定义子域名启动隧道
在启动隧道时，通过 -s 或 --subdomain 参数指定你的自定义子域名：
tunnelto --subdomain mycustomsub -p 8080
上述命令将把本地 8080 端口的服务通过 mycustomsub.tunnelto.dev 域名暴露到互联网。
高级配置选项
通过配置文件设置默认子域名
你可以通过修改配置文件来设置默认子域名，避免每次启动时重复输入。配置文件位于 tunnelto/src/config.rs，相关代码如下：
36| /// Specify a sub-domain for this tunnel
37| #[structopt(short = "s", long = "subdomain")]
38| sub_domain: Option<String>,
检查子域名可用性
如果指定的子域名已被占用，tunnelto 会自动分配一个随机子域名。你可以通过查看终端输出确认最终分配的域名：
tunnelto: Connected!
tunnelto: Tunnel established at https://mycustomsub.tunnelto.dev
常见问题解决
子域名被占用怎么办？
如果收到 "subdomain is not authorized" 错误提示，可能是因为该子域名已被其他用户占用。此时可以尝试以下解决方案：
- 选择一个更独特的子域名
- 使用更长的子域名（建议至少 6 个字符）
- 添加数字或特殊字符增加唯一性
如何验证子域名配置是否成功？
启动隧道后，可以通过 curl 命令测试自定义子域名是否生效：
curl -H 'mycustomsub.tunnelto.dev' "http://localhost:8080"
如果返回本地服务的响应，则说明自定义子域名配置成功。
总结
通过本文介绍的方法，你可以轻松在 tunnelto 中配置和使用自定义子域名，让本地服务的互联网访问更加专业和便捷。无论是开发测试、演示展示还是临时共享，自定义子域名都能为你提供更好的使用体验。
如需了解更多高级功能，可以查看项目源码中的 tunnelto_server/src/auth/ 目录，那里包含了子域名认证和管理的完整实现。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
