语雀自定义域名配置需五步：一、知识库设置中启用并填写域名且勾选https；二、dns添加cname记录指向yuque.com；三、用dig命令验证解析生效；四、等待或手动重发let’s encrypt证书；五、排除a记录冲突、权限限制及证书名称错误。
如果您已拥有语雀知识库并希望使用自有域名访问，但尚未完成域名绑定与解析设置，则可能是由于DNS配置未生效或语雀后台未正确启用自定义域名功能。以下是完成语雀自定义域名配置的具体操作步骤：
一、在语雀知识库中启用并填写自定义域名
该步骤用于在语雀服务端登记目标域名，并触发HTTPS证书自动签发流程，确保后续访问可安全加载。
1、登录语雀官网，进入对应知识库的「设置」页面。
2、点击左侧菜单中的「自定义域名」选项。
3、在输入框中填写您准备使用的完整域名（例如：docs.example.com），注意不可包含协议头（如 https://）或路径。
4、勾选「启用 HTTPS」选项，点击「保存」。
二、配置DNS CNAME记录指向语雀CDN节点
该步骤将您的域名解析请求导向语雀提供的全球CDN服务地址，是实现域名访问的核心网络层操作。
1、在语雀「自定义域名」设置页下方，复制系统生成的CNAME目标值（格式通常为：xxx.yuque.com）。
2、登录您的域名注册商或DNS服务商管理后台（如阿里云DNS、腾讯云DNSPod、Cloudflare等）。
3、找到对应域名的DNS解析设置区域，添加一条新的CNAME记录。
4、主机名（Name/Host）填写子域名部分（例如：docs），记录值（Value/Target）粘贴上一步复制的CNAME目标值。
5、TTL值建议设为默认或300秒，保存记录。
三、验证DNS解析是否生效
该步骤用于确认本地及公共DNS系统已正确获取CNAME映射关系，避免因缓存延迟导致配置看似失败。
1、在终端（macOS/Linux）或命令提示符（Windows）中执行：dig docs.example.com CNAME +short（将 docs.example.com 替换为您的实际域名）。
2、若返回结果为语雀提供的CNAME地址（如 xxx.yuque.com），说明解析已生效。
3、若无返回或返回原始IP，等待DNS缓存刷新（通常1–2小时），或尝试更换DNS服务器（如 8.8.8.8 或 1.1.1.1）后重试。
四、处理HTTPS证书部署延迟问题
语雀依赖Let’s Encrypt自动签发SSL证书，首次绑定后证书生成存在异步延迟，期间可能显示不安全警告或无法加载。
1、保存CNAME记录后，返回语雀「自定义域名」页面，观察状态栏是否显示「证书生成中」或「证书已就绪」。
2、若超过2小时仍显示「证书生成中」，检查CNAME是否拼写错误、是否误配为A记录、或域名是否被其他服务占用。
3、确认无误后，可点击页面上的「重新签发证书」按钮手动触发流程。
五、排除常见访问异常原因
即使DNS与证书均正常，仍可能出现页面空白、跳转回yuque.com或404等现象，需逐项排查基础配置冲突。
1、确认未在DNS中同时配置同名A记录或URL转发规则，二者会与CNAME产生冲突并导致解析失败。
2、检查知识库权限设置：若知识库为「私密」或「指定成员可见」，则自定义域名访问时仍需登录语雀账号，未登录状态下将跳转至登录页或返回404。
3、在浏览器中访问 https://docs.example.com 时，若出现NET::ERR_CERT_COMMON_NAME_INVALID，说明证书尚未覆盖该域名，需等待或重新触发签发。
