域名部署与解析模式
巴克励步
域名部署决定访客如何通过自定义域名访问 Baklib 应用：流量是直接落到平台托管地址、经 CDN 加速回源，还是经客户自建 Nginx 反向代理回源。三种模式在 应用设置 → 域名管理 → 域名配置 中选择，与 站点聚合（路径前缀挂载）可组合使用，但解决的是不同层面的「入口」问题。
配图来源：操作手册实采（baklib.com，2026-07-04）。P1 专项「部署模式」切换界面待 Demo 登录后补拍。
是什么
绑定自定义域名后，除试用子域名外，每个域名需选定 部署/解析模式，并完成对应 DNS 或网关配置。平台会生成 CNAME 目标、回源地址或 Nginx 示例，列表中展示 已部署 / 未验证 等状态。
三种模式对比：
| 模式 | 流量路径（简化） | DNS 要点 | 典型场景 |
|---|---|---|---|
| 普通模式（CNAME） | 访客 → Baklib 托管入口 | 子域名 CNAME 到平台提供的 site-xxxx.cname.baklib.site |
标准官网、帮助中心；配置最少 |
| CDN 模式 | 访客 → CDN 边缘 → Baklib 回源 | 域名 CNAME 到 CDN 厂商提供的加速域名；部分场景可跳过平台 CNAME 校验（云防护接入） | 国内访问加速、全站 CDN；需配合防盗链与 portal_url 策略 |
| 反向代理模式 | 访客 → 客户 Nginx（带 Token）→ Baklib 回源 | 入口域名 A 记录 到自建服务器；Nginx 按示例转发 | 统一企业网关、安全合规、多站点聚合到同一域名不同目录 |
普通模式是默认路径：解析生效且验证通过后，平台可为该域名签发 HTTPS（见 域名证书）。CDN 模式在 v1.26+ 起与资源防盗链、仅生成 path 的
portal_url 等能力联动，避免 CDN 场景下链接带错 host 或图片防盗链失效。反向代理模式提供 入口域名、部署路径、Token 与完整 Nginx 配置片段，与 站点聚合 文档中的「同一域名多目录」方案一致。边界与限制
- 三种模式 互斥于单域名配置，变更模式通常需同步调整 DNS 与网关，并在低峰期切换。
- CDN 模式不等于「只开 CDN」：须在 Baklib 侧选对模式，并在 CDN 控制台完成回源、HTTPS 与缓存规则；全站加速时资源防盗链常需设为 永久（见 访问控制与授权）。
- 反向代理模式依赖客户维护 Nginx 与 Token；Token 泄漏须重置并同步改配置。真实客户端 IP 依赖代理头传递（平台已修复代理模式下 IP 识别问题）。
- 国内自定义域名通常需 ICP 备案；备案与 CDN 厂商细节不在本篇，见帮助中心「域名与访问」FAQ。
- 组织级试用域名、平台子域与自定义域名的证书策略不同（v1.24 起组织/试用域不再自动泛证书，须 CNAME 通过后才可绑定）。
典型场景
- 产品文档站快速上线：普通模式 + CNAME，一天内完成解析与 HTTPS。
- 大促或媒体发布：CDN 模式降低源站压力；发布前确认主题内链是否适配「仅 path」的 URL 生成策略。
- 金融/制造内网网关：反向代理模式，对外仅暴露
doc.company.com，回源 Token 鉴权；多产品线用/help、/docs等路径聚合（与站点聚合能力配合）。
相关操作
- 域名管理
- CNAME 记录是什么？如何为 Baklib 域名配置？
- 域名证书
- 站点聚合
- IP 限源访问 — 域名级策略