xclient

xclient 指令控制是否将 X-Client 头设置为远程客户端的 IP 地址。 — NGINX Mail Core

xclient
mailmail server
语法xclient on | off;
默认值off
上下文mail, mail server
模块NGINX Mail Core
参数flag

说明

`xclient` 指令在 NGINX Mail Core 中用于管理是否在发出的邮件服务器响应的 X-Client 头中包含远程客户端的 IP 地址。在需要追踪或记录真实客户端 IP 的场景中这尤其有用,尤其是当请求通过另一个服务器代理转发或在实施依赖于原始请求来源的安全措施时。 启用后,NGINX 会将客户端的 IP 插入邮件协议头的 X-Client 字段,后端邮件处理程序或日志服务可以使用该信息。该指令接受一个 flag 参数,允许管理员开启或关闭此行为。需要妥善配置此指令以避免潜在的隐私问题,因为公开客户端 IP 在并非所有场景下都是合适的。 该指令支持的上下文为 mail block 以及邮件服务器配置。这使得可以根据具体服务器实例的部署进行灵活配置,有助于维护反映真实客户端连接的日志,增强各种审计目的的可追溯性。

配置示例

mail {
    xclient on;
}

启用此指令时,请确保您已了解其对隐私的影响,因为它会暴露客户端的 IP 信息。

配置错误可能会导致头部处理出现问题,具体取决于所使用的邮件服务器堆栈。