Tugport

Tugport

通过一个小型 Rust 二进制文件，将应用部署到你拥有的服务器上。

---

Tugport 是一个可自托管的部署平台，理念类似 Coolify 和 Easypanel。它是一个独立的 Rust 二进制文件，可与 Docker 一起运行。在装有 systemd 的 Linux 服务器（x86_64 或 arm64）上安装：

curl -fsSL https://tugport.com/install | sh

如果 Docker 尚未安装，安装程序会先安装 Docker，然后将 Tugport 作为系统服务启动，并打印一个一次性链接，用于创建所有者账户。Tugport 还很新（0.1.x），使用时可能会遇到一些不完善之处。

功能

• 推送即部署：支持从 GitHub、Forgejo、Gitea、GitLab 或任何支持部署密钥的 Git 服务器部署，使用你的 Dockerfile、Railpack、Nixpacks 或 buildpacks 构建。只有通过健康检查后，新版本才会接收流量；回滚只需点击一次。
• 应用、Compose 堆栈和数据库（Postgres、MySQL、MariaDB、MongoDB、Redis），支持域名、自动 HTTPS、环境变量、卷和资源限制。
• 日志和图表：可查看每台服务器和每项服务的日志与图表，并将告警发送到 Telegram、电子邮件或 webhook。
• 将 AI Agent 作为用户：Agent 可通过一个步骤获取受限范围的 API 密钥，并通过 API、CLI 或 MCP 端点使用相同的权限；每项操作都会记入审计日志。
• 确保密钥安全：静态加密，仅交付给使用这些密钥的容器，并在其他所有地方屏蔽。
• 连接更多服务器和区域：通过加密的 WireGuard 网状网络连接；可在 Hetzner 或 AWS 创建云服务器，并支持自动扩缩容、缩至零以及数据库副本。
• 备份：将数据库和卷备份到兼容 S3 的存储或磁盘，并支持测试恢复。
• 自动更新：默认开启 Tugport 自身的自动更新，不中断流量；通过一个设置即可关闭。
• 从 Easypanel 或 Coolify 迁移：只需一个命令，应用可在迁移期间继续运行，并支持回滚。

我们有意不提供应用商店、一键模板、团队或组织功能，也不收集遥测数据。

安全说明

• 容器无法通过配置在其所属服务器上的地址、服务器网状网络或 Tugport 的内部端点访问控制面板。不过，若某个地址位于 NAT 网关上，例如 EC2 弹性 IP 或家用路由器的端口转发，容器流量会像任何外部客户端的流量一样先发出再返回。因此，在此类服务器上，请在云防火墙中关闭控制面板端口（8484），并通过控制面板的域名访问。
• 特权模式、Docker 套接字、主机网络、绑定挂载和额外功能默认关闭，只有拥有销毁授权的管理员才能启用。
• 如果服务器有 TPM，主密钥会封存到 TPM；否则会存放在仅 root 可访问的密钥文件中。请妥善保管安装程序打印的恢复密钥。

文档

• API 参考，包括 MCP 端点：https://tugport.com/docs/api/
• 从 Easypanel 或 Coolify 迁移：https://tugport.com/docs/migration/
• Tugport 与 Coolify、Dokploy、Easypanel 和 CapRover 的对比：https://tugport.com/docs/compare/
• 使用 Tugport 在 Hetzner VPS 上部署 Uptime Kuma，含逐步测试说明：https://tugport.com/docs/uptime-kuma/
• 将服务器迁移到 Tugport（面向 AI Agent），发布于：https://tugport.com/agents.md

仓库

路径	内容
src/	二进制文件：面板 API、代理、部署引擎、构建器、节点代理、CLI 和 MCP 端点
web/	面板的 Web UI（Preact 和 Tailwind），嵌入发布构建中
docs/	API 参考和迁移指南
dev/	用于在 Linux 上构建和测试的 Docker-in-Docker 环境（dev/up.sh）
website/	tugport.com，每次推送到 main 时部署至 GitHub Pages；其中的 docs/ 页面由 docs/build.mjs 从 docs/*.md 渲染（cd docs && npm ci && node build.mjs）

分享图片 website/og.png 使用无头 Chrome 从 website/og.html 渲染：

cd website && "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" --headless=new --hide-scrollbars \
  --window-size=1200,630 --virtual-time-budget=10000 --screenshot="$PWD/og.png" "file://$PWD/og.html"

每个文档页面在 website/og/<slug>.png 中都有自己的卡片；在 docs/guides.mjs 中添加或重命名指南后，运行 node docs/og.mjs。

许可证

MIT