nginx 本身不支持定时归档或直传对象存储,需通过 logrotate 日志切分、shell 脚本压缩上传、cron 定时触发及 ossutil 工具协同实现冷日志归档。

Nginx 本身不支持定时任务或直接上传文件到对象存储,所谓“Nginx 中配置定时归档”实际是误解——你需要的是在 Nginx 所在服务器上,配合外部工具(如 shell 脚本 + cron)完成日志归档,并将冷日志(如 30 天前的 access.log、error.log 切片)压缩上传至对象存储(如阿里云 OSS、腾讯云 COS、AWS S3 等)。
1. 确保 Nginx 日志按日期切分
直接使用 access.log 单文件不利于归档和清理。建议用 logrotate 或定时脚本每日切分:
- 推荐用 logrotate 配置(/etc/logrotate.d/nginx):
daily
missingok
rotate 90
compress
delaycompress
notifempty
create 0644 www-data www-data
sharedscripts
postrotate
if [ -f /var/run/nginx.pid ]; then
kill -USR1 `cat /var/run/nginx.pid`
fi
endscript
}
这样每天会生成类似 access.log-20241001.gz 的归档文件,天然适合后续识别和同步。
2. 编写归档脚本(上传冷日志到对象存储)
以阿里云 OSS 为例(其他厂商类似),安装 ossutil 工具后,写一个归档脚本(如 /opt/scripts/archive-nginx-logs.sh):
set -e
# 配置项
OSS_BUCKET="oss://your-bucket-name"
LOG_DIR="/var/log/nginx"
AGE_DAYS=30
TEMP_DIR="/tmp/nginx-log-archive"
mkdir -p "$TEMP_DIR"
# 查找并解压指定天数前的 .gz 日志(保留原始时间戳)
find "$LOG_DIR" -name "access.log-*" -mtime +$AGE_DAYS -type f | while read f; do
fname=$(basename "$f")
# 解压到临时目录(避免直接操作原文件)
gunzip -c "$f" > "$TEMP_DIR/${fname%.gz}"
done
# 压缩为单个归档包(按月命名更清晰)
MONTH=$(date -d "$AGE_DAYS days ago" +%Y%m)
TAR_FILE="$TEMP_DIR/nginx-logs-$MONTH.tar.gz"
tar -czf "$TAR_FILE" -C "$TEMP_DIR" $(ls "$TEMP_DIR"/access.log-* 2>/dev/null | grep -v '\.tar\.gz$')
# 上传到 OSS(自动分片,支持断点续传)
if [ -f "$TAR_FILE" ]; then
ossutil cp "$TAR_FILE" "$OSS_BUCKET/archive/$MONTH/" --acl private
echo "Uploaded $TAR_FILE to OSS"
# 可选:上传成功后删除本地临时文件和源 .gz
rm -f "$TEMP_DIR"/* "$LOG_DIR"/access.log-*
fi
注意:
• 脚本需赋予执行权限:chmod +x /opt/scripts/archive-nginx-logs.sh
• ossutil 需提前配置好 AK/SK 和 endpoint(ossutil config)
• 生产环境建议加日志记录、错误告警(如邮件或钉钉)
3. 设置定时任务(cron)
每月 1 日凌晨 2 点运行归档(处理上月冷日志):
0 2 1 * * /opt/scripts/archive-nginx-logs.sh >> /var/log/nginx-archive-cron.log 2>&1或更细粒度(如每 7 天检查一次 30 天前的日志):
0 3 */7 * * /opt/scripts/archive-nginx-logs.sh >> /var/log/nginx-archive-cron.log 2>&1确保 cron 服务已启用:systemctl enable cron && systemctl start cron
4. 安全与运维建议
-
最小权限原则:ossutil 使用子账号 AK,仅授予目标 bucket 的
PutObject权限 -
避免重复上传:脚本中可用
ossutil head检查目标文件是否存在再跳过 - 日志生命周期管理:在对象存储控制台开启生命周期规则,例如“archive/ 目录下文件 180 天后转低频/归档/冷归档存储”
- 验证机制:归档后可校验 tar 包 MD5 并记录到数据库或日志,便于审计
不复杂但容易忽略:Nginx 不管归档,真正起作用的是你部署在系统层的这套组合(logrotate + shell + ossutil + cron)。关键在于日志切分规范、时间判断准确、上传幂等性,以及失败重试机制。











