宝塔面板不对接百度智能cdn,所有配置须在百度控制台完成;宝塔仅配合设置cache-control响应头、反代规则及https一致性。需在宝塔站点配置文件中为静态资源添加add_header cache-control "public, max-age=31536000";并确保proxy_set_header host $host;、缓存路径权限正确、协议一致;缓存刷新与预热必须在百度控制台操作,宝塔无接口支持。

宝塔面板本身不对接百度云加速(现已升级为“百度智能CDN”),无法直接集成其 API 或控制台功能;所有配置必须在百度智能CDN 控制台完成,宝塔仅负责配合源站响应头、反代规则与 HTTPS 一致性——否则必然出现缓存不命中、502 错误或回源暴增。
百度智能CDN 控制台必须完成的三步
这是绕不开的前提,宝塔面板不做任何替代:
- 域名已通过百度智能CDN
备案审核(境内加速必需) - 在控制台【域名管理】中添加加速域名,源站填写宝塔服务器的公网 IP 或可解析的源站域名(不能填带 CDN 的 CNAME 域名)
- 获取百度分配的 CNAME 地址(如
example.com.baiducdn.com),用于后续 DNS 修改
宝塔站点必须加的 Cache-Control 响应头
百度智能CDN 是否缓存、缓存多久,完全取决于你网站返回的 Cache-Control 响应头。不设或设错,CDN 会默认只缓存 10 秒甚至直接回源。
调用百度PaddleOCR‑VL大模型API,支持PDF、Word、PPT、图片等多格式文档解析,精准识别印刷体、手写体、表格、公式、图表、印章等复杂元素,支持100+语言,可处理不规则布局和跨页长文档。触发词:文档解析、VLM解析、大模型OCR、PaddleOCR、多模态文档、手写识别、公式识别、复杂版面。
- 进入宝塔【网站】→ 点击站点 → 【配置文件】
- 在
location ~ .*\.(js|css|png|jpg|gif|woff2|ttf|svg)$块内添加:add_header Cache-Control "public, max-age=31536000";
- 若需区分资源类型(如 HTML 不缓存),额外加一条:
location / { add_header Cache-Control "no-cache"; } - 改完后务必点击【重载配置】,否则 Nginx 不生效
反向代理模式下必须校验的三项
如果你用宝塔自建反代节点模拟 CDN(非百度官方接入),而源站是另一台服务器,以下三点漏一项就会 502:
-
proxy_set_header Host $host;—— 缺失会导致 WordPress 生成错误链接、SSL 重定向死循环 -
proxy_cache_path路径需独立挂载且chown www:www,否则日志报open() "/www/wwwroot/cache/" failed (13: Permission denied) - 目标 URL 必须与源站协议一致:源站是
https://a.example.com,反代配置里也必须写https://a.example.com,不能混用 HTTP/HTTPS
缓存刷新只能在百度控制台操作,宝塔无接口
百度智能CDN 不提供开放 API 给宝塔插件调用,所谓“面板内刷新”纯属误导。真实操作路径如下:
- 登录 百度智能CDN 控制台
- 进入【缓存刷新】→ 【URL 刷新】,粘贴完整 URL(支持带参数,如
https://example.com/style.css?v=2.3.1) - 单次最多提交 100 条;失败记录里常见原因是 URL 格式非法或未匹配到已加速域名
- 预热功能同理,不能靠宝塔按钮触发,必须手动提交
注意:百度对免费套餐的刷新次数有限额(每日 1000 次),频繁更新静态资源建议加版本号或哈希值到文件名,而非依赖刷新。










