Nginx反向代理Nextcloud/PHP服务器时如何获取真实客户端IP

嘿，我懂你现在卡在哪了——用Nginx反向代理Nextcloud之后，服务器拿不到真实的客户端IP是吧？你猜的方向完全没错，核心就是X-Real-IP和X-Forwarded-For这俩请求头的配置问题，但你把它们放错位置啦！

问题根源 #

你现在把proxy_set_header X-Forwarded-For $remote_addr;写在了server块里，但这个指令是给反向代理上游服务器（也就是用proxy_pass的时候）用的。而你的场景是Nginx直接通过fastcgi_pass把请求转发给PHP-FPM，这时候得用fastcgi_param来传递真实IP，而且得放在处理PHP请求的location块里才行。

修正步骤 #

1. 调整Nginx配置

首先删掉server块里那行proxy_set_header X-Forwarded-For $remote_addr;，然后在处理PHP的location ~ \.php(?:$|/)块里，添加下面这两个参数：

# 传递真实客户端IP给PHP
fastcgi_param REMOTE_ADDR $remote_addr;
fastcgi_param HTTP_X_FORWARDED_FOR $remote_addr;

如果你的Nginx前面还套了一层代理（比如CDN、负载均衡），那把$remote_addr换成$proxy_add_x_forwarded_for，这样能保留完整的IP链。

修正后的PHP location块大概是这样：

location ~ \.php(?:$|/) {
    # Required for legacy support
    rewrite ^/(?!index|remote|public|cron|core\/ajax\/update|status|ocs\/v[12]|updater\/.+|ocs-provider\/.+|.+\/richdocumentscode\/proxy) /index.php$request_uri;

    fastcgi_split_path_info ^(.+?\.php)(/.*)$;
    set $path_info $fastcgi_path_info;

    try_files $fastcgi_script_name =404;
    include fastcgi_params;

    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    fastcgi_param PATH_INFO $path_info;
    fastcgi_param HTTPS on;
    fastcgi_param modHeadersAvailable true;         # Avoid sending the security headers twice
    fastcgi_param front_controller_active true;     # Enable pretty urls
    
    # 新增：传递真实客户端IP
    fastcgi_param REMOTE_ADDR $remote_addr;
    fastcgi_param HTTP_X_FORWARDED_FOR $remote_addr;

    fastcgi_pass php-handler;
    fastcgi_intercept_errors on;
    fastcgi_request_buffering off;
    fastcgi_max_temp_file_size 0;
}

2. 配置Nextcloud信任代理

光改Nginx还不够，Nextcloud得知道这个Nginx是可信的代理，才会用它传递过来的IP。编辑Nextcloud根目录下的config/config.php，添加或修改以下配置：

'trusted_proxies' => ['127.0.0.1', '::1'], // 这里填Nginx服务器的IP，本地部署就填127.0.0.1和::1
'forwarded_for_headers' => ['HTTP_X_FORWARDED_FOR'],

如果Nginx前面有其他代理，记得把那些代理的IP也加到trusted_proxies里。

验证修改 #

重启Nginx和PHP-FPM服务，然后去Nextcloud的设置里看“管理 -> 日志”，或者查看PHP的访问日志，应该就能看到真实的客户端IP了。

备注：内容来源于stack exchange，提问作者IssueFindings