一、前置知识与系统要求
(一)Docker简介
Docker 是一种开源的容器化平台,它允许开发者将应用程序及其依赖打包成轻量级、独立的容器。这些容器可以在任何支持 Docker 的操作系统上运行,确保了一致性和可移植性。这意味着相同的 Docker 容器可以在不同的操作系统(如 Linux、Windows 或 macOS)上稳定运行。
(二)OnlyOffice 简介
OnlyOffice 是一款功能强大的开源办公套件,提供文档处理、电子表格和演示文稿编辑等功能。它的界面和操作方式类似于 Microsoft Office,并且完全兼容 Office Open XML 格式(如 .docx、.xlsx、.pptx),同时支持实时协作编辑。这使得 OnlyOffice 成为个人和企业日常办公的理想选择。
(三)系统要求
- Linux 系统(以 amd64 架构为例):内核版本需为 3.10 或更高。
- 硬件要求(参考值,适用于非 Docker 环境):
- CPU:双核 2GHz 或更高
- 内存:2GB 或更多
- 硬盘:至少 40GB 可用空间
二、安装步骤
(一)安装 Docker
根据您的操作系统选择相应的安装方法:
- CentOS:
sudo yum install docker-ce -y
sudo systemctl start docker
sudo systemctl enable docker
- Ubuntu/Debian:
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io -y
sudo systemctl start docker
sudo systemctl enable docker
- Windows/macOS:
请从 Docker官网 下载并安装 Docker Desktop,按照官方指南完成安装过程。确保启用 Hyper-V(仅限 Windows)等必要特性。
(二)拉取 OnlyOffice Docker 镜像
sudo docker pull onlyoffice/documentserver:latest
(三)运行 OnlyOffice Docker 容器
您可以使用以下命令来创建和启动一个带有持久化存储的 OnlyOffice 容器:
sudo docker run -i -t \
--name onlyoffice \
--restart always \
-p 8088: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/db:/var/lib/postgresql \
onlyoffice/documentserver:latest
-i
和-t
选项分配了一个伪终端给容器,方便调试。-p 8088:80
将主机的 8088 端口映射到容器的 80 端口,使您可以通过 8088 访问 OnlyOffice DocumentServer。--restart always
确保容器在退出后自动重启。-v
选项用于挂载主机上的目录到容器内部,实现数据持久化存储。
(四)访问 OnlyOffice 服务
一旦容器成功启动,您就可以通过浏览器访问 OnlyOffice DocumentServer。如果端口映射正确,只需在浏览器中输入 <主机IP地址>:8088
即可打开 OnlyOffice 的 Web 界面。
(五)(可选)配置 Supervisor 自动启动(特定环境下需要)
在某些复杂环境中,您可能还需要配置 Supervisord 或其他进程管理工具来确保 OnlyOffice 在服务器重启时自动启动。具体配置取决于您的环境和需求,请参考相关文档进行设置。
三、测试安装是否成功
完成上述所有步骤后,建议进行简单的测试以确认安装无误:
- 打开 OnlyOffice 的 Web 界面,尝试创建或上传一个文档、电子表格或演示文稿。
- 检查文件加载和编辑过程中是否有任何错误提示。
- 如果可以顺利地打开和编辑 .docx 文件等内容,并且没有长时间加载或格式问题,则表明 OnlyOffice 已经成功安装并正常工作。