Nginx User-Agent 识别与分发配置实战：不同设备不同体验

2025/7/10 14:42:07 183 0 0 0

在 Web 开发中，根据用户设备类型提供不同的页面内容或进行重定向是一种常见的优化手段。通过 User-Agent 头部信息，我们可以识别用户使用的设备类型，并据此进行不同的处理。本文将提供一个 Nginx 的配置示例，演示如何根据不同的 User-Agent 提供不同的页面内容或重定向到不同的网站。

1. 核心思路

核心思路是使用 Nginx 的 map 指令创建变量，该变量的值基于 User-Agent 头部信息。然后，我们可以使用 if 指令或 location 块，根据这个变量的值来决定如何处理请求。map 指令允许我们定义 User-Agent 和对应操作之间的映射关系，使得配置更加清晰和易于维护。

2. 配置示例

以下是一个完整的 Nginx 配置示例，它将根据 User-Agent 将用户重定向到不同的网站或提供不同的内容：

http {
    # 定义 User-Agent 映射变量
    map $http_user_agent $mobile_group {
        default pc;
        ~*android|iphone|ipad mobile;
    }

    server {
        listen 80;
        server_name yourdomain.com;

        # 针对移动设备的重定向
        if ($mobile_group = mobile) {
            return 302 https://m.yourdomain.com$request_uri;
        }

        # PC 设备的配置
        location / {
            root /var/www/yourdomain.com/pc;
            index index.html index.htm;
        }
    }

    server {
        listen 80;
        server_name m.yourdomain.com;

        # 移动设备的配置
        location / {
            root /var/www/yourdomain.com/mobile;
            index index.html index.htm;
        }
    }
}

配置详解

map $http_user_agent $mobile_group: 这是一个 map 指令，用于定义 $mobile_group 变量。它基于 $http_user_agent 的值进行映射。default pc; 表示默认情况下 $mobile_group 的值为 pc。~*android|iphone|ipad mobile; 表示如果 User-Agent 包含 android、iphone 或 ipad（不区分大小写），则 $mobile_group 的值为 mobile。
if ($mobile_group = mobile): 这是一个 if 指令，用于判断 $mobile_group 的值是否为 mobile。如果是，则执行 return 302 https://m.yourdomain.com$request_uri;，将用户重定向到移动版网站。$request_uri 变量表示用户请求的 URI。
location /: 这是一个 location 块，用于配置根目录的请求处理。root /var/www/yourdomain.com/pc; 表示 PC 版网站的根目录。index index.html index.htm; 表示默认的索引文件。
两个 server 块: 第一个 server 块配置了 PC 版网站，第二个 server 块配置了移动版网站。它们监听不同的 server_name，并指向不同的根目录。

3. 进阶用法

3.1 提供不同的内容

除了重定向，我们还可以根据 User-Agent 提供不同的内容。例如，我们可以为移动设备提供更小的图片或更简洁的 HTML 结构。

http {
    map $http_user_agent $mobile_group {
        default pc;
        ~*android|iphone|ipad mobile;
    }

    server {
        listen 80;
        server_name yourdomain.com;

        location / {
            # 根据设备类型设置不同的根目录
            if ($mobile_group = mobile) {
                root /var/www/yourdomain.com/mobile;
            } else {
                root /var/www/yourdomain.com/pc;
            }

            index index.html index.htm;
        }
    }
}

在这个例子中，我们使用 if 指令来设置不同的 root 目录。如果用户是移动设备，则使用 /var/www/yourdomain.com/mobile 作为根目录；否则，使用 /var/www/yourdomain.com/pc 作为根目录。

3.2 更复杂的 User-Agent 匹配

map 指令支持更复杂的 User-Agent 匹配。例如，我们可以根据不同的操作系统或浏览器类型进行不同的处理。

http {
    map $http_user_agent $browser_group {
        default other;
        ~*Chrome chrome;
        ~*Firefox firefox;
        ~*Safari safari;
    }

    server {
        listen 80;
        server_name yourdomain.com;

        location / {
            # 根据浏览器类型设置不同的缓存策略
            if ($browser_group = chrome) {
                expires 1h;
            } elseif ($browser_group = firefox) {
                expires 30m;
            } else {
                expires 10m;
            }

            root /var/www/yourdomain.com;
            index index.html index.htm;
        }
    }
}

在这个例子中，我们根据不同的浏览器类型设置不同的缓存策略。expires 指令用于设置缓存过期时间。

4. 注意事项

User-Agent 的可靠性: User-Agent 头部信息可以被用户修改，因此不能完全依赖它来进行设备识别。更可靠的方法是使用客户端脚本（例如 JavaScript）来检测设备特性。
搜索引擎优化 (SEO): 如果使用重定向，请确保搜索引擎能够正确索引你的网站。可以使用 301 重定向来告诉搜索引擎移动版网站是 PC 版网站的替代版本。
维护性: map 指令可以使配置更加清晰和易于维护。尽量避免在 if 指令中编写复杂的逻辑。
测试: 在生产环境中部署之前，请务必 thoroughly 测试你的配置。

5. 总结

通过本文的示例，你应该能够掌握如何使用 Nginx 根据 User-Agent 提供不同的页面内容或重定向到不同的网站。这种技术可以用于优化用户体验、进行 A/B 测试以及实现更高级的 Web 应用功能。记住，User-Agent 只是设备识别的一种手段，需要结合其他技术才能实现更可靠和灵活的解决方案。实际应用中，务必考虑 User-Agent 的可篡改性，并结合其他技术手段进行验证和增强。

Nginx 高手 Nginx User-Agent 重定向