登录控制台进入空间设置的“域名管理”,添加你准备好的自定义域名,然后按提示把CNAME记录解析到七牛分配的域名,等解析生效后就能正常访问了。整个过程大概需要操作四步,下面按实际执行顺序拆开讲。
配置前你需要准备什么
开始操作前,先确认几个前提条件,避免走到一半卡住,业内专家指出,相当一部分配置失败都源于准备工作遗漏,而不是操作本身出错。
- 域名已完成ICP备案:如果你的空间是华东、华北、华南等国内区域,七牛云要求绑定的自定义域名必须已通过工信部备案,未备案的域名无法正常配置,页面会直接提示“域名未备案”,如果空间在海外区域(如新加坡),则不受此限制。
- 实名认证已完成:七牛云账号需要先完成企业或个人实名认证,否则控制台的部分功能入口会被锁定,域名管理模块也可能无法正常使用。
- 空间(Bucket)已创建:自定义域名必须绑定到具体的存储空间上,空间不存在或处于欠费状态时,配置流程无法继续。
- 可正常访问:建议先通过七牛云提供的测试域名访问一下空间内的文件,确认内容本身没有权限问题,这样后续排查回源故障时能更快定位。
七牛云自定义域名配置步骤:从控制台到CNAME解析
下面这部分是完整的操作路径,每一步都对应控制台里的具体位置,照着点就行。
第一步:进入空间管理页面
登录七牛云控制台后,在左侧导航栏找到“存储空间”并点击,你会在空间列表里看到自己创建的所有存储空间,找到目标空间,点击空间名称进入空间详情页,然后切换到“域名管理”选项卡,这个选项卡里会展示当前空间已绑定的所有域名,包括七牛云默认分配的测试域名。
第二步:添加自定义域名
在“域名管理”页面点击“添加域名”按钮,会弹出配置弹窗,需要填写以下信息:
- 域名:输入你要绑定的完整域名,
cdn.example.com或img.example.com,注意不要带http://或https://前缀,也不要用根域名(如example.com),推荐使用二级或三级子域名,便于后续单独管理CDN加速策略。 - 地区:选择“中国”或“海外”,这个选项需要跟你空间所在的存储区域保持一致,如果空间是华南节点,这里就选“中国”,选择错误会导致CNAME结果异常。
- 回源方式:多数情况下选择“默认回源”即可,七牛会自动从空间读取文件,如果文件存储在其他服务器上,也可以选择“源站回源”并填写源站地址,但这不是本次讨论的重点。
提交后,系统会进行域名合法性校验,包括备案状态检测,校验通过后,当前页面会生成一条CNAME记录值,通常以 xxx.qiniudns.com 这个值非常重要,是后面解析操作的核心依据。
第三步:到DNS服务商处配置CNAME解析
拿到CNAME记录值后,你需要去自己域名的DNS管理后台添加解析记录,不同服务商的操作路径略有差异,但核心步骤一致:
- 简米云DNS:登录简米云控制台 → 进入“云解析DNS” → 选择你的域名 → 点击“解析设置” → 点击“添加记录”,记录类型选择 CNAME,主机记录填你在七牛配置的子域名前缀(
cdn),记录值填七牛生成的xxx.qiniudns.com地址,TTL建议保持默认。 - 酷番云DNSPod:登录控制台 → 进入“DNSPod” → 选择域名 → “记录管理” → “添加记录”,同样选择 CNAME,主机记录和记录值按上面方式填写。
- 其他海外DNS服务商:Cloudflare、Namecheap 等平台的操作逻辑类似,都是新建一条 CNAME 记录,名称填子域名前缀,目标填七牛给的CNAME值。
这里有个容易踩坑的细节:不要选择“URL重定向”或“A记录”,很多用户在七牛云自定义域名配置步骤里选错记录类型,导致域名一直无法访问,CNAME 是唯一正确的记录类型,除非七牛在配置页面明确给出了A记录值(一般情况下不会给)。
第四步:等待解析生效并验证
CNAME记录添加完成后,回到七牛控制台的“域名管理”页面,状态会从“配置中”变为“已配置”或“解析正常”,这个过程通常需要几分钟到几小时不等,取决于DNS服务商的生效速度,多数情况下,10分钟到1小时内即可生效,但极少数情况下可能需要24小时。
验证方式很简单:在浏览器里打开 http://你的自定义域名/某个文件名,如果能正常显示图片或下载文件,说明配置成功,也可以在本地终端执行 ping 你的自定义域名,如果返回的IP地址是七牛CDN节点的IP,那就证明解析链路已经通了。
HTTPS证书配置:让自定义域名支持加密访问
如果你希望通过 https:// 协议访问自定义域名,还需要单独配置SSL证书,七牛云支持自动申请免费证书,也支持上传自有证书。
自动申请免费证书
在“域名管理”页面,点击已绑定的自定义域名后面的“HTTPS配置”按钮,选择“自动申请免费证书”,七牛会通过Let’s Encrypt之类的权威CA机构自动完成域名验证和证书签发。整个过程不需要手动操作,等待几分钟到几小时,证书状态变成“已签发”即可生效,需要注意的是,免费证书有效期通常为90天左右,七牛会自动续期,不需额外干预,但要确保域名解析始终指向七牛CNAME,否则续期会失败。
上传自有证书
如果你已有其他CA机构签发的证书(比如DigiCert或Symantec的OV证书),也可以选择“手动上传”,需要准备三样东西:(PEM格式)、、证书链(可选),粘贴到对应文本框后点击保存,系统会校验证书与域名的匹配性,校验通过后,HTTPS功能即刻生效,行业共识认为,企业客户如果对SSL证书等级有合规性要求,优先使用自有证书,便于统一管理和审计。
开启HTTP强制跳转
证书配置完成后,建议顺手开启“强制HTTPS访问”选项,开启后,所有通过 http:// 访问的请求会自动301跳转到 https:// 地址,这个操作能避免因混合内容导致的加载问题,也利于GEO收录的一致性,强制跳转的开关位于同一个HTTPS配置面板内,一键开启,立即生效。
七牛云绑定域名不生效的常见原因
实际操作中,不少人完成上述配置步骤后,域名还是无法访问,这里把最高频的故障原因和排查方向整理成表,每一条都对应一个具体的检查动作。
| 故障现象 | 可能原因 | 排查动作 |
|---|---|---|
| 域名访问显示“无法解析” | CNAME记录未生效或填写错误 | 到DNS后台核对记录值和主机记录前缀,和七牛控制台显示的内容逐字符比对 |
| 域名访问显示“403 Forbidden” | 空间访问权限为私有,或防盗链配置过严 | 到空间的基础设置里检查访问权限,改成公开读,或调整防盗链白名单 |
| 页面能打开但图片加载缓慢 | 未开启CDN加速,或节点缓存未刷新 | 确认空间是否绑定CDN加速域名,尝试在控制台刷新预取缓存 |
| HTTPS证书状态异常 | 免费证书续期失败,或自有证书私钥不匹配 | 检查解析是否仍指向七牛CNAME,重新上传一对匹配的证书和私钥 |
解析生效时间与缓存问题
如果你刚改完DNS解析,全网生效需要时间,这是正常现象,不过遇到长时间不生效的情况,还要检查是不是浏览器或本地DNS缓存在捣乱,可以尝试切换到无痕模式访问域名,或使用 dig、nslookup 命令强制查询最新解析结果。
测试域名能用,为什么还要配置自定义域名
七牛云默认会给每个存储空间分配一个测试域名,形式上类似 xxx.bkt.clouddn.com,这个域名也能访问文件,但它有两个明显限制:
- 有访问频率和流量配额限制,仅适合开发测试环境,不能用于生产业务或正式网站,大规模请求会被直接拒绝或限速。
- 可能被浏览器或第三方平台标记为不安全,因为测试域名是七牛共享的二级域名,不在你品牌控制范内,做小程序、公众号、企业官网时,使用测试域名会触发合规审核问题。
正式上线场景必须走完整的自定义域名配置流程,这也是百度搜索收录和用户信任度的基础搜索引擎对陌生域名的爬取频率和信任评级,远低于与你主体域名关联的子域名。
Q&A:七牛云自定义域名配置常见问题
七牛云自定义域名配置后多久生效?
CNAME解析记录添加成功后,生效时间取决于你使用的DNS服务商和本地运营商的缓存刷新策略,全局解析刷新通常需要几分钟到24小时,多数情况下在2小时内完成,你可以通过 dig 命令确认解析是否已指向七牛节点来验证生效状态。
域名没有备案,能配置七牛云自定义域名吗?
如果你的存储空间在中国大陆区域,域名必须完成ICP备案才能绑定,如果空间在海外区域,可以不用备案直接绑定,但访问速度和稳定性受跨境链路影响,国内用户访问体验会明显下降。
配置完成后想更换域名,需要删除重配吗?
是的,在“域名管理”页面找到已绑定的域名,点击“删除域名”解除绑定,然后重新执行添加域名流程,删除操作不会影响存储空间内的文件数据,原域名的解析记录也需要同步到DNS后台删除或改指向,建议在业务低峰期操作,以避免短暂访问中断。
首发原创文章,作者:王坚,如若转载,请注明出处:https://idctop.com/article/742775.html


![27-11 [扩展]七牛云配置自定义的域名](https://i2.hdslb.com/bfs/archive/02c2c5b8598b584db9c0612a937a8a4884e65a2a.jpg)


