七牛云泛域名怎么配置？先说结论
七牛云泛域名配置的核心思路是：在七牛控制台绑定一个以“.”开头的通配符域名，再通过DNS解析将泛域名CNAME指向七牛分配的加速域名，就能让所有子域名自动享受CDN加速、对象存储挂载和HTTPS证书覆盖。这项能力主要面向需要大量二级子域名的业务场景，比如多用户博客、SaaS应用、图片站群,不需要为每个子域名单独创建域名配置。
泛域名和普通域名的本质区别
理解泛域名之前，先搞清它和普通域名在七牛云环境下的差异，普通域名绑定时，你填写的是类似 cdn.example.com 这样的具体主机记录，泛域名填写的则是 .example.com,这个星号代表任意一级子域名。
访问匹配逻辑也不同。 普通域名只对那一个域名生效，泛域名会对所有未单独配置的子域名生效，你绑定了 .example.com，a.example.com、b.example.com、test.example.com 都会自动被七牛识别并分发,无需逐个配置。
一个关键限制要注意： 泛域名不支持跨级匹配。.example.com 只能覆盖一级子域名，对 a.b.example.com 这种二级子域名是无效的，如果业务需要多级子域名,得另外配置对应的泛域名条目。
泛域名的CNAME解析也和普通域名不同。 七牛控制台会为你的泛域名分配一个专属的CNAME地址，格式一般为 .example.com.qiniucdn.com 或类似形式，你在DNS服务商那边添加解析记录时，主机记录填 ,记录值填这个CNAME地址。
七牛云泛域名配置实操步骤
整个配置流程可以拆成四个环节,每一步都有对应的操作路径。
第一步：在七牛控制台创建泛域名加速域名
登录七牛控制台后，进入CDN产品模块，点击“域名管理”，选择“添加域名”，在域名输入框里直接填写 .example.com 格式的泛域名，注意，控制台表单会校验域名格式,星号必须放在最左侧。
加速区域选择要注意区分全球加速和仅中国大陆。 如果你的业务面向海外用户，需要选择全球加速，这会涉及不同的节点资源和计费策略,仅中国大陆加速的节点布局和备案要求相对简单。
第二步：完成域名归属校验
七牛出于安全考虑，会对泛域名做归属权校验，具体操作路径是：控制台会给出一个TXT记录值，你需要在DNS服务商那边添加一条
_qiniu 开头的TXT解析记录，添加完成后回到控制台点击“验证”,通常几分钟内就能生效。
这个校验的作用是证明你对这个泛域名拥有管理权限，防止他人恶意绑定不属于自己的域名，据七牛官方文档说明，校验完成后建议保留TXT记录,避免后续域名配置变更时需要重新校验。
第三步：配置源站和回源规则
泛域名的源站配置是常见理解的偏差点，很多用户以为泛域名只能回源到同一个源站，实际上七牛支持在泛域名下设置多条回源规则,按不同子域名或路径前缀分发到不同源站。
.example.com 泛域名绑定后，你可以单独给 img.example.com 设置回源到对象存储空间，给 api.example.com 设置回源到自有服务器IP，这种“泛域名+精细化回源规则”的组合方式,是七牛云泛域名配置支持多场景的关键能力。
第四步：CNAME解析切换
源站配好后，控制台会生成泛域名的CNAME记录值，拿这个值去你的DNS服务商（简米云解析、酷番云DNSPod、Cloudflare等）添加解析记录：
主机记录：
记录类型：CNAME
记录值：.example.com.qiniucdn.com（以控制台显示为准）
TTL：默认即可DNS解析生效后，访问任意子域名都会先经过七牛CDN节点，由节点决定缓存或回源，七牛云泛域名配置流程中，这一步最容易出错,错误主要集中在主机记录填成了具体子域名而非星号。
七牛云泛域名支持哪些场景
从实际使用角度来看,泛域名配置主要服务于以下四类典型场景。
多用户SaaS平台的默认域名分配
行业共识认为，SaaS平台给每个租户分配独立子域名是目前的主流做法，比如客服系统给每个企业分配 companyname.example.com，建站平台给每个用户分配 username.example.com，通过七牛泛域名，新租户开通时不需要额外配置CDN，DNS解析按泛域名规则直接生效,平台内部只要做一层路由映射即可。
这个场景下，泛域名配置的核心价值是运维降本，如果没有泛域名，每新增一个用户就要去CDN控制台添加一条域名记录,量大以后完全是重复劳动。
图片与静态资源站的灵活隔离
做图片站或资源下载站，常见做法是用不同的子域名区分资源类型：
avatar.example.com 放用户头像、photo.example.com 放内容图片、file.example.com 放文件下载，泛域名绑定后，这些子域名共用同一套CDN配置,同时在源站侧通过路径或Bucket隔离资源。
七牛云泛域名搭配七牛对象存储尤其方便，源站类型选择“对象存储”后，可以在存储空间里建立多个目录对应不同子域名，再利用七牛的镜像回源功能,将未命中的文件自动回源到自有服务器获取。
HTTPS证书自动覆盖所有子域名
这是泛域名配置延伸出来的实用价值，你只需要在七牛控制台上传一份泛域名SSL证书（证书的Common Name为 .example.com）,就能覆盖所有匹配该泛域名的子域名HTTPS访问。
这里举个例子方便理解： 你在控制台上传了覆盖 .example.com 的证书，a.example.com 和 b.example.com 以及后续新增的任意子域名，都能直接通过HTTPS访问,不需要再单独上传证书或修改配置。
据七牛云官方帮助文档说明，七牛CDN支持自动为泛域名匹配关联的SSL证书，证书到期前建议设置监控提醒,否则泛域名下的所有子域名会同时失效。
线上活动与临时页面的快速创建
运营人员经常要做落地页、活动页，传统方式下，每做一个活动就申请一个新域名或子域名，流程漫长，泛域名配置后，活动子域名自动接入CDN，配合对象存储和静态页面托管，可以实现分钟级上线。
泛域名与CDN加速域名在七牛价格上的差异
先明确一个前提：七牛云泛域名配置本身不额外收费，计费还是按CDN流量和请求次数结算，泛域名和普通域名只是域名表达形式不同,在价格模型上完全一致。
但有一个成本细节值得关注：泛域名会引入大量不同的子域名访问，在七牛控制台的统计分析中，日志会按具体子域名分别展示，经常有用户发现“为什么我的泛域名请求量被拆成了很多条”，这是正常现象,不影响计费总额。
关于七牛云价格的具体档位，官方按量计费模式下，CDN流量单价会随着月使用量阶梯递减，具体价格以控制台实时显示为准，不同加速区域的价格策略也有差异，泛域名配置不会让你的账单变多,真正影响费用的是流量和请求数。
配置后的验证与排查方法
泛域名配置完成后,建议按下面的步骤做一轮自检：
- 用
ping或nslookup解析一个具体的子域名，确认CNAME已经生效 - 在浏览器访问
http://test.example.com，观察是否弹出七牛CDN的响应头 - 用curl命令查看返回头中的
X-Log字段，确认命中的是七牛节点 - 如果回源配置了对象存储，上传一个测试文件访问，确认Content-Type正确
如果出现部分子域名无法访问的情况，排查路径从DNS解析状态开始，再到七牛控制台的域名状态是否显示“已部署”，最后检查源站的回源鉴权配置,绝大多数泛域名配置问题都出在DNS解析延迟和源站防盗链设置上。
另外要提醒一个场景：如果某个子域名需要回源到不同源站，不能依赖纯泛域名规则，必须在七牛控制台添加具体的子域名加速域名，并将回源规则单独配置，泛域名只解决“默认分发”的问题,精确优先级高于泛域名。
七牛云泛域名配置常见问题
泛域名绑定后，为什么已有的子域名访问异常？
因为你可能既有泛域名CNAME记录，又给具体子域名配置了单独的CNAME，DNS解析冲突导致访问走向不确定，解决办法是检查DNS解析列表，删除与泛域名冲突的单条子域名解析记录，只保留泛域名记录或只保留精确记录，泛域名解析生效后，单个子域名的旧记录应清理干净,避免记录冲突。
七牛云泛域名一定要备案吗？
如果泛域名指向的服务器在中国大陆，根据工信部要求，域名必须完成ICP备案，七牛云控制台对未备案的域名会提示绑定失败或加速区域受限，如果选择全球加速且不使用中国大陆节点，备案要求会放宽，但实际情况中大多数业务无法回避备案环节，建议在配置泛域名之前，先确认主域名和泛域名的备案状态,以免配置完成后无法正常加速。
泛域名的图片资源可以单独设置缓存时间吗？
泛域名本身是统一的缓存策略，但七牛控制台支持在“缓存配置”中针对不同目录或路径后缀设置缓存时间，你可以在泛域名下给 .example.com/avatar/ 设置较长的缓存过期时间，给 .example.com/api/ 设置较短的过期时间，缓存配置按路径精确匹配后，泛域名下的子域名会自动继承这些缓存规则,不需要每个子域名单独设置。