PocketBase中Nginx反向代理配置下的真实IP获取问题解析

在实际生产环境中，使用Nginx作为PocketBase的反向代理时，开发者经常会遇到获取用户真实IP地址的问题。本文将从技术原理和配置实践两个维度，深入分析这一常见问题的解决方案。

问题现象

当PocketBase部署在Nginx反向代理后方时，服务端日志中显示的客户端IP地址通常为127.0.0.1（即本地回环地址）。这是因为所有请求都经由Nginx转发，PocketBase默认只能看到Nginx服务器的连接信息。

技术原理

HTTP请求在通过中间服务器时，原始客户端信息会发生变化。Nginx作为反向代理，可以通过特定的HTTP头字段（如X-Forwarded-For、X-Real-IP）来传递原始客户端的真实IP信息。

解决方案

1. Nginx配置关键

正确的Nginx配置需要包含以下核心指令：

proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

这些指令会将原始客户端的IP地址通过HTTP头传递给后端服务。

2. PocketBase配置调整

仅配置Nginx是不够的，还需要在PocketBase中明确指定信任的头部字段：

1. 登录PocketBase管理界面
2. 导航至"设置" > "应用" > "用户IP头部字段"
3. 添加相应的头部字段（如X-Real-IP）

3. 验证配置

可以通过以下方式验证配置是否生效：

• 检查请求头是否包含正确的IP信息
• 在PocketBase的日志或钩子函数中验证获取的IP地址
• 使用不同网络环境测试确保IP识别准确

安全注意事项

1. 仅信任来自可信中间服务器的头部信息
2. 考虑设置可信服务器IP范围
3. 对于多层中间服务器，需要特别处理X-Forwarded-For头

扩展知识

在更复杂的部署场景中（如多级中间服务器、云服务环境），可能需要：

• 配置多个可信头部字段
• 实现自定义IP解析逻辑
• 考虑使用CDN特定的IP头（如CF-Connecting-IP）

通过以上配置，开发者可以确保PocketBase在反向代理环境下准确获取用户真实IP地址，为后续的访问控制、日志分析和地理位置服务等功能提供可靠的基础数据。