Raspian系统Nginx排除本地IP写入access_log失败求助

你这是踩了Nginx版本兼容的坑！Raspbian默认仓库里的Nginx版本通常比较老旧，而access_log指令的if参数是Nginx 1.7.0及以上版本才支持的，老版本根本识别不了这个参数，所以才会启动失败。

下面给你两种可行的解决方案，选一种适合你的：

方案一：升级Nginx到支持if参数的版本 #

如果你的系统允许升级Nginx，这是最直接的方法：

1. 先备份当前配置，避免出错：

   sudo cp /etc/nginx/nginx.conf /etc/nginx/nginx.conf.bak
   

2. 安装依赖并添加Nginx官方源（以Raspbian 11 Bullseye为例，其他版本可以替换源里的bullseye为对应版本名）：

   sudo apt install apt-transport-https ca-certificates curl gnupg2
   curl https://nginx.org/keys/nginx_signing.key | gpg --dearmor | sudo tee /usr/share/keyrings/nginx-archive-keyring.gpg >/dev/null
   echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] http://nginx.org/packages/mainline/debian bullseye nginx" | sudo tee /etc/apt/sources.list.d/nginx.list
   

3. 更新包列表并升级Nginx：

   sudo apt update && sudo apt install nginx
   

4. 回到你原来的配置，用sudo nginx -t测试配置合法性，没问题的话重启Nginx：

   sudo systemctl restart nginx
   

这样你的map+if=$log_ip的配置就能正常工作了。

方案二：不升级Nginx，用旧版本兼容的方法 #

如果不想升级，我们可以用geo模块或者if指令的组合来实现需求：

子方案A：用geo模块控制日志开关 #

在/etc/nginx/nginx.conf的http块里添加geo配置（注意要放在server块外面）：

geo $log_allowed {
    default 1;  # 默认所有IP都记录日志
    192.168.2.1 0;  # 这个IP不记录
    192.168.2.2 0;  # 这个IP也不记录
}

然后在你的网站server块里添加：

server {
    # 你的其他配置，比如监听端口、域名、身份验证等
    listen 80;
    server_name your-domain.com;

    auth_basic "Private Site";
    auth_basic_user_file /etc/nginx/.htpasswd;

    # 先开启日志，再对指定IP关闭
    access_log /var/log/nginx/proxy.log main;
    if ($log_allowed = 0) {
        access_log off;
    }
}

测试配置并重启Nginx即可生效。

子方案B：针对白名单IP单独设置 #

如果你的私有网站有IP白名单需求，可以直接把允许的IP单独处理，关闭他们的日志：

server {
    listen 80;
    server_name your-domain.com;

    # 先处理白名单IP，关闭日志
    location / {
        allow 192.168.2.1;
        allow 192.168.2.2;
        deny all;
        access_log off;
        # 这里可以复用你的网站根目录配置
        root /var/www/html;
        index index.html;
    }

    # 处理其他访问，开启日志+身份验证
    location / {
        auth_basic "Private Site";
        auth_basic_user_file /etc/nginx/.htpasswd;
        access_log /var/log/nginx/proxy.log main;
        root /var/www/html;
        index index.html;
    }
}

这种方法不需要额外的模块，适合简单场景。

内容的提问来源于stack exchange，提问作者l3raindead