Coding Pages是Coding平台提供的静态网站托管服务，配合Git仓库可以很方便地把Hexo、Hugo、VuePress等框架生成的静态站点发布上线。默认情况下，系统会分配一个类似xxx.coding.me的二级域名，如果想用自己购买的域名访问站点，就需要完成域名绑定。整个过程说复杂不复杂，但涉及域名服务商和Coding两端配合，任何一环配置不对都会导致访问失败。下面我们把整个流程和常见坑点完整梳理一遍。
一、绑定前的准备工作
在动手配置之前，需要先确认两件事：一是你已经拥有一个域名，二是Coding Pages上的站点已经能够通过默认域名正常访问。域名可以在阿里云、腾讯云、GoDaddy等任意服务商购买，国内服务商的域名如果解析到国内节点，通常还需要完成实名认证和备案，这一点后面会详细说明。
先检查默认域名是否正常。打开Coding项目，进入「Pages设置」页面，确认站点已经构建成功并且部署状态正常。如果默认域名都打不开，说明构建或部署环节有问题，应该先解决这个基础问题，否则绑定自定义域名后同样无法访问。
另外建议提前想好最终访问用的域名形式。常见有两种：一种是顶级域名ippipp.com，另一种是www.ippipp.com子域名。推荐使用www形式作为主域名，同时把顶级域名301跳转过去，这样对搜索引擎更友好，后续配置CDN或HTTPS也更灵活。
二、域名解析配置的正确姿势
绑定域名的核心环节是在域名服务商的控制台添加DNS解析记录。以添加CNAME记录为例，登录域名管理后台，找到「解析设置」或「DNS管理」入口，添加一条记录：记录类型选择CNAME，主机记录填写www（如果要用顶级域名则填写@），记录值填写Coding Pages给你分配的默认域名。
记录类型: CNAME 主机记录: www 记录值: your-project.coding.me TTL: 600（默认即可）
这里有一个高频踩坑点：顶级域名理论上不能直接设置CNAME记录（因为这会与SOA记录冲突），部分国内服务商不允许对@主机记录添加CNAME。解决方案有两种：一是使用服务商提供的显性URL转发，把ippipp.com跳转到www.ippipp.com；二是如果服务商支持显性URL跳转，直接添加记录类型为「显性URL」的解析即可。切记不要给@记录强行填CNAME，否则可能导致整个域名的MX等记录全部失效，影响邮箱服务。
添加记录后，DNS解析生效需要时间，一般10分钟到1小时不等，最长可能24小时。可以用命令行工具验证是否生效：
# 查询CNAME解析结果 nslookup -type=cname www.ippipp.com # 或者使用dig dig www.ippipp.com CNAME +short
如果返回的结果中包含了你的Coding Pages默认域名，说明解析已经生效，可以进行下一步。
三、在Coding Pages中添加自定义域名
解析生效后，回到Coding项目的「Pages设置」页面，找到自定义域名配置区域，把自己的域名填进去并保存。平台会校验解析记录，只有当DNS解析正确指向它分配的域名时，绑定才会成功。
绑定成功后，建议在仓库中创建一个CNAME文件（没有扩展名），内容就写你的域名：
www.ippipp.com
这个文件的作用是让每次重新部署时域名配置不被覆盖。如果使用Hexo等静态框架，直接把CNAME文件放到source目录下即可，这样每次执行hexo generate后它都会被复制到public目录一起发布。没有这个文件的话，某些情况下重新部署后会发现自定义域名绑定丢失，需要重新手动设置。
保存后等待平台重新部署一次，然后浏览器访问你的域名测试。如果能打开网站且内容正确，基本绑定就完成了。如果访问报错，先清一下本地DNS缓存再试：ipconfig /flushdns（Windows）或sudo dscacheutil -flushcache（macOS）。
四、HTTPS证书与强制跳转设置
域名绑定成功后，强烈建议开启HTTPS。在Pages设置中找到HTTPS相关选项，点击申请证书。平台通常会通过Let's Encrypt自动签发证书，前提是你的域名解析已经完全生效，否则证书申请会失败。如果申请失败，等解析彻底生效后再重试即可。
证书签发成功后，可以打开「强制HTTPS」开关，这样所有HTTP请求都会被重定向到HTTPS，既安全又有利于SEO。需要注意证书有效期一般是90天，不过平台会自动续期，不需要手动干预。如果发现证书即将过期没有续上，可以尝试关闭再重新开启强制HTTPS触发一次证书更新。
浏览器提示证书错误常见原因有三种：一是解析还没生效就去申请了证书；二是解析记录写错了IP或域名；三是浏览器缓存了旧的证书信息，可以换个浏览器或者无痕模式测试排查。
五、国内访问与备案问题
这是最容易被新手忽略的一点。如果你的域名解析到Coding Pages的国内节点，那么根据相关规定，域名必须完成ICP备案才能正常访问，否则会被拦截提示。备案需要在你购买服务器的服务商处提交，流程通常需要一到两周。
如果不想备案，可以选择把站点部署到海外节点，或者在Pages设置中切换加速区域为海外。海外节点不需要备案，但国内访问速度会稍慢一些，可以根据自己站点的受众群体权衡。个人博客类站点如果主要面向国内用户，建议老老实实完成备案，访问稳定性和速度都更有保障。
另外提醒一句，如果域名是在国外服务商购买但要做国内备案，流程会麻烦一些，部分备案渠道要求域名必须在国内注册商名下，可以先做域名转入再备案。
六、常见问题快速排查表
最后把高频问题汇总一下，遇到故障时按表对照排查：
| 现象 | 可能原因 | 解决办法 |
|---|---|---|
| 域名无法访问 | DNS未生效或记录填错 | 用nslookup检查解析，核对记录值 |
| 访问显示默认页面 | 未重新部署或CNAME文件缺失 | 补充CNAME文件并触发重新部署 |
| 证书申请失败 | 解析未完全生效 | 等待解析生效后重新申请 |
| 浏览器报证书错误 | 证书未签发或缓存问题 | 检查证书状态，换无痕模式测试 |
| 重新部署后域名失效 | 仓库缺少CNAME文件 | 在source目录添加CNAME文件 |
| 提示需备案 | 国内节点未备案 | 完成ICP备案或切换海外节点 |
总的来说，绑定自定义域名的关键在于三步走：先在域名服务商处配好CNAME解析，再在Coding Pages后台添加域名并放置CNAME文件，最后申请HTTPS证书并开启强制跳转。每一步完成后都验证一下再进行下一步，出问题时排查范围会小很多。配置完成后，你的静态站点就能通过自己的域名稳定对外提供服务了。
Coding Pages自定义域名域名绑定修改时间：2026-09-09 01:14:53