直接答复
使用 Self-Hosted TLS 附加组件开始 Pro 试用,或将其添加到 Pro。然后将您的域名添加为“仅 HTTPS,运行在我的服务器上”,在每台服务器上运行其设置中的容器,并将该域名的 A 或 AAAA 记录指向这些服务器。只要您的服务器对该域名作出响应,RedirHub 就会签发证书,此后也会持续续期。
使用 Self-Hosted TLS,您域名的 HTTPS 会在您自己的服务器上终止,运行在位于应用程序前方的容器中。RedirHub 会为每个域名签发证书、续期并同步到每台服务器,因此您无需运行 ACME 客户端或续期任务。访客请求会直接到达您的服务器,永远不会经过 RedirHub。
此模式下的域名仅支持 HTTPS:RedirHub 不会在其上提供重定向或短链接。
开始之前#
- 一台安装了 Docker 的服务器,可通过互联网访问 443 端口。80 端口留给您的应用程序使用。
- 您的应用程序,或像 Caddy 或 nginx 这样的代理,在服务器的 80 端口上响应普通 HTTP。其他端口也可以,只需一个设置即可。
- 您工作区中的管理员角色:只有管理员才能看到带有工作区令牌的命令。
第 1 步:获取 Self-Hosted TLS 附加组件#
Self-Hosted TLS 是 Pro 的附加组件,每月 100 美元,最多支持 100 台服务器。对于 Enterprise,则由合同约定。
- RedirHub 新用户:使用自托管 TLS 开始 Pro 试用。可免费使用 14 天。开始试用需要信用卡,在试用结束前不会收费。
- 已在 Pro 试用中:在仪表盘中将此附加功能添加到你的方案中。试用将继续进行,该附加功能在试用结束前免费,之后将随 Pro 一并计费。
- 正在使用付费 Pro:在仪表盘中将其添加到你的方案中。如果你的工作区尚未拥有它,Add domain 和 Connect 对话框也会提供该选项及其价格。
第 2 步:添加域名#
- 前往 Hostnames 并点击 Add domain。
- 输入域名或子域名,例如 app.example.com。
- 在“你将把它用于什么?”下,选择“仅 HTTPS,使用我自己的服务器”,然后点击“Add and set up servers”。接下来会打开其设置。
对于你已经添加的域名,打开 Connect,并在其他连接方式下选择“Use my own servers”。通过 API 或 MCP 服务器,创建 connection_mode 设置为 self_hosted 的域名。使用 Terraform provider(redirhub/redirhub 0.2.0 或更高版本)时,在 redirhub_domain 上设置 connection_mode;之后更改它会就地切换该域名:
hclresource "redirhub_domain" "shop" {
host = "shop.example.com"
connection_mode = "self_hosted"
}
# 等待直到你的服务器对此响应;其证书随后跟进。
resource "redirhub_domain_verification" "shop" {
host = redirhub_domain.shop.host
}第 3 步:在每台服务器上运行容器#
设置中显示了填入你的工作区令牌的命令。复制它并在每台服务器上运行:
bashdocker run -d --name redirhub-edge --restart unless-stopped --network host \
-v redirhub-edge:/data \
-e REDIRHUB_TOKEN=<your workspace token> \
redirhub/edge该容器占用 443 端口,并将每个请求转发到你应用的 80 端口,应用会像以前一样继续提供服务。在每台服务器上使用相同的令牌运行相同的命令;每个容器启动后,都会显示在“你的服务器”下。更新镜像时请保留该卷:它保存着服务器的身份和证书。
| Setting | Default | 它的作用 |
|---|---|---|
| REDIRHUB_TOKEN | 无(必填) | 你的工作区令牌。它仅允许服务器获取你工作区的证书,并证明你的各个域名。 |
| UPSTREAM | http://127.0.0.1:80 | 你的应用监听的地址。若应用使用其他端口,请添加 -e UPSTREAM=http://127.0.0.1:8080。 |
| HTTPS_PORT | 443 | 容器用于 HTTPS 的端口。只有在负载均衡器会将 443 端口转发到此端口时才更改它:Let’s Encrypt 和我们的检查会通过 443 访问你的域名。 |
| HTTP_PORT | off | 用于普通 HTTP 的端口。关闭后会让你的应用使用 80 端口。 |
| HTTP_MODE | redirect | HTTP_PORT 上的普通 HTTP 会得到什么:redirect 会将其重定向到 HTTPS,proxy 会将其转发到你的应用。 |
第 4 步:将 DNS 指向你的服务器#
- 在你的 DNS 提供商处,将域名的 A(以及 AAAA)记录设置为你的服务器地址。
- 也将 www 指向相同的服务器,这样它的证书也会覆盖 www。
- 对于像 *.example.com 这样的通配符域名,还要添加设置中显示的 CNAME 记录。它证明该通配符属于你,并让我们为其颁发证书。
然后我们会检查你的服务器。它们在 HTTPS 上对 /.well-known/host-verification 的首次响应证明该域名属于你;容器会自行响应。我们会颁发证书并将其同步到每台服务器,设置中会显示你的服务器使用它提供 HTTPS。续期也会自动送达它们。
如果设置显示问题#
| Message | 含义 | Fix |
|---|---|---|
| 无法连接到端口 443 | 该域名未能连接到在端口 443 上运行的容器。 | 检查其 A 或 AAAA 记录是否指向你的服务器,容器是否正在运行,以及防火墙是否允许端口 443。 |
| 端口 443 有响应,但不是此工作区的令牌 | 端口 443 上有其他服务在响应,或者该容器是使用其他令牌启动的。 | 停止其他 HTTPS 服务器,或将其移至容器后面的端口 80,然后使用设置中显示的令牌启动容器。 |
| 我们还没看到 CNAME 记录 | 通配符的 CNAME 记录缺失或尚未传播。 | 请按显示的内容准确添加记录。DNS 更改可能需要几分钟才会显示。 |
| 您的工作区不再包含自己的服务器 | 该附加组件已从套餐中移除。 | 请在一周内再次将自托管 TLS 添加到您的套餐中;之后,该域名将被释放。 |
替换令牌#
如果令牌已泄露,请在域名设置中点击“替换令牌”,然后使用新令牌在每台服务器上重新启动容器。继续使用旧令牌的服务器将停止接收证书。请从“您的服务器”中移除您不再使用的服务器。
免费试用自托管 TLS 使用自托管 TLS 开始使用 Pro:免费 14 天,最多支持 100 台服务器,为您签发并续期证书。
开始免费试用常见问题
不会。TLS 在你服务器上的容器中终止,该容器会将每个请求转发到你的应用程序。RedirHub 只负责签发和续期证书,并保持所有服务器同步。
可以。让它在 80 端口提供普通 HTTP 服务,并将 443 端口留给容器,由容器将每个请求转发给它。关闭这些域名的自有证书以及从 HTTP 到 HTTPS 的重定向。
可以,如果你在试用开始时就带上它,或在试用期间添加它。它在试用结束前都是免费的,然后会随 Pro 以每月 100 美元计费。
你的服务器会继续使用它们已经拥有的证书提供 HTTPS 服务。证书会在到期前很早就续期,因此短暂的故障不会导致证书失效。
每个 workspace 最多 100 台服务器,任意地区或云环境均可。更多数量请联系我们了解 Enterprise;价格按合同确定。
