在码云 Pages 仓库开启服务并填写自定义域名后，到域名服务商处添加一条 CNAME 记录指向 你的用户名.gitee.io，等待解析生效，即可通过绑定域名直接访问静态页面。
码云 Pages 绑定域名后无法访问？先理清访问链路
绑定域名后访问不了,多数情况下不是 Gitee 服务端问题，而是解析链路或备案状态卡住，比如把默认地址 lixiaoming.gitee.io 换成 www.lixiaoming.cn 后打不开，先别急着改代码，按下面链路排查。
访问过程一共四个环节：
- 浏览器输入
www.你的域名.com - DNS 解析请求到达域名服务商
- CNAME 记录把请求指向
你的用户名.gitee.io - Gitee Pages 服务器根据请求返回仓库静态页面
四个环节中任意一步配置错误,都会导致无法访问，最常出问题的是 CNAME 记录没有生效，以及域名未完成备案，如果浏览器提示“无法找到服务器”，多半是 DNS 还没解析到 Gitee，如果页面显示 502 或 404，说明解析已到 Gitee，但仓库 Pages 状态可能异常。
Gitee Pages 自定义域名解析设置：CNAME 记录这样填
解析设置的核心就是 CNAME 记录，下面按实际操作顺序拆开。
先确认仓库 Pages 服务已开启
仓库名必须和用户名一致,才会生成默认的 用户名.gitee.io 地址，假设你的 Gitee 用户名为 lixiaoming，仓库名也要叫 lixiaoming。
- 进入仓库,点击顶部“服务”菜单
- 找到“Gitee Pages”
- 选择部署分支,通常选
master或main - 点击启动,等待默认
.gitee.io地址可以正常打开
默认地址测试通过后再绑定自定义域名,能降低排查难度，业内专家指出，先把默认域名跑通，再改自定义域名，是减少解析故障的有效顺序。
在 Gitee Pages 填入自定义域名
默认地址能访问后,回到 Gitee Pages 设置页操作：
-
找到“自定义域名”输入框
- 建议先填
www.你的域名.com，而不是根域名 - 保存后,平台会提示需要解析校验
为什么优先用 www 子域名？因为部分 DNS 服务商不允许根域名直接添加 CNAME，容易造成解析冲突，绑定 www 后，根域名再用显性跳转或 301 指向 www 地址即可，填根域名不是不能用，但遇到简米云、酷番云的部分解析套餐，可能出现 CNAME 与 MX 记录冲突。
到 DNS 服务商添加 CNAME 记录
登录简米云云解析、酷番云 DNSPod 或其它域名解析平台，找到对应域名的解析设置页面。
| 配置项 | 说明 | |
|---|---|---|
| 记录类型 | CNAME | 不能选 A 或 AAAA |
| 主机记录 | www | 绑定根域名时填 @ |
| 记录值 | 你的用户名.gitee.io | 替换为实际用户名 |
| 解析线路 | 默认 | 特殊网络可再添加境外线路 |
| TTL | 600 秒 | 建议先调低，方便测试 |
记录值这里最容易填错,很多人会顺手写成 www.lixiaoming.gitee.io，但正确值是 lixiaoming.gitee.io，不要在前面加 www，也不能填成 https://lixiaoming.gitee.io。
保存后,不要反复修改记录值，部分 DNS 生效时间在十分钟以内，部分可能更久，通常等待五到十五分钟即可测试。
本地验证解析是否指向 Gitee
在电脑终端执行命令：
nslookup www.你的域名.com- 或
dig www.你的域名.com CNAME
如果返回结果里出现 你的用户名.gitee.io，说明 CNAME 已经生效，若返回的还是旧记录或 NXDOMAIN，继续等待或检查主机记录是否只填了 www，没有填成 www.你的域名.com。
解析生效后,回到 Gitee Pages 页面刷新自定义域名状态，平台检测通过后会自动签发 HTTPS 证书，这一过程可能持续几分钟到几小时。
码云 Pages 域名必须备案吗？备案与访问关系
据工信部备案相关规定,使用境内服务器提供网站服务需要完成 ICP 备案，Gitee Pages 的静态页面托管服务部署在境内节点，因此绑定自定义域名访问，域名本身通常需要已备案。
- 未备案域名：多数情况下无法通过 Gitee Pages 自定义域名校验
- 已备案域名：解析正确后，访问链路基本畅通
- 默认
.gitee.io地址：不绑定自定义域名时，访问不受备案限制，但公开访问策略可能调整
如果你的域名还未备案,先提交备案申请比反复排查 DNS 更有用，行业共识认为，国内代码托管平台的 Pages 自定义域名功能，实质上是为已备案域名提供更可读的品牌访问入口。
码云 Pages 绑定域名后 HTTPS 访问异常怎么处理
绑定域名后,常见现象是 HTTP 能打开，HTTPS 提示证书错误或连接被重置，不同现象对应不同原因。
| 现象 | 可能原因 | 处理方式 |
|---|---|---|
| HTTPS 提示证书错误 | 证书尚未签发完成 | 等待几分钟到几小时 |
| HTTP 正常，HTTPS 打不开 | 本地 HSTS 缓存旧状态 | 使用无痕窗口测试 |
| 手机能访问，电脑不行 | DNS 缓存不一致 | 更换网络或清除 DNS 缓存 |
| 提示域名未绑定 | Pages 校验未通过 | 重新检查 CNAME 记录值 |
实测时,建议按“先 HTTP、后 HTTPS、再强制跳转”的顺序测试，HTTPS 正常后，再到 Gitee Pages 设置中开启强制 HTTPS，能让访问更稳定。
默认域名与自定义域名对比：什么场景值得绑定
很多开发者一开始只用默认的 用户名.gitee.io，等需要对外展示时才绑定自己的域名，两者差异如下：
| 对比项 | 默认 gitee.io 地址 | 自定义域名 |
|---|---|---|
| 访问地址 | 用户名.gitee.io |
www.你的域名.com |
| 是否需要备案 | 不需要 | 通常需要 |
| 绑定复杂度 | 无需绑定 | 需 DNS 解析与平台校验 |
| 证书管理 | 平台自动处理 | 平台自动签发 |
| 适用场景 | 临时预览、内部测试 | 正式作品集、文档站 |
不只是个人作品集,很多团队把产品文档、开源项目主页、活动落地页放在 Gitee Pages 上，再用自定义域名统一品牌入口，此时用 www 子域名配合根域名 301 跳转，是较省心的方案。
Q&A：码云 Pages 自定义域名常见问题
码云 Pages 绑定域名后无法访问，ping 不通怎么办？
先确认 CNAME 记录是否添加正确，再用 nslookup 检查返回是否指向 你的用户名.gitee.io，ping 不通但 nslookup 已经返回 Gitee 地址，可能是目标 IP 禁止 ICMP，不代表网页不可访问，若 nslookup 仍无结果，检查主机记录是否填成 www.域名 而非只填 www。
Gitee Pages 自定义域名解析设置后多久能访问？
CNAME 记录生效通常需要五到十五分钟，但 Gitee Pages 的自定义域名校验和 HTTPS 证书签发可能额外需要几分钟到几小时，多数情况下，半小时内可以完成从解析到访问的全过程。
码云 Pages 绑定域名必须用 www 吗？
不是必须,DNS 服务商支持根域名 CNAME，可以绑定根域名，但部分国内解析平台对根域名 CNAME 支持不完善，容易与邮件记录冲突，www 子域名是更稳的选择。
绑定域名访问的核心只有两条：Gitee Pages 仓库状态正确，DNS 的 CNAME 指向正确，先把默认 .gitee.io 地址跑通，再绑定 www 域名并等待证书签发，基本能解决大多数访问问题。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/article/639707.html
