NB文档doc.nbjs.ai
Caddy HTTPS / 域名与证书策略

域名与证书策略

s2 上所有 HTTPS 由 Caddy 统一处理,nb 只提供 ask 闸门。域名分两类,签发路径不同。

官方子域名

形如 <app>.nbjs.ai,由泛解析 *.nbjs.ai 直接指向 s2。

平台 apex nbjs.ai 同样由 ask 放行(对应 MAIN_APP)。

租户自定义域名

租户在应用控制台「域名」Tab 添加域名后,会写入 ~/.nb/domains.json;租户自行把 DNS CNAME 到 s2 或 cf_fallback。

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:

后续可选方案:

  1. 用 DNS-01 签一张 nbjs.ai + *.nbjs.ai 通配证书挂到 Caddy 的第一个站点块,官方子域不再逐域签发;自定义域名继续 on_demand。
  2. 继续用 Cloudflare for SaaS 给租户自定义域名签证书,Caddy 只做反代。

安全边界