ONLYOFFICE DocSpace社区版异常断电后的恢复方案

问题现象分析

当运行ONLYOFFICE DocSpace社区版的Ubuntu 20.04服务器遭遇异常断电后，系统重启后出现API返回502错误。通过监控发现多个核心服务进程（如ASC.Files.Service.dll等）出现CPU占用过高现象，且关键微服务（api、files、people-server）处于异常状态。

根本原因诊断

1. 服务崩溃：异常断电导致MySQL数据库损坏，进而引发依赖数据库的微服务链式崩溃
2. 资源瓶颈：DocSpace社区版最低要求16GB内存，10GB配置可能导致OOM（内存不足）
3. 服务依赖：核心服务采用级联依赖架构，任一基础服务（如MySQL）异常将导致上层服务不可用

完整恢复方案

应急恢复步骤

1. 资源扩容：

   # 临时增加swap空间（需root权限）
   fallocate -l 8G /swapfile
   chmod 600 /swapfile
   mkswap /swapfile
   swapon /swapfile
   

2. 服务手动重启：

   # 按依赖顺序重启关键服务
   systemctl restart mysql
   systemctl restart docspace-api
   systemctl restart docspace-files
   systemctl restart docspace-people-server
   

3. 日志分析：

   journalctl -u docspace-api --since "1 hour ago" -p err
   

数据迁移方案（当数据库不可修复时）

1. 文件备份：

   tar czvf docspace_files_backup.tar.gz /var/www/onlyoffice/Data/Products/Files
   

2. 数据库抢救：

   # 尝试修复MySQL（需先停止服务）
   sudo systemctl stop mysql
   sudo mysqld_safe --skip-grant-tables --skip-networking &
   mysqlcheck -r -A
   

3. 重建环境：

   • 新部署DocSpace社区版
   • 恢复文件至相同路径
   • 导入数据库备份（如有）

预防措施建议

1. 硬件配置：

   • 生产环境建议：16GB+内存，SSD存储
   • 配置UPS不间断电源

2. 监控配置：

   # 设置服务监控（示例）
   sudo apt install monit
   echo "check process docspace-api with pidfile /run/docspace-api.pid" >> /etc/monit/monitrc
   

3. 定期备份：

   # 创建自动化备份脚本
   mysqldump -u root -p docspace_db > /backups/docspace_$(date +%F).sql
   

技术要点说明

1. DocSpace采用微服务架构，各组件通过HTTP API通信
2. 文件存储与元数据分离设计：
   • 实际文件存储在/var/www/onlyoffice/Data/Products/Files
   • 文件索引信息存放于MySQL数据库
3. 服务启动顺序要求严格：数据库→核心服务→功能模块

通过上述方案，可有效处理因断电导致的DocSpace服务异常情况。建议生产环境务必配置完善的监控和备份机制，以保障文档协作服务的持续可用性。