ONLYOFFICE Docker DocumentServer 日志输出问题分析与解决方案

问题背景

在使用ONLYOFFICE Docker DocumentServer时，当系统执行日志轮转(log rotation)操作后，原本应该输出到标准输出(stdout)的日志会停止显示。这个问题影响了用户对系统运行状态的实时监控能力。

问题原因分析

深入分析后发现，问题的根源在于日志输出机制的设计方式：

1. 当前实现使用tail -f命令来跟踪日志文件并输出到标准输出
2. tail -f是基于文件描述符(file descriptor)进行跟踪的
3. 当日志轮转发生时，系统会创建新的日志文件，文件描述符发生变化
4. 原始的tail -f进程仍然跟踪旧的、已被轮转的文件描述符
5. 导致新的日志内容无法被捕获并输出到标准输出

解决方案探讨

针对这个问题，技术团队提出了两种可行的解决方案：

方案一：使用tail -F替代tail -f

tail -F(等同于--follow=name --retry)命令可以跟踪文件名而非文件描述符。当日志轮转创建新文件时，它能够自动重新尝试打开同名的新文件，保持日志输出的连续性。

优点：

• 实现简单，只需修改一行命令
• 不需要改变现有的日志轮转配置
• 保持现有的日志轮转行为不变

缺点：

• 仍然依赖外部进程(tail)来转发日志

方案二：修改logrotate配置

通过调整/etc/onlyoffice/documentserver/logrotate/ds.conf配置文件，使用copytruncate选项来避免文件描述符变化：

/var/log/onlyoffice/documentserver/nginx.error.log {
        daily
        missingok
        rotate 30
        compress
        dateext
        copytruncate
        delaycompress
        notifempty
}

/var/log/onlyoffice/documentserver/**/*.log
/var/log/onlyoffice/documentserver-example/*.log {
        daily
        missingok
        rotate 30
        compress
        dateext
        delaycompress
        notifempty
        copytruncate
}

优点：

• 从根本上解决文件描述符变化问题
• 附带好处：不再需要重启nginx和管理服务来完成日志轮转
• 系统行为更加稳定

缺点：

• 需要修改系统配置文件
• 改变了原有的日志轮转机制

问题修复情况

ONLYOFFICE技术团队已经确认这是一个确实存在的bug，并在即将发布的8.1.0版本中修复了这个问题。修复方案采用了上述的方案一，即使用tail -F来确保日志输出的连续性。

技术建议

对于正在使用旧版本的用户，如果遇到此问题，可以采取以下临时解决方案：

1. 手动进入容器修改启动脚本，将tail -f改为tail -F
2. 或者按照方案二修改logrotate配置
3. 升级到8.1.0或更高版本

总结

日志输出是系统监控的重要环节，ONLYOFFICE Docker DocumentServer在8.1.0版本中修复了日志轮转后输出中断的问题，提升了产品的稳定性和可用性。理解这个问题的原因和解决方案，有助于系统管理员更好地维护和监控ONLYOFFICE文档服务。