在Gitee（码云）中设置自定义域名主要涉及Pages服务或Webhook配置两类场景。以下为详细操作指南及相关扩展内容：
一、Pages 服务绑定自定义域名（静态网站托管）
1. 前置条件：确保仓库已开启Gitee Pages服务并生成初始访问地址（如：username.gitee.io/repo-name）。
2. 域名解析配置：在域名服务商（阿里云、腾讯云等）添加以下记录：
| 记录类型 | 主机记录 | 记录值 | 用途 |
|---|---|---|---|
| CNAME | www（或子域名） | username.gitee.io | 将子域名指向Pages服务 |
| A | @（根域名） | Gitee Pages IP（例：180.97.125.221） | 支持根域名访问（需Gitee企业版） |
3. Gitee 后台绑定：
- 进入仓库 → 「服务」→「Gitee Pages」
- 在「自定义域名」栏填写已解析的域名（如：www.example.com）
- 勾选「强制HTTPS」（Gitee自动签发SSL证书）
4. 生效验证：等待DNS生效（通常10分钟~24小时），访问域名即可查看部署内容。
二、Webhook 域名配置（API回调）
用于第三方服务（如CI/CD工具）触发仓库动作：
- 进入仓库 → 「管理」→「WebHooks」
- 填写目标服务提供的回调URL（需公网可访问）
- 选择触发事件（Push、Merge等）并保存
三、注意事项与扩展知识
| 分类 | 说明 | 支持版本 |
|---|---|---|
| 备案要求 | 国内域名需完成ICP备案方可解析 | 所有用户 |
| HTTPS证书 | 自动签发，无需手动上传 | Pages服务 |
| 根域名绑定 | 仅企业版支持（A记录解析） | 企业版 |
常见问题排查：
- 域名未生效：检查DNS解析状态（使用dig/nslookup命令）
- HTTPS错误：等待证书签发（最长24小时）
- 频繁触发Pages构建：避免在代码中保存域名绑定记录（易触发循环构建）
扩展建议：若需更高阶配置（如CDN加速、自定义404页面），可结合Gitee企业版或通过构建脚本注入HTTP头实现。
查看详情
查看详情
