dcoffin88/documentserver

概述

ONLYOFFICE Docs（文档服务器）是一款开源办公套件，包含处理文档、电子表格、演示文稿、PDF及PDF表单所需的所有工具。该套件支持所有流行的办公文件格式（DOCX、ODT、XLSX、ODS、CSV、PPTX、ODP等），并支持实时协作编辑。

从6.0版本开始，Document Server以ONLYOFFICE Docs的名称发布，分为三个版本（社区版、企业版等）。此镜像安装的是免费的社区版，且已启用移动编辑功能。

ONLYOFFICE Docs可作为ONLYOFFICE DocSpace和ONLYOFFICE Workspace的一部分，或与第三方同步共享解决方案（如Odoo、Moodle、Nextcloud、ownCloud、Seafile等）集成，在其界面内实现协作编辑。

重要提示：使用前请将docker-engine更新至最新版本（撰写本文档时为20.10.21）。我们使用ubuntu:22.04作为基础镜像，旧版本Docker与其存在兼容性问题。

核心功能

ONLYOFFICE Docs包含以下强大编辑器：

• ONLYOFFICE文档编辑器
• ONLYOFFICE电子表格编辑器
• ONLYOFFICE演示文稿编辑器
• ONLYOFFICE表单创建器
• ONLYOFFICE PDF编辑器
• ONLYOFFICE图表查看器

这些编辑器支持创建、编辑、保存和导出文本文档、电子表格、演示文稿、PDF，创建和填写PDF表单，打开图表等，并提供以下高级功能：

• 协作编辑（审阅与跟踪更改、评论、聊天）
• AI辅助工具
• 拼写检查
• 无障碍访问
• 可扩展UI选项（包括深色模式）
• 安全工具与服务

ONLYOFFICE Docs支持插件，开发者可添加与OOXML格式不直接相关的特定功能。更多信息请参见https://api.onlyoffice.com/docs/plugin-and-macros/get-started/overview/%E6%88%96%E8%AE%BF%E9%97%AEhttps://github.com/ONLYOFFICE/onlyoffice.github.io%E3%80%82

推荐系统要求

• 内存：4GB或以上
• CPU：双核2GHz或更高
• 交换空间：至少2GB
• 硬盘：至少2GB可用空间
• 操作系统：64位Red Hat、CentOS或其他兼容发行版（内核版本3.8及以上）；64位Debian、Ubuntu或其他兼容发行版（内核版本3.8及以上）
• Docker：1.9.0或更高版本

运行Docker镜像

使用以下命令单独安装ONLYOFFICE文档服务器：

bash
sudo docker run -i -t -d -p 80:80 dcoffin88/documentserver

若需集成社区服务器和邮件服务器安装，请参考相应说明。

配置Docker镜像

数据存储

所有数据存储在指定目录（数据卷）中：

• /var/log/onlyoffice：ONLYOFFICE文档服务器日志
• /var/www/onlyoffice/Data：证书
• /var/lib/onlyoffice：文件缓存
• /var/lib/postgresql：数据库

要从容器外部访问数据，需挂载卷。可在docker run命令中使用-v选项：

bash
sudo docker run -i -t -d -p 80:80 \
    -v /app/onlyoffice/DocumentServer/logs:/var/log/onlyoffice  \
    -v /app/onlyoffice/DocumentServer/data:/var/www/onlyoffice/Data  \
    -v /app/onlyoffice/DocumentServer/lib:/var/lib/onlyoffice \
    -v /app/onlyoffice/DocumentServer/rabbitmq:/var/lib/rabbitmq \
    -v /app/onlyoffice/DocumentServer/redis:/var/lib/redis \
    -v /app/onlyoffice/DocumentServer/db:/var/lib/postgresql  dcoffin88/documentserver

通常无需存储容器数据，但以下情况有用： -方便访问容器数据（如日志） -消除容器内数据大小限制 -使用容器外服务（如PostgreSQL、Redis、RabbitMQ）时

在不同端口运行

要更改端口，使用-p命令。例如，通过8080端口访问：

bash
sudo docker run -i -t -d -p 8080:80 dcoffin88/documentserver

使用HTTPS运行

bash
sudo docker run -i -t -d -p 443:443 \
    -v /app/onlyoffice/DocumentServer/data:/var/www/onlyoffice/Data  dcoffin88/documentserver

可通过SSL保护应用访问，防止未授权访问。CA认证证书可通过CA验证信任，自签名证书也可提供同等信任验证（需客户端额外步骤）。

需创建并安装以下文件：

• /app/onlyoffice/DocumentServer/data/certs/tls.key（私钥）
• /app/onlyoffice/DocumentServer/data/certs/tls.crt（SSL证书）

自动生成Let's Encrypt SSL证书

bash
sudo docker run -i -t -d -p 80:80 -p 443:443 \
    -e LETS_ENCRYPT_DOMAIN=your_domain -e LETS_ENCRYPT_MAIL=your_mail  dcoffin88/documentserver

设置LETS_ENCRYPT_DOMAIN和LETS_ENCRYPT_MAIL变量可自动获取和扩展Let's Encrypt证书。

生成自签名证书

分三步生成：

1. 创建服务器私钥：

bash
openssl genrsa -out tls.key 2048

2. 创建证书签名请求（CSR）：

bash
openssl req -new -key tls.key -out tls.csr

3. 使用私钥和CSR签名证书：

bash
openssl x509 -req -days 365 -in tls.csr -signkey tls.key -out tls.crt

生成的证书有效期为365天。

加强服务器安全

生成更强的DHE参数：

bash
openssl dhparam -out dhparam.pem 2048

安装SSL证书

需安装tls.key、tls.crt和dhparam.pem文件到服务器。默认路径为/var/www/onlyoffice/Data/certs，可通过配置选项更改。

创建目录并复制文件：

bash
mkdir -p /app/onlyoffice/DocumentServer/data/certs
cp tls.key /app/onlyoffice/DocumentServer/data/certs/
cp tls.crt /app/onlyoffice/DocumentServer/data/certs/
cp dhparam.pem /app/onlyoffice/DocumentServer/data/certs/
chmod 400 /app/onlyoffice/DocumentServer/data/certs/tls.key

可用配置参数

以下参数可通过环境变量设置：

• ONLYOFFICE_HTTPS_HSTS_ENABLED：启用HSTS（仅SSL时有效），默认true
• ONLYOFFICE_HTTPS_HSTS_MAXAGE：HSTS max-age值，默认31536000
• SSL_CERTIFICATE_PATH：SSL证书路径，默认/var/www/onlyoffice/Data/certs/tls.crt
• SSL_KEY_PATH：私钥路径，默认/var/www/onlyoffice/Data/certs/tls.key
• JWT_ENABLED：启用JWT验证，默认true
• LETS_ENCRYPT_DOMAIN：Let's Encrypt域名
• LETS_ENCRYPT_MAIL：Let's Encrypt***
• （其他参数请参考原始文档）

使用Docker Compose安装

1. 克隆仓库：

bash
git clone https://github.com/ONLYOFFICE/Docker-DocumentServer

2. 进入目录：

bash
cd Docker-DocumentServer

3. 运行：

bash
docker-compose up -d

IPv6设置（仅Linux主机支持）

Docker默认不为容器提供IPv6地址。需启用此功能：

1. 创建/etc/docker/daemon.json文件：

json
{
"ipv6": true,
"fixed-cidr-v6": "2001:db8:abc1::/64"
}

2. 重启Docker：

bash
systemctl restart docker

容器将获得IPv6地址。更多信息请参考https://docs.docker.com/config/daemon/ipv6/%E3%80%82

问题解决

Docker问题

建议使用最新版本Docker。RPM-based发行版（如Fedora、RHEL/CentOS）可能遇到容器内进程启动失败问题，可尝试setenforce 0禁用SELinux，或切换到Ubuntu。

文档服务器使用问题

文档服务器仅在所有编辑用户关闭文档后才保存。如需停止服务（更新、重启等），需强制断开用户：

bash
sudo docker exec <容器ID> documentserver-prepare4shutdown.sh

执行脚本和断开用户可能需要较长时间（最多5分钟）。

项目信息

• 官方网站：https://www.onlyoffice.com
• 代码仓库：https://github.com/ONLYOFFICE/DocumentServer
• Docker镜像仓库：https://github.com/ONLYOFFICE/Docker-DocumentServer
• 许可证：https://help.onlyoffice.com/products/files/doceditor.aspx?fileid=4358397&doc=K0ZUdlVuQzQ0RFhhMzhZRVN4ZFIvaHlhUjN2eS9XMXpKR1M5WEppUk1Gcz0_IjQzNTgzOTci0
• 免费版与商业版对比：https://github.com/ONLYOFFICE/DocumentServer#onlyoffice-document-server-editions
• SaaS版本：https://www.onlyoffice.com/cloud-office.aspx

用户反馈与支持

如有问题，请访问官方论坛：[***] Overflow提问（标签：onlyoffice）：https://stackoverflow.com/questions/tagged/onlyoffice