如何配置 Nginx 针对不同移动端设备提供差异化的静态资源目录-Nginx-PHP中文网

Nginx无法原生识别设备型号，但可通过map指令匹配User-Agent并结合location内if+alias实现移动端与桌面端静态资源目录自动切换，推荐用子域名方案提升稳定性和可维护性。

如何配置 nginx 针对不同移动端设备提供差异化的静态资源目录

直接通过 Nginx 原生配置实现“按移动端设备类型自动切换静态资源目录”是不可行的——Nginx 本身不解析设备型号、不识别 iOS/Android 具体版本，也无法动态重写 root 路径。但它可以通过 User-Agent 字符串匹配 + 条件 location 分流 + alias 或 root 组合，实现对移动/桌面端提供不同静态资源目录的效果。核心思路是：区分请求来源（移动端 or 桌面端），再映射到对应物理路径。

识别并分流移动端请求

Nginx 不支持 if + root，但支持 if + rewrite 或嵌套 location 匹配。更可靠的做法是用 map 指令预定义变量，再在 location 中引用：

在 http 块顶部添加：

map $http_user_agent $device_type {
~*"(iPhone|iPad|iPod|Android|Mobile)" "mobile";
default "desktop";
}

为不同设备类型配置独立静态路径

使用 alias 更适合此场景（避免 root 拼接歧义）。例如：

移动资源放在 /var/www/static/mobile/
桌面资源放在 /var/www/static/desktop/
统一访问路径为 /static/xxx.png，后端自动选目录

配置示例：

Nginx Reverse Proxy

配置 Nginx 反向代理，实现域名绑定。用户说“绑定域名”“配置 Nginx”“反向代理”时触发，将域名绑定到指定 IP:端口。

下载

server {
  listen 80;
  server_name example.com;
  # 根据 device_type 变量选择 alias 路径
  location /static/ {
    # 移动端走 mobile 目录，注意末尾斜杠必须一致
    if ($device_type = "mobile") {
      alias /var/www/static/mobile/;
    }
    if ($device_type = "desktop") {
      alias /var/www/static/desktop/;
    }
    expires 1h;
    add_header Cache-Control "public";
  }
}

关键注意事项

if 在 location 内可用，但在 server 级慎用：Nginx 官方不推荐在 server 块中大量使用 if，但 location 内用于简单字符串判断是常见且安全的
alias 末尾斜杠必须与 location 严格对应：比如 location /static/ → alias /path/to/mobile/（结尾有/）；若写成 alias /path/to/mobile（无/），会导致路径错位
移动端 UA 匹配要覆盖主流特征：正则中已包含 iPhone/iPad/Android/Mobile，可按需补充 Windows Phone 或 Fennec（Firefox Mobile）等
文件权限和 SELinux 需同步检查：确保 nginx worker 进程用户（如 www-data 或 nginx）对两个目录均有读取权限