宝塔面板无法直接对接七牛云，需通过Nginx反向代理实现CDN效果：将/static/、/uploads/等路径请求代理至七牛自定义域名（如cdn.example.com），并配置Host头、缓存头及CNAME解析。
宝塔面板里怎么配七牛云对象存储当静态资源CDN
直接说结论：宝塔本身不内置七牛云对接功能，但可以通过「反向代理 + 七牛云对象存储绑定自定义域名」实现等效的静态资源CDN加速效果。关键不是“对接”，而是让网站请求静态资源时走七牛云分发节点，同时保持原有URL结构不变。
核心思路是：把 /static/、/uploads/ 这类路径的请求，用 Nginx 反向代理到七牛云绑定的自定义域名（比如 cdn.example.com），而该域名已解析到七牛云提供的 CNAME 地址。这样用户访问的还是你自己的域名，但资源实际从七牛云全球节点加载。
为什么不能直接在宝塔里填七牛云 AK/SK 自动同步
宝塔的「网站 > 静态文件 CDN 加速」模块只支持阿里云 OSS、腾讯云 COS 的一键对接，七牛云不在白名单里。强行填 AK/SK 不会生效，后台也没有对应逻辑去调用七牛云 qiniu-sdk 或触发 putFile 上传。
常见错误现象：
– 在宝塔 CDN 设置页填写七牛云密钥后点击保存，页面无报错但资源没上传；
– 查看宝塔日志 /www/wwwlogs/panel.log，找不到任何七牛云相关调用记录；
– 宝塔源码中搜索 qiniu 或 bucket，结果为空。
所以别折腾那个开关，它对七牛云就是摆设。
Nginx 反向代理配置实操（宝塔可视化操作）
登录宝塔 → 网站 → 找到目标站点 → 「配置文件」→ 在 location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff2|ttf|eot)$ 块上方插入以下规则（注意替换为你自己的七牛自定义域名）：
location ^~ /static/ {
proxy_pass https://cdn.example.com/;
proxy_set_header Host cdn.example.com;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
expires 1y;
add_header Cache-Control "public, immutable";
}
location ^~ /uploads/ {
proxy_pass https://cdn.example.com/;
proxy_set_header Host cdn.example.com;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
expires 1y;
add_header Cache-Control "public, immutable";
}
要点说明：
– ^~ 保证前缀匹配优先级高于正则，避免被后面通用静态规则覆盖；
– proxy_pass 末尾带 /，否则路径拼接会出错（比如请求 /static/a.js 会被转发成 https://cdn.example.com/static/a.js）；
– 必须显式设置 Host 头，因为七牛云需要靠这个识别你的空间；
– expires 和 Cache-Control 要加，否则七牛默认缓存时间很短（通常只有 1 小时），起不到加速效果。
七牛云控制台必须做的三件事
光配 Nginx 不行，七牛云侧也要对齐：
– 开通对象存储空间，并选择「标准存储」+「私有读公有写」或「公有读写」（推荐后者，简化调试）；
– 绑定自定义域名 cdn.example.com，并按提示完成 DNS CNAME 解析（指向七牛给的 xxx.qiniucdn.com 地址）；
– 进入「数据处理 > 图片样式」或「数据处理 > 视频转码」（如用到），确认这些功能未开启全局拦截——否则可能把 JS/CSS 当图片重写 URL，导致 404。
容易被忽略的点：
– 七牛云默认不支持跨域（CORS），如果你前端用 fetch 加载字体或 JSON，需手动在空间设置里添加 Access-Control-Allow-Origin: *；
– 上传工具要用 qshell 或 qiniu-cli 手动同步本地静态目录，宝塔不会自动触发；
– 七牛云的 HTTPS 免费证书只支持绑定域名，不支持泛解析，所以 cdn.example.com 要单独申请，不能指望 *.example.com 覆盖。
