如何用SirTunnel快速暴露本地服务？3分钟搭建HTTPS公共访问通道

【免费下载链接】SirTunnel Minimal, self-hosted, 0-config alternative to ngrok. Caddy+OpenSSH+50 lines of Python. 项目地址: https://gitcode.com/gh_mirrors/si/SirTunnel

在开发和测试过程中，我们经常需要将本地服务暴露到公网供他人访问或进行外部集成测试。SirTunnel作为一款极简的自托管工具，无需复杂配置即可替代ngrok，仅需Caddy、OpenSSH和50行Python代码就能快速搭建安全的HTTPS公共访问通道。本文将详细介绍如何在3分钟内完成SirTunnel的部署与使用，让你的本地服务轻松拥有公网HTTPS访问能力。

什么是SirTunnel？

SirTunnel是一个轻量级的本地服务暴露工具，它的核心优势在于极简配置和自托管特性。与其他同类工具相比，SirTunnel不需要依赖第三方服务，所有数据都在自己的服务器上流转，既保证了安全性，又避免了第三方服务可能带来的访问限制和隐私问题。通过结合Caddy的自动HTTPS功能和OpenSSH的端口转发能力，SirTunnel实现了简单而强大的本地服务暴露解决方案。

准备工作：快速安装SirTunnel

安装SirTunnel的过程非常简单，只需几个步骤即可完成。首先，你需要将项目克隆到本地服务器：

git clone https://gitcode.com/gh_mirrors/si/SirTunnel
cd SirTunnel

接下来，运行项目提供的安装脚本，该脚本会自动下载并配置所需的Caddy服务器：

chmod +x install.sh
./install.sh

安装脚本会下载特定版本的Caddy（当前为2.1.1版本），解压并清理多余文件，同时配置Caddy以允许绑定低端口，为后续的HTTPS服务做准备。整个安装过程无需人工干预，完全自动化完成。

启动SirTunnel服务

安装完成后，启动SirTunnel服务同样简单。项目提供了便捷的启动脚本，只需执行：

chmod +x run_server.sh
./run_server.sh

该脚本会调用Caddy并使用项目中的caddy_config.json配置文件启动服务。Caddy会自动处理HTTPS证书的申请和配置，无需手动干预，这也是SirTunnel实现"0配置"的关键所在。

3分钟实现本地服务暴露

完成上述准备工作后，暴露本地服务只需要一个简单的命令。假设你本地运行着一个Web服务，端口为3000，想要通过SirTunnel将其暴露到公网，只需执行：

python3 sirtunnel.py yourdomain.com 3000

其中，yourdomain.com是你拥有的域名，3000是本地服务的端口。执行该命令后，SirTunnel会通过Caddy的API动态添加路由规则，将来自yourdomain.com的请求反向代理到本地的3000端口。此时，你就可以通过https://yourdomain.com访问本地的3000端口服务了。

SirTunnel的工作原理

SirTunnel的核心逻辑主要在sirtunnel.py文件中实现，整个脚本不到50行代码，却实现了强大的功能。其工作流程如下：

1. 接收用户输入的域名和本地端口，生成唯一的隧道ID
2. 构造Caddy的路由配置，包含域名匹配和反向代理规则
3. 通过Caddy的管理API（默认监听在127.0.0.1:2019）动态添加路由
4. 保持程序运行，直到用户通过Ctrl+C中断，此时自动清理之前添加的路由规则

这种设计使得SirTunnel可以动态管理多个隧道，每个隧道独立运行，互不干扰，并且在退出时能自动清理资源，避免配置残留。

常见问题与解决方案

如何暴露多个本地服务？

只需打开多个终端窗口，为每个服务执行sirtunnel.py命令，使用不同的域名或子域名即可。例如：

# 暴露3000端口服务
python3 sirtunnel.py api.yourdomain.com 3000

# 暴露8080端口服务
python3 sirtunnel.py web.yourdomain.com 8080

如何确保服务稳定运行？

如果需要长时间暴露服务，可以使用nohup或screen等工具让SirTunnel在后台运行：

nohup python3 sirtunnel.py yourdomain.com 3000 &

遇到端口占用问题怎么办？

如果Caddy启动失败，可能是80或443端口被占用。可以通过以下命令查看端口占用情况：

sudo lsof -i :80
sudo lsof -i :443

然后停止占用端口的进程，或修改Caddy配置使用其他端口（不推荐，会影响HTTPS自动配置）。

总结：为什么选择SirTunnel？

SirTunnel凭借其极简设计和强大功能，成为本地服务暴露的理想选择：

• 0配置：无需复杂的配置文件，一条命令即可完成服务暴露
• 自托管：不依赖第三方服务，数据更安全，访问更稳定
• HTTPS自动配置：借助Caddy的自动HTTPS功能，无需手动管理证书
• 轻量级：核心代码仅50行Python，资源占用低，部署简单

无论是开发测试、演示展示还是临时服务暴露，SirTunnel都能为你提供快速、安全、可靠的解决方案。现在就尝试使用SirTunnel，体验3分钟搭建HTTPS公共访问通道的便捷吧！

【免费下载链接】SirTunnel Minimal, self-hosted, 0-config alternative to ngrok. Caddy+OpenSSH+50 lines of Python. 项目地址: https://gitcode.com/gh_mirrors/si/SirTunnel