图片、视频和下载文件放在阿里云对象存储OSS中后,可以通过自己的域名对外访问。链接更容易识别,网站更换存储方案时也便于统一调整资源地址。阿里云OSS域名绑定通常要完成三件事:在Bucket中添加自定义域名、到DNS解析中设置CNAME记录,再测试文件能否正常访问。
配置本身不复杂,问题往往出在细节上:CNAME目标填错、文件权限不匹配,或者HTTPS证书没有覆盖自定义域名。下面按操作顺序说明,并用图片站的配置场景讲清楚常见排查方向。
绑定前先准备好这几项
- 已注册的域名:例如 example.com。可以为资源单独使用 img.example.com,避免改动主站域名的解析记录。
- OSS Bucket:确认文件已上传,并记下Bucket所在地域。地域会影响OSS对应的访问域名,添加自定义域名时要选对Bucket。
- DNS解析管理权限:你需要能在域名服务商或云解析控制台中新增、修改记录。
- 备案与访问方案:域名用于中国内地的网站服务时,应按相关规定完成备案。若图片、下载资源面向公网访问,也可以结合业务情况评估是否使用CDN。
文件权限也要提前确认。公开展示的图片通常需要支持匿名读取;订单附件、内部文件等不应为了让链接可用就开放整个Bucket,可以考虑使用签名URL或由应用端鉴权。域名绑定只提供一个访问入口,不会自动替你决定谁能读取文件。
阿里云OSS域名绑定的操作步骤
第一步:在OSS中添加自定义域名
登录阿里云OSS控制台,进入目标Bucket,找到域名管理或自定义域名相关页面,添加准备使用的域名,例如 img.example.com。操作时核对Bucket和地域,避免把域名加到另一个存储空间中。
添加后,控制台会显示对应的CNAME目标值。这个值可能随地域和配置不同,直接复制当前页面提供的内容即可,不要套用其他教程里的示例地址。如果页面提示域名已绑定、归属校验失败或不符合要求,可以检查该域名是否已关联其他Bucket、CDN或云服务。多个配置同时处理同一个域名,容易让解析去向变得不清楚。
第二步:配置DNS的CNAME记录
进入域名解析控制台,为 img.example.com 添加CNAME记录。主机记录通常填写 img,具体字段名称和填写方式以解析服务商的页面为准;记录值填写OSS控制台给出的CNAME目标。保存后需要等待DNS解析生效,受缓存影响,变更不一定会立刻反映到所有网络环境中。
不要把Bucket名称或猜测的IP地址当作CNAME目标。OSS访问通常依赖域名路由,手动填IP既不可靠,也可能把请求送到错误的服务节点。记录保存后,可以用DNS查询工具查看解析结果;如果查询到的仍是旧记录,先确认记录内容和生效情况,再继续排查访问问题。
第三步:验证文件访问
假设Bucket中有一个文件 logo.png,测试地址可以按“自定义域名/对象路径”拼接,例如 https://img.example.com/logo.png。测试前确认文件确实存在,路径和文件名大小写一致。对象路径写错或大小写不匹配时,常会被误认为域名绑定失败。
如果目前只配置了HTTP,就先按已配置的协议测试。需要HTTPS时,还要完成证书配置,或通过CDN处理HTTPS访问。测试最好选一张权限明确的公开图片,这样能先判断域名和路径是否通,再单独检查受限文件的访问策略。
案例:给图片站配置专用域名
某内容团队原先把文章图片存放在OSS中,网页直接使用OSS原生访问地址。调整时,他们保留原有Bucket和图片文件,改用 img.example.com 作为图片域名。管理员先在OSS控制台添加该域名,复制页面提供的CNAME目标,再到DNS解析服务中新增对应记录。
解析生效后,团队先用一张公开图片测试访问,再逐步把网页中的图片链接改为 img.example.com 对应的路径。上线当天,有些图片可以打开,另一些却返回访问拒绝。继续检查后发现,域名解析没有问题,出错的是部分对象的权限设置:公开素材允许匿名读取,内部素材则需要授权。
团队没有为了修复报错而把整个Bucket改成公共读,而是区分公开与私有内容,分别设置访问方式。这个场景里,域名绑定只解决请求通过哪个域名进入;文件能否读取,还要看对象是否存在、访问权限是否允许、路径是否正确,以及请求是否经过CDN等中间层。
常见问题与排查顺序
- 域名无法访问:先核对DNS中的主机记录和CNAME目标,再确认解析是否生效、OSS控制台中的域名是否绑定到正确Bucket。不要一开始就改文件权限。
- 返回403:检查Bucket或对象权限、访问策略,以及文件是否要求签名访问。403通常需要从授权设置入手,反复修改DNS未必能解决问题。
- 返回404:核对对象路径、文件名大小写和文件是否存在。对象存储路径通常区分大小写,复制链接时多一个字符也可能导致找不到文件。
- 浏览器提示HTTPS证书错误:确认有效证书是否覆盖当前自定义域名,并检查HTTPS在哪一层处理。如果使用CDN,还要在相应的CDN配置中检查证书和回源设置。
- 访问速度或稳定性不理想:域名绑定不会自动带来全球加速。遇到高并发或跨地域访问需求,可以评估接入CDN,并核对缓存规则、回源地址和刷新策略。
绑定完成后的检查清单
- 在OSS控制台确认绑定的是目标Bucket和准确的自定义域名。
- 检查DNS记录是否使用控制台提供的CNAME目标,不要手动猜测IP。
- 分别测试公开文件和应受保护的文件,确认访问权限符合预期。
- 需要HTTPS时,确认自定义域名对应的证书有效,且证书覆盖该域名。
- 上线后更新网站或程序中的旧资源链接,并留意访问日志和异常状态码。
阿里云OSS域名绑定可以按“控制台添加域名、DNS设置CNAME、访问文件验证”的顺序完成。遇到打不开的情况,先看解析是否指向正确,再根据403、404或证书错误检查权限、对象路径和HTTPS配置。把公开资源与私有文件分开处理,也能避免为了让少数链接可用而放宽整个Bucket的访问权限。