Nginx rewrite 实现 CDN 无缝切换:通过 location 匹配静态资源路径或后缀,用 rewrite 重定向至 CDN 域名(301/302),保留原始路径结构;需防循环重定向、支持协议适配与灰度控制,回滚只需注释 rewrite 并 reload。

用 Nginx rewrite 实现 CDN 加速域名的无缝切换,核心是把原站静态资源请求(如 /static/、/img/、.js、.css 等)自动改写为 CDN 域名下的对应路径,并返回 302 重定向(测试期)或 301(上线后),让用户浏览器和缓存自然过渡到 CDN。整个过程对用户透明,原 HTML 中无需修改资源链接。
识别并匹配静态资源请求
先明确哪些请求该走 CDN:通常按路径前缀或文件后缀判断。建议在 server 块中统一处理,避免重复匹配。
- 按路径匹配(推荐):比如所有
/static/、/uploads/、/assets/下的请求 - 按后缀匹配(补充):如
.jpg、.png、.woff2、.js、.css等,但注意要排除带查询参数的动态资源(如/app.js?v=123) - 不建议用
if ($request_uri ~* \.(js|css|png)$)全局判断,因if在 location 外性能较差且易出错;优先用location+rewrite
配置 rewrite 重定向到 CDN 域名
使用 permanent(301)或 redirect(302)标志,将原始请求 URI 映射为 CDN 域名下的等效路径。关键点是保留原始路径结构,只替换域名。
Linux AI 服务器 — 将 Linux 服务器转换为本地 AI 推理集群。使用 systemd、NVIDIA CUDA 实现无头 Linux AI,零 GUI 开销。
- 示例:将
https://example.com/static/logo.png→https://cdn.example.com/static/logo.png - 配置写法:
location ^~ /static/ {
rewrite ^/(.*)$ https://cdn.example.com/$1 permanent;
} - 若 CDN 域名需适配协议(如 HTTP/HTTPS),可用
$scheme变量:
rewrite ^/(.*)$ $scheme://cdn.example.com/$1 permanent; - 注意:不要在
location内混用proxy_pass和rewrite ... permanent,二者语义冲突;重定向必须显式返回状态码
避免循环与确保兼容性
CDN 回源时可能携带 Host 头,需防止 Nginx 对 CDN 请求再次重定向,造成死循环。
- 在 server 块中加条件判断,跳过已来自 CDN 域名的请求:
if ($host ~* "^cdn\.example\.com$") {
break;
} - 更稳妥的做法是为 CDN 配置独立的
server块监听同一端口,用server_name cdn.example.com,并在其中直接提供静态文件或 proxy_pass 到源站,完全绕开 rewrite 逻辑 - 上线前用
curl -I测试响应头是否含Location且状态码为 301/302,确认路径拼接无误(如无双斜杠、多余编码)
灰度与回滚策略
无缝切换不等于全量一刀切。可通过变量或 map 模块实现按用户、IP 或 Cookie 控制 CDN 路由比例。
- 简单灰度:用
$remote_addr哈希取模
set $use_cdn "0";
if ($remote_addr ~ "^(?:\d{1,3}\.){3}\d{1,3}$") {
set $use_cdn "1";
}
if ($use_cdn = "1") {
rewrite ^/(static|img|css|js)/(.*)$ https://cdn.example.com/$1/$2 permanent;
} - 回滚只需注释或删除相关 rewrite 行,reload Nginx 即可立即生效,无需改业务代码

















