多域名共享静态资源需为每个域名配置独立server块并统一location指向相同物理路径,而非仅靠location匹配;核心是通过server_name区分域名,用alias指令精准映射共享目录,避免404。

不能靠 location 实现多域名共享静态资源——这是常见误解。location 的作用是匹配请求路径(URI),不是匹配域名;真正决定“哪个域名走哪套配置”的,是 server_name 和 server 块的匹配逻辑。
多域名共享静态资源的正确结构
多个域名要共用同一份静态文件(比如都读 /var/www/shared-assets/ 下的 CSS、JS、图片),核心做法是:为每个域名单独写一个 server 块,但让它们的 location 都指向相同的物理路径,并复用通用配置。
- 每个 server 块必须有明确且唯一的 server_name(如 site-a.com、site-b.com)
- 所有 server 块中,针对静态资源的 location 配置保持一致,例如:
location /static/ { alias /var/www/shared-assets/; } - 把日志、缓存头、Gzip、安全头等通用设置抽成 common.conf,用 include 引入,避免重复
为什么不能只靠一个 server 块 + 多个 server_name?
HTTP 场景下,server_name site-a.com site-b.com; 确实能让两个域名共用一个 server 块,但存在明显限制:
- 无法为不同域名设置不同 root 或 alias 路径(你可能想让 site-a.com 的 /static/ 指向 A 目录,site-b.com 的 /static/ 指向 B 目录)
- 无法区分记录访问日志(所有请求都写进同一个 access.log)
- SSL 证书必须覆盖全部域名(certbot -d site-a.com -d site-b.com),泛域名不自动包含主域
- 一旦要做差异化配置(比如 site-b.com 需要额外加 CORS 头),就得拆块——不如一开始就分设
location 中 root 和 alias 的关键区别(直接影响能否共享)
共享静态资源时,选错指令会导致 404。关键看路径拼接逻辑:
-
root:把 location 路径追加到 root 值后面
→location /static/ { root /var/www; }→ 请求/static/logo.png查找/var/www/static/logo.png -
alias:直接替换掉 location 路径部分
→location /static/ { alias /var/www/shared-assets/; }→ 同样请求查找/var/www/shared-assets/logo.png
如果多个域名都要读同一组共享资源,推荐用 alias,路径更可控;注意 alias 值末尾必须带斜杠,否则会出错。
一个可运行的最小示例
假设你要让 app1.example.com 和 app2.example.com 都能访问 /shared/ 下的公共资源:
- 创建统一资源目录:
mkdir -p /var/www/shared - 在
/etc/nginx/conf.d/common-static.conf中写通用规则:expires 7d;<br>add_header Cache-Control "public";<br>sendfile on;
- 为 app1 写配置:
server {<br> listen 80;<br> server_name app1.example.com;<br> include common-static.conf;<br> location /shared/ { alias /var/www/shared/; }<br>} - 为 app2 写同结构配置,仅改 server_name 和必要差异项
改完执行 nginx -t && nginx -s reload,确保语法正确再重载。











