Debian Nginx日志格式自定义指南-Golang-PHP中文网

Debian Nginx日志格式自定义指南

幻夢星雲

发布： 2025-04-05 09:04:14

原创

724人浏览过

debian nginx日志格式自定义指南

本文将指导您如何在Debian系统上自定义Nginx日志格式，包含日志格式定义、在虚拟主机中应用自定义格式以及Nginx重启等步骤，并提供日志回滚方案。

一、自定义Nginx日志格式

修改Nginx配置文件: 打开/etc/nginx/nginx.conf文件。使用log_format指令定义自定义格式。例如，添加$upstream_response_time变量记录上游服务器响应时间：

http {
    log_format my_custom_log '$remote_addr - $remote_user [$time_local] "$request" '
                              '"$status" $body_bytes_sent "$http_referer" '
                              '"$http_user_agent" $upstream_response_time $request_time';
}

登录后复制

应用自定义格式: 在虚拟主机配置文件（通常位于/etc/nginx/conf.d/目录下），使用access_log指令应用自定义格式：

server {
    access_log /var/log/nginx/access.log my_custom_log;
    # ...其他配置...
}

登录后复制

重启Nginx: 保存配置文件后，执行以下命令：

sudo nginx -t  # 检查配置文件语法
sudo systemctl reload nginx # 重新加载配置

登录后复制

二、日志格式参数详解

下表列出常用参数：

参数	说明
`$remote_addr`	客户端IP地址
`$remote_user`	客户端用户名（未认证则为"-"）
`$time_local`	本地时间
`$request`	请求行（例如：GET /index.html HTTP/1.1）
`$status`	HTTP状态码
`$body_bytes_sent`	发送给客户端的字节数
`$http_referer`	HTTP Referer头
`$http_user_agent`	用户代理字符串
`$upstream_response_time`	上游服务器响应时间
`$request_time`	请求处理总时间
`$ssl_protocol`	SSL协议版本（如有）
`$ssl_cipher`	SSL加密套件（如有）
`$upstream_addr`	上游服务器地址

三、日志轮转方案 (Log Rotation)

悟空CRM v 0.5.5

悟空CRM是一种客户关系管理系统软件.它适应Windows、linux等多种操作系统，支持Apache、Nginx、IIs多种服务器软件。悟空CRM致力于为促进中小企业的发展做出更好更实用的软件，采用免费开源的方式，分享技术与经验。悟空CRM 0.5.5 更新日志：2017-04-21 1.修复了几处安全隐患； 2.解决了任务.日程描述显示问题； 3.自定义字段添加时自动生成字段名

284

查看详情

为避免日志文件过大，建议配置日志轮转。可以使用logrotate工具：

配置logrotate: 编辑/etc/logrotate.d/nginx文件（若不存在则创建），添加以下内容：

<code>/var/log/nginx/*.log {
    daily
    rotate 7
    missingok
    notifempty
    compress
    create 0644 nginx nginx
    dateext
    dateformat -%Y-%m-%d
}</code>

登录后复制

此配置每天轮转日志，保留7天，压缩旧日志，并添加日期后缀。