宝塔面板CDN加速设置

宝塔面板CDN加速设置是指在宝塔面板中为网站绑定加速域名、配置回源地址与缓存规则，使访问请求通过CDN节点就近分发并加速响应的操作过程。

设置前的必要准备

在宝塔面板中配置CDN加速前,需要完成以下准备工作，宝塔面板已安装并正常运行，网站站点已创建完毕，同时已从CDN服务商处获取加速域名、CNAME地址、回源地址以及对应的加速套餐，如果使用中国大陆地区CDN节点，还需确保网站域名已完成ICP备案，源站服务器防火墙需要允许CDN回源IP段访问80或443端口，否则回源请求会被拦截。

在宝塔面板绑定加速域名

进入宝塔面板后台,打开“网站”管理页面，选择需要加速的网站，点击“设置”或直接进入站点管理，在“域名管理”中添加CDN加速域名，www.example.com 或 cdn.example.com，如果希望主域名和加速域名同时生效，可以同时绑定多个域名，添加完成后，宝塔面板会自动修改Nginx或Apache的虚拟主机配置，使该域名能够正常访问对应的站点目录。

如果站点没有单独绑定CDN加速域名,也可以直接使用源站域名，但为了便于区分和后续回源设置，建议使用独立加速域名，绑定域名后，检查站点根目录是否指向正确，确保访问时能够加载网站文件。

DNS解析与CNAME接入

登录域名DNS解析服务商控制台,找到加速域名对应的解析记录，如果原本存在A记录指向服务器IP，需要暂停或删除该A记录，然后添加一条CNAME记录，记录值填写CDN服务商提供的CNAME地址，www.example.com.cdn.dnsv1.com，CNAME记录生效后，用户访问该域名会先请求CDN节点，由CDN节点回源到服务器获取数据。

DNS解析新增或修改后,通常需要几分钟到几小时不等才能全球生效，可以在CDN控制台查看域名接入状态，确认是否已经完成CNAME配置，部分CDN服务商支持域名解析自动检测，帮助判断接入是否正常。

配置回源地址与回源Host

在CDN服务商控制台添加加速域名时,需要设置源站信息，源站地址可以填写服务器公网IP，也可以填写源站域名，如果服务器有多个站点，建议使用IP作为源站地址，并单独设置回源Host为加速域名或源站域名，回源Host决定了CDN回源请求中携带的Host头，宝塔面板通过该Host头识别具体站点。

回源Host设置错误会导致CDN回源时服务器返回默认站点内容或提示站点不存在,源站端口一般为80或443，具体根据源站开启的协议选择，回源协议可配置为HTTP、HTTPS或协议跟随，如果宝塔面板站点已开启HTTPS，建议回源协议选择HTTPS，避免协议不一致导致内容异常。

宝塔面板开启CDN兼容与真实IP获取

默认情况下,CDN回源请求经过代理后，服务器获取到的是CDN节点IP，并非用户真实IP，宝塔面板需要在网站配置中开启真实IP识别，否则网站日志、访问统计、防火墙规则都会记录错误IP。

登录宝塔面板,进入对应网站设置，打开“配置文件”或“伪静态”功能，在Nginx站点配置中，可以添加以下配置：

set_real_ip_from0.0.0.0/0;
real_ip_headerX-Forwarded-For;
real_ip_recursiveon;

如果使用Apache,可以通过mod_remoteip模块设置，宝塔面板部分版本在网站设置中提供“CDN”开关，开启后会自动添加相应的真实IP配置，保存配置后重载Nginx或Apache服务。

需要在CDN控制台确认回源请求头中携带 X-Forwarded-For 字段，部分CDN服务商默认携带，但有时需要手动开启，开启后，宝塔面板的访问日志和防火墙才能正确识别用户真实IP。

缓存规则与过期时间配置

CDN加速的核心在于缓存静态文件,在CDN控制台添加缓存规则，将静态资源设置为长时间缓存，动态内容设置为不缓存或短缓存，常见静态文件包括图片、CSS、JavaScript、字体、视频、音频等，缓存过期时间可设置为7天、30天或更长，动态文件如PHP、HTML、API接口、登录页面等通常不缓存或缓存时间不超过60秒。

以常见CDN服务商为例,缓存规则可配置如下：

• *.jpg、*.jpeg、*.png、*.gif、*.webp：缓存30天

• *.css、*.js：缓存7天

• *.php、*.html、*.json：不缓存

• /api/*：不缓存

• /admin/*：不缓存

宝塔面板也可以配合设置源站响应头,让CDN按照源站指示进行缓存，在网站配置中添加：

location~*\.(jpg|jpeg|png|gif|webp|css|js)${
expires30d;
add_headerCache-Control"public";
}

这样源站直接告诉CDN节点静态文件缓存30天,对于需要频繁更新的CSS或JS文件，可以使用版本号或者较短缓存时间。

HTTPS证书与强制跳转

CDN加速域名也需要配置HTTPS证书,可以在CDN控制台上传或申请免费证书，部分CDN服务商支持一键申请Let's Encrypt证书，源站宝塔面板可以继续使用已有证书，也可以仅在CDN层开启HTTPS，回源使用HTTP。

如果希望全链路HTTPS,需要在CDN控制台将回源协议设置为HTTPS，并确保源站证书有效，宝塔面板网站设置中开启“强制HTTPS”，使源站请求自动跳转到HTTPS地址，需要注意，CDN层和源站层都开启强制跳转可能会产生多次跳转，建议只在CDN层开启强制HTTPS跳转，源站保持正常响应。

证书配置完成后,需要确认CDN节点能够正常访问源站HTTPS地址，如果源站使用自签名证书，部分CDN服务商无法正常回源，需关闭回源证书校验或使用有效证书。

防盗链与安全防护

CDN加速后,静态资源可能被其他网站盗用，可以在CDN控制台开启防盗链功能，设置允许的域名白名单，通常允许源站域名及所有子域名，example.com 和 *.example.com，防盗链生效后，其他域名引用图片或资源时会被拒绝。

宝塔面板也可以配合设置Nginx防盗链规则：

location~*\.(jpg|jpeg|png|gif|webp|css|js)${
valid_referersnoneblockedexample.com*.example.com;
if($invalid_referer){
return403;
}
}

建议在CDN控制台开启基础Web防护或WAF功能,过滤恶意请求，宝塔面板可以安装防火墙插件，对回源IP段进行放行，防止CDN回源请求被误拦截。

压缩与性能优化

CDN节点支持Gzip和Brotli压缩,在CDN控制台开启压缩功能后，文本类资源如HTML、CSS、JS、XML、JSON会在节点压缩后返回给用户，减少传输体积，源站宝塔面板也可以开启Gzip压缩，但需要注意避免重复压缩，通常CDN层和源站层只开启一处即可。

CDN控制台还可能提供页面优化功能,如HTML压缩、CSS/JS合并、图片格式转换等，可以根据网站实际情况选择性开启，图片自适应功能可以根据用户设备屏幕宽度返回不同尺寸的图片，适合移动端访问较多的站点，开启前建议测试网站显示是否正常，避免影响页面样式。

回源超时与回源重试

CDN节点回源时可能出现源站响应慢或不可用的情况,可以在CDN控制台设置回源超时时间，一般设置为5到30秒，超过超时时间后，CDN节点会返回缓存内容或错误页面，还可以配置回源重试，当源站返回5xx错误时，CDN自动尝试其他源站地址或重新请求。

如果源站服务器性能有限,可以适当增大回源超时时间，并开启回源重试功能，避免因瞬时故障导致网站不可用，宝塔面板中可查看源站负载情况，必要时升级服务器配置或优化PHP、数据库性能。

十一、常见问题排查

加速域名无法访问时,首先检查DNS解析是否已切换到CNAME记录，可通过 dig 或在线DNS检测工具查看解析结果，其次检查CDN控制台域名状态是否正常，是否完成证书配置和源站设置。

网站出现502或504错误,通常是CDN回源请求被服务器防火墙拦截，或源站服务未正常运行，登录宝塔面板安全页面，放行CDN回源IP段，或暂时关闭防火墙测试，同时检查Nginx或Apache服务状态，确保源站能够正常响应请求。

获取不到用户真实IP时,检查宝塔面板网站配置中的 real_ip_header 和 set_real_ip_from 是否正确，部分CDN服务商使用 X-Real-IP 或 CF-Connecting-IP 头部，需要根据实际情况修改配置。

缓存不生效时,检查源站响应头是否包含 Cache-Control 或 Expires 字段，以及CDN缓存规则是否覆盖了对应文件类型，动态内容如果被错误缓存，需要在CDN控制台添加不缓存规则，并清理已缓存内容。

HTTPS证书不匹配或提示不安全时,检查CDN证书与加速域名是否一致，回源协议是否与源站证书匹配，确认证书链完整，没有过期。