$remote_user 可在 log_format 中记录用户认证信息，但仅当启用 auth_basic 或 auth_request 等认证机制后才非空；未认证时为“-”；需正确配置 location、校验凭证，并注意大小写与代理层级。
要在 Nginx 的 log_format 中记录 $remote_user，前提是用户已通过 HTTP Basic Auth 或其他认证模块（如 auth_request）完成身份验证，否则该变量值为空字符串或破折号（-）。
确认 $remote_user 可用的前提
$remote_user 不是客户端直接传入的字段，而是由 Nginx 在完成身份验证后自动填充的变量。它只在以下情况有实际值：
- 使用
auth_basic+auth_basic_user_file配置了基础认证 - 使用
auth_request指令配合上游认证服务（如 OAuth 网关），且上游返回200 OK并设置有效头信息 - 未启用任何认证时，该变量始终为
-
在 log_format 中添加 $remote_user
在 http 块中定义日志格式时，直接将 $remote_user 插入即可。例如：
log_format main '$remote_addr - $remote_user [$time_local] "$request" $status $body_bytes_sent "$http_referer" "$http_user_agent"';
注意：变量之间用空格分隔，无需额外引号包裹（Nginx 会自动处理空格与特殊字符）。若想确保用户名不干扰日志解析，可加双引号包围："$remote_user"。
验证是否生效
配置完成后需重启或重载 Nginx，并触发一次带认证的请求：
- 用
curl -u username:password http://your-site/访问受保护路径 - 检查 access.log，确认对应行中
$remote_user位置显示用户名而非- - 若仍为
-，请检查auth_basic是否作用于该 location，以及用户凭证是否正确
常见问题提醒
几个容易出错的点：
-
$remote_user区分大小写，不要写成$Remote_User或$remoteuser - 如果用了代理（如 CDN 或前置 LB），需确认认证发生在 Nginx 层，而非上游；否则
$remote_user不会被赋值 - 部分第三方模块（如 nginx-auth-ldap）也支持填充该变量，但需按其文档启用对应指令
