Nginx 1.7.0+ 原生支持 syslog 协议直连远程服务器,无需中转:需关闭本地文件日志,配置 access_log 和 error_log 指令指向 syslog:server=地址:端口,指定 facility、tag、severity 等参数,并推荐使用 TCP 协议保障可靠性。

Nginx 本身不直接支持将 access_log 发送到远程 syslog 服务器,但可以通过配置本地 syslog(如 rsyslog 或 syslog-ng)中转实现。核心思路是:让 Nginx 把日志写入本地 syslog 设施(facility),再由系统 syslog 服务转发到远程服务器。
1. 修改 Nginx 配置,使用 syslog 输出 access_log
在 http、server 或 location 块中,把原来的文件路径换成 syslog: 协议格式:
access_log syslog:server=127.0.0.1:514,facility=local7,tag=nginx_access,severity=info; error_log syslog:server=127.0.0.1:514,facility=local7,tag=nginx_error,severity=error;
- server=127.0.0.1:514:指向本地 syslog 监听地址(默认 rsyslog 是 UDP 514,也可用 TCP)
- facility=local7:指定 syslog 设施,避免与系统日志冲突,后续便于过滤和转发
- tag=nginx_access:日志标识,方便在远程端识别来源
- severity=info:日志级别,Nginx 会按此设置 syslog 的 priority 字段
2. 配置 rsyslog 转发 local7 日志到远程服务器
编辑 /etc/rsyslog.conf 或新建配置文件(如 /etc/rsyslog.d/99-nginx-remote.conf):
# 启用 UDP/TCP 模块(根据需要选一个)
module(load="imudp")
input(type="imudp" port="514")
<h1>或启用 TCP(更可靠,推荐生产环境)</h1><p>module(load="imtcp")
input(type="imtcp" port="514")</p><h1>将 local7 设施的日志转发到远程 syslog 服务器(例如 192.168.10.100:514)</h1><p>if $syslogfacility-text == 'local7' then {
action(type="omfwd" protocol="tcp" target="192.168.10.100" port="514" template="RSYSLOG_ForwardFormat")
stop
}</p>- 确保远程服务器的 syslog 服务(如 rsyslog 或 syslog-ng)已开启对应协议和端口监听
- 如果远程用的是 UDP,把
protocol="tcp"改为"udp",并确认防火墙放行 -
stop表示匹配后不再继续处理,防止重复记录到本地文件
3. 验证与调试要点
- 重启服务顺序:
systemctl restart rsyslog && nginx -t && systemctl reload nginx - 检查 rsyslog 是否监听:运行
ss -tuln | grep :514 - 查看 rsyslog 错误日志:
journalctl -u rsyslog -f,留意是否报 facility 不识别或连接拒绝 - 临时在远程服务器用
nc -ul 514(UDP)或nc -l 514(TCP)抓包验证是否收到原始日志 - Nginx 的 syslog 输出不支持自定义 log_format,所以日志字段固定为
$remote_addr - $remote_user [$time_local] "$request" $status $body_bytes_sent "$http_referer" "$http_user_agent";如需更多字段,得走 file + logrotate + 自定义脚本方案
4. 替代方案:file + rsyslog input file(适合复杂格式)
若需保留完整 log_format(比如加 $request_time、$upstream_response_time),可先写文件,再用 rsyslog 的 imfile 模块读取并转发:
# Nginx 仍写文件
access_log /var/log/nginx/access.log main;
<h1>rsyslog 配置(/etc/rsyslog.d/99-nginx-file.conf)</h1><p>module(load="imfile")
input(type="imfile" ruleset="nginx_remote" File="/var/log/nginx/access.log" Tag="nginx_access:")</p><p>ruleset(name="nginx_remote") {
action(type="omfwd" protocol="tcp" target="192.168.10.100" port="514" template="RSYSLOG_ForwardFormat")
}</p>- 需确保 rsyslog 有权限读取该日志文件(如加入
rsyslog用户到adm组) - 配合 logrotate 使用时,注意配置
copytruncate或用create+sharedscripts避免丢日志











