直接回答
开始带自托管边缘附加组件的 Pro 试用,或将它添加到 Pro。以“为我自己的网站提供 HTTPS”添加域名,在每台服务器上运行其设置中的容器,并将域名的 A 或 AAAA 记录指向这些服务器。您的服务器一旦应答,RedirHub 就会签发证书,此后持续续期;如果服务器停止应答,会发邮件通知您。您在该域名上添加的链接也会在您的服务器上跳转。
使用自托管边缘时,域名的 HTTPS 在您自己的服务器上终止,由位于应用前面的一个容器处理。RedirHub 会签发每个域名的证书、续期并同步到每一台服务器,因此您无需运行 ACME 客户端或续期任务。访客直接访问您的服务器,从不经过 RedirHub。
同一个容器会像 RedirHub 自己的网络一样,处理您在该域名上添加的每一个链接:跳转、短链接、二维码、自定义 HTML 页面和带密码的链接。某个路径的链接会在应用响应之前跳转,兜底规则只接管应用返回的 404,访问和 404 都会显示在统计里。只要 HTTPS?不添加链接即可,所有请求都会发往您的应用。
开始之前#
- 一台安装了 Docker、可从互联网通过 443 端口访问的服务器。80 端口仍留给您的应用。
- 您的应用,或 Caddy、nginx 等代理,在服务器的 80 端口上响应普通 HTTP。使用其他端口也可以,只需一项设置。
- 您在工作区中的管理员角色:只有管理员才能看到包含工作区服务器令牌的命令。
第 1 步:获取自托管边缘附加组件#
自托管边缘是 Pro 的附加组件,$100/月,最多 100 台服务器。在 Enterprise 中由合同约定。
- 初次使用 RedirHub:开始带自托管边缘的 Pro 试用。免费 14 天。开始时需要绑定银行卡,试用结束前不会扣任何费用。
- 已在 Pro 试用中:在控制台中将附加组件添加到您的方案。试用继续进行,附加组件在试用结束前免费,之后与 Pro 一起计费。
- 已是付费 Pro:在控制台中将其添加到您的方案。如果工作区还没有该附加组件,“添加域名”和“连接”对话框也会提供它,并显示价格。
第 2 步:添加域名#
- 进入“域名”页面,点击“添加域名”。
- 输入域名或子域名,例如 app.example.com。
- 在“你打算用它做什么?”下选择“为我自己的网站提供 HTTPS”,然后点击“添加并设置服务器”。接着会打开其设置。
对于已添加的域名,打开“连接”,在“在我自己的服务器上”下选择“使用我自己的服务器”。通过 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"
}
# Waits until your servers answer for it; its certificate follows.
resource "redirhub_domain_verification" "shop" {
host = redirhub_domain.shop.host
}第 3 步:在每台服务器上运行容器#
在“你的服务器要做什么”下,设置会列出容器要做的事,并据此生成命令:域名的链接、应用的 404 上报、80 端口转到 HTTPS,以及应用监听的端口。复制已填好服务器令牌的命令,并在每台服务器上运行:
bashdocker run -d --name redirhub-edge --restart unless-stopped --network host \
-v redirhub-edge:/data \
-e REDIRHUB_TOKEN=<your server token> \
redirhub/edge容器占用 443 端口,并将每个请求转给 80 端口上的应用,应用照常提供服务。在每台服务器上用同一个令牌运行同一条命令;容器启动后,每台服务器都会出现在“你的服务器”中。更新镜像时请保留数据卷:其中保存着服务器的身份、证书和链接的最新副本。
| 设置 | 默认值 | 作用 |
|---|---|---|
| REDIRHUB_TOKEN | 无(必填) | 您工作区的服务器令牌。它只允许服务器获取工作区的证书和链接,并证明您的每个域名,不能做其他事。 |
| UPSTREAM | http://127.0.0.1:80 | 应用监听的地址。应用在其他端口时:-e UPSTREAM=http://127.0.0.1:8080。 |
| PORT_HTTPS | 443 | 容器用于 HTTPS 的端口。只有在将 443 端口透传到该端口的 TCP 负载均衡器后面时才需修改:Let’s Encrypt 和我们的检查都通过 443 访问您的域名。 |
| PORT_HTTP | off | 用于普通 HTTP 的端口,例如 80。off 会把 80 端口留给您的应用。 |
| ALWAYS_HTTPS | on | PORT_HTTP 上的普通 HTTP 如何处理:on 将其跳转到 HTTPS(301),off 则像 HTTPS 一样处理(先是链接,再是应用)。 |
| LINKS | on | off 表示这些服务器不处理任何链接:只提供 HTTPS,所有请求都发往您的应用。 |
| REPORT_404 | on | off 表示这些服务器不上报应用的任何 404。 |
| PORT_HEALTH | off | 供负载均衡器健康检查使用的端口:服务器拿到您的证书后,GET /ready 返回 200。 |
| PROXY_PROTOCOL | off | 用于发送 PROXY 协议的 TCP 负载均衡器后面:填写它的地址或地址段,例如 10.0.0.0/8,这样您的应用就能看到访客的地址。 |
如需改变请求到达应用的方式,可将您自己的文件挂载到 /etc/edge/:proxy.conf 会替换生成的代理设置,http.d/ 和 server.d/ 中的文件会加入 http 块和您域名的 server 块(例如包含多台应用服务器的 upstream,或 HSTS 头)。容器启动前会检查这些文件,并指出无法加载的那一行。
第 4 步:将 DNS 指向您的服务器#
- 在您的 DNS 服务商处,将域名的 A(和 AAAA)记录设为服务器的地址。
- 将 www 也指向同一批服务器,证书便会同时覆盖 www。
- 对于 *.example.com 这样的泛域名,还要添加设置中显示的 CNAME 记录。它证明该泛域名归您所有,并让我们能为其签发证书。泛域名只获得证书,不支持链接。
之后我们会检查您的服务器。它们通过 HTTPS 在 /.well-known/host-verification 上的应答可证明该域名归您所有;容器会自动应答。我们签发证书并同步到每台服务器,设置中会显示您的服务器正在用它提供 HTTPS。续期和链接变更会在几秒内自动到达。
您服务器上的跳转和 404#
- 某个路径的链接会先于应用跳转,即使该页面存在也是如此。在 RedirHub 中添加一个链接,即可下线或迁移页面,无需发布新版应用。
- 兜底规则只接管应用返回的 404:正常工作的页面绝不会被接管,应用里已不存在的页面则会跳到兜底规则指定的地址。
- 应用的 404 会被上报,并与链接的访问一起显示在统计里。可在 RedirHub 中为该域名关闭 404 上报,或在服务器上设置 REPORT_404=off。
- 各类链接都能在您的服务器上运行:容器运行的是与 RedirHub 网络相同的跳转引擎,因此自定义 HTML 页面、框架跳转和带密码的链接的表现与使用 RedirHub DNS 时完全一样。您添加、修改或暂停的链接会在几秒内到达每台服务器。
如果无法访问 RedirHub,您的服务器会继续使用已有的证书和链接提供服务。
监控#
我们会定期检查您服务器上的每个域名,当有事需要您处理时,会发邮件给工作区的所有者和管理员:
- 服务器停止应答:当您的所有服务器都已一小时未为某个域名应答时,发送一封邮件,列出所有受影响的域名。如果持续 7 天无应答,该域名会被释放,您会再收到一封邮件;重新启动容器,它就会自动重新连接。
- 证书无法续期:续期在到期前几周开始,并会自动重试。如果证书只剩 14 天时 Let’s Encrypt 仍无法通过 443 端口访问容器,我们会发邮件告知您到期日期,每天最多一封。
这些是域名状态邮件:可在“邮件偏好”中关闭。
如果设置中显示问题#
| 提示 | 含义 | 解决方法 |
|---|---|---|
| 无法连接 443 端口 | 该域名无法访问到 443 端口上正在运行的容器。 | 检查它的 A 或 AAAA 记录是否指向您的服务器、容器是否在运行(docker ps),以及防火墙是否允许 443 端口。 |
| 443 端口有响应,但不是这个工作区的令牌 | 443 端口上有其他程序在应答,或容器是用其他令牌启动的。 | 停止另一个 HTTPS 服务器,或将其移到容器后面的 80 端口,并用设置中显示的令牌启动容器。 |
| 我们还没看到这条 CNAME 记录 | 泛域名的 CNAME 记录缺失或尚未生效。 | 完全按显示内容添加该记录。DNS 更改可能需要几分钟才能生效。 |
| 你的工作区已不再包含自有服务器 | 该附加组件已从方案中移除。 | 在一周内将自托管边缘重新添加到方案;超过一周,该域名将被释放。 |
更换令牌#
如果令牌已泄露,请在域名设置中点击“更换令牌”,然后在每台服务器上用新令牌重新启动容器。仍使用旧令牌的服务器将不再收到证书和链接变更。不再使用的服务器请从“你的服务器”中移除。
免费试用自托管边缘 开始带自托管边缘的 Pro:免费 14 天,最多 100 台服务器,证书由我们为您签发和续期,链接在您的服务器上运行。
开始免费试用常见问题
不会。TLS 在您服务器上的容器内终止,容器应答您的链接,并把其余请求转给您的应用。RedirHub 负责签发和续期证书,将证书和链接同步到每台服务器,并接收访问次数和 404 次数。
可以。让它在 80 端口上提供普通 HTTP,把 443 端口留给容器,容器会把每个请求转给它。对这些域名关闭它自己的证书和 HTTP 到 HTTPS 的跳转。
包含,只要您在开始试用时选择它,或在试用期间添加它。试用结束前免费,之后按 $100/月与 Pro 一起计费。
您的服务器会用已有的内容继续提供 HTTPS 和链接。证书会在到期前很久就完成续期,因此短暂中断绝不会导致证书过期。
可以。不在该域名上添加链接,或用 -e LINKS=off 启动容器,所有请求就会发往您的应用。用 -e REPORT_404=off 关闭 404 上报。
每个工作区最多 100 台服务器,可部署在任意地区或云平台。需要更多时,请与我们联系 Enterprise 方案;价格按合同确定。
