ONLYOFFICE DocumentServer许可证计数器在VM重启后重置问题的分析与解决

在企业级文档协作系统中，许可证管理是确保合规使用的重要环节。ONLYOFFICE DocumentServer企业版提供了连接数监控功能，通过/info和/info/info.json接口可查看峰值和平均连接数。然而，部分用户发现这些关键指标会在虚拟机重启后被意外重置。

问题现象

运维人员观察到，当运行ONLYOFFICE DocumentServer企业版(版本8.3.2.19)的Linux虚拟机执行重启操作后，系统监控面板中的以下关键指标会被清零：

• 峰值连接数(peak connections)
• 平均连接数(average connections)

这些数据原本应该持续记录系统的负载情况，用于许可证使用情况的长期监控和容量规划。

技术背景

企业版ONLYOFFICE采用Redis作为数据存储后端，主要用于：

1. 实时会话管理
2. 文档协作状态维护
3. 系统运行指标存储
4. 许可证使用统计

其中许可证计数器设计为持久化存储，理论上应不受服务重启影响。Redis的持久化机制通常通过以下两种方式实现：

• RDB(快照)：定期将内存数据转储到磁盘
• AOF(追加日志)：记录所有写操作命令

根本原因分析

经过技术排查，发现问题的核心在于Redis配置不当：

1. 默认安装时可能未启用持久化机制
2. 虚拟机重启导致内存中的数据丢失
3. 未正确配置Redis的持久化策略
4. 系统未对关键指标进行二次备份

解决方案

要确保许可证计数器持久化，需按以下步骤配置Redis：

1. 修改Redis配置文件(通常位于/etc/redis/redis.conf)：

# 启用RDB持久化
save 900 1
save 300 10
save 60 10000

# 启用AOF持久化
appendonly yes
appendfsync everysec

2. 验证配置生效：

redis-cli config get save
redis-cli config get appendonly

3. 重启Redis服务使配置生效：

systemctl restart redis-server

4. 确认数据持久化：

redis-cli keys *license*

最佳实践建议

1. 定期检查Redis持久化文件完整性
2. 设置监控告警，当检测到计数器异常重置时通知管理员
3. 对关键指标进行定期备份
4. 在生产环境部署前，充分测试持久化配置
5. 考虑使用Redis哨兵或集群方案提高可用性

总结

通过正确配置Redis的持久化机制，可以确保ONLYOFFICE DocumentServer企业版的许可证使用统计数据在虚拟机重启等场景下不会丢失。这不仅是许可证合规的要求，也为系统容量规划和性能优化提供了可靠的数据基础。建议所有企业版用户在部署后立即验证Redis配置，避免潜在的数据丢失风险。