Caddy HTTPS / 域名与证书策略
域名与证书策略
s2 上所有 HTTPS 由 Caddy 统一处理,nb 只提供 ask 闸门。域名分两类,签发路径不同。
官方子域名
形如 <app>.nbjs.ai,由泛解析 *.nbjs.ai 直接指向 s2。
- Caddy 收到握手后回调
ask,nb 检查应用是否存在 - 通过则走 HTTP-01 签发单域证书,首次慢几秒,之后走缓存
- 到期前约 30 天自动续期,续期会再次问
ask
平台 apex nbjs.ai 同样由 ask 放行(对应 MAIN_APP)。
租户自定义域名
租户在应用控制台「域名」Tab 添加域名后,会写入 ~/.nb/domains.json;租户自行把 DNS CNAME 到 s2 或 cf_fallback。
ask只查这张映射表:命中才签发,未绑定直接拒绝握手- HTTP-01 要求 80 端口公网可达,DNS 生效前签发会失败,生效后首次访问自动重试
- 域名从
domains.json删除后不再续期,旧证书到期自然失效
Cloudflare 的云朵状态
官方 A 记录(nbjs.ai、*.nbjs.ai、fallback.nbjs.ai)用灰云(DNS only),让 LE 的 HTTP-01 和浏览器都直连 s2 的 Caddy。橙云下 Cloudflare 也能转发挑战,但多一层依赖,排障更麻烦。
hk1.nbjs.ai 这类指向 R2 的 CNAME 保持橙云即可,与平台 HTTPS 无关。
签发额度
Let's Encrypt 的限额按注册域名计算,例如 50 张/周属于 nbjs.ai:
- 给每个
<app>.nbjs.ai单独签会共享这个桶,应用多了会撞限额 - 租户自有域名属于各自注册域名,不占
nbjs.ai的额度
后续可选方案:
- 用 DNS-01 签一张
nbjs.ai + *.nbjs.ai通配证书挂到 Caddy 的第一个站点块,官方子域不再逐域签发;自定义域名继续 on_demand。 - 继续用 Cloudflare for SaaS 给租户自定义域名签证书,Caddy 只做反代。
安全边界
ask只监听127.0.0.1:3000,校验共享 token,公网访问被 Caddy 的@blocked挡掉/run、/assets、/mcp、/internal/mqtt/*同样不对公网开放- 证书私钥只存在 Caddy 的
/var/lib/caddy/.local/share/caddy/certificates,nb 不接触任何密钥