infrarednetwork/onlyoffice-documentserver

ONLYOFFICE Document Server Docker镜像

镜像概述和主要用途

ONLYOFFICE Document Server Docker镜像专为与Nextcloud集成设计，提供文档在线协作编辑功能。通过容器化部署，简化了文档服务器的搭建流程，支持多种文档格式的实时编辑与协作，并确保数据安全与持久化存储。

核心功能和特性

• 文档协作编辑：支持多人实时编辑文档，兼容主流文档格式
• 安全验证：通过JWT密钥验证请求，防止未授权访问
• 持久化存储：使用Docker卷保存日志、数据及配置，避免容器重启数据丢失
• 字体管理：支持添加自定义字体，并可配置跳过字体生成以加速启动
• 依赖集成：内置与PostgreSQL（数据库）、Redis（缓存）、RabbitMQ（消息队列）的集成配置

使用场景和适用范围

适用于需要与Nextcloud集成实现文档在线协作的场景，如企业内部文档管理系统、团队协作平台、教育机构在线作业编辑等。尤其适合对文档实时协作、数据安全有需求的中小型团队。

使用方法和配置说明

前置准备

1. 安装Docker和docker-compose
2. 创建项目目录，并在目录中创建.env文件用于配置环境变量

环境变量配置

在项目根目录创建.env文件，设置JWT密钥（用于验证请求）：

JWT_SECRET=change_me_for_a_strong_secret
# 可选：添加SKIP_FONTS_GENERATION=true以跳过字体生成（加速启动）

启动服务

使用docker-compose部署服务：

bash
docker-compose up -d

服务启动后，docservice将在本地8000端口可用，spellchecker在8080端口可用。需手动配置SSL/TLS代理（参考https://github.com/ONLYOFFICE/document-server-proxy%EF%BC%89%E3%80%82

Docker Compose配置示例

docker-compose.yml

yaml
---
version: '3'

services:
  onlyoffice-documentserver:
    container_name: onlyoffice-documentserver
    image: infrarednetwork/onlyoffice-documentserver:${TAG}
    env_file:
      - .env
    environment:
      - RABBITMQ_SERVER_URL=amqp://guest:guest@onlyoffice-rabbitmq
      - REDIS_SERVER_HOST=onlyoffice-redis
      - REDIS_SERVER_PORT=6379
      - POSTGRESQL_SERVER_HOST=onlyoffice-postgresql
      - POSTGRESQL_SERVER_PORT=5432
      - POSTGRESQL_SERVER_DB_NAME=onlyoffice
      - POSTGRESQL_SERVER_USER=onlyoffice
      - POSTGRESQL_SERVER_PASS=onlyoffice
    restart: always
    ports:
      - '8000:8000'
      - '8080:8080'
    depends_on:
      - onlyoffice-postgresql
      - onlyoffice-redis
      - onlyoffice-rabbitmq
    volumes:
      - onlyoffice-log:/var/log/onlyoffice
      - onlyoffice-www-data:/var/www/onlyoffice/Data
      - onlyoffice-lib:/var/lib/onlyoffice
      - system-custom-fonts:/usr/share/fonts/truetype/custom

  onlyoffice-redis:
    container_name: onlyoffice-redis
    image: redis:alpine
    command: ["redis-server", "--appendonly", "yes"]
    restart: always
    expose:
      - '6379'
    volumes:
      - redis-data:/data

  onlyoffice-rabbitmq:
    container_name: onlyoffice-rabbitmq
    image: rabbitmq:alpine
    restart: always
    expose:
      - '5672'
    volumes:
      - rabbitmq-home:/var/lib/rabbitmq

  onlyoffice-postgresql:
    container_name: onlyoffice-postgresql
    image: postgres
    environment:
      - POSTGRES_DB=onlyoffice
      - POSTGRES_USER=onlyoffice
      - POSTGRES_PASSWORD=onlyoffice
    restart: always
    expose:
      - '5432'
    volumes:
      - postgresql-data:/var/lib/postgresql/data

volumes:
  onlyoffice-log:
  onlyoffice-www-data:
  onlyoffice-lib:
  system-custom-fonts:
  redis-data:
  rabbitmq-home:
  postgresql-data:

添加自定义字体

1. 参考上游文档准备字体文件
2. 将字体文件放入system-custom-fonts卷挂载的本地目录
3. 重启容器后，字体将自动生效（首次启动会生成字体缓存，可能耗时较长）

跳过字体生成

若无需自定义字体，可通过环境变量跳过字体生成以加速启动：

bash
# 在.env文件中添加
SKIP_FONTS_GENERATION=true

注意事项

• 文档版本差异：编辑期间，OnlyOffice会复制Nextcloud文档，此时Nextcloud中的文档版本与编辑版本可能不一致
• 保存机制：所有编辑会话结束后10秒（可配置），文档才会保存回Nextcloud；若服务中断可能导致数据丢失
• 会话过期设置：建议配置闲置会话过期时间（如5分钟），避免文档长时间锁定
• 安全配置：必须设置JWT_SECRET，否则服务可能被未授权访问
• 数据持久化：通过命名卷确保数据持久化，避免容器重启导致数据丢失
• 连接限制：本镜像通过源码编译解除了官方二进制包的20连接限制
• 进程管理：使用bash脚本作为入口点直接调用supervisord，确保容器内僵尸进程被正确处理