前言
之前的文章介绍过如何 为 REBUILD 指定文档预览服务,随着 V4.1 新版本的发布,我们集成了更为便捷的 ONLYOFFICE,可以实现文档预览与 PDF 报表输出(后期还将支持在线编辑),仅需一行命令即可安装,非常方便!
在开始之前,我们建议你基本了解:
- ONLYOFFICE (Document Server)
- Docker 容器
开始安装
ONLYOFFICE (Document Server) 可以通过 docker 命令一键安装,在安装前,请确保你已正确安装 Docker 容器服务,你可以通过以下命令验证:
docker -v
如已正确安装,会打印 Docker 版本信息,否则会显示错误。
确认安装后,我们通过 docker 命令安装/启动 ONLYOFFICE (Document Server),如下:
## 获取镜像
docker pull onlyoffice/documentserver
## 启动
docker run -i -t -d -p 88:80 -e JWT_ENABLED=false DISABLE_DNS_CHECK=true --name onlyoffice onlyoffice/documentserver
安装/启动后,我们可以通过 http://容器地址:88 来测试是否成功(你可以将启动命令中的 88 更换成你想要的端口,同时注意防火墙允许此端口)。
JWT_TOKEN 与 HTTPS
JWT_TOKEN 是 ONLYOFFICE (Document Server) 重要的鉴权密码,启用会更加安全。在上述命令中我们为了方便测试所以关闭了 JWT_ENABLED=false,但在实际应用中建议启用。仅需在启动命令中将 -e JWT_ENABLED=false 去除即可。启用后,请正确获取 JWT_TOKEN 并填写在 REBUILD 配置中即可(详见下文)。
HTTPS 建议使用 Nginx 代理访问,更为灵活。或使用 ONLYOFFICE (Document Server) 自带的 HTTPS 配置,具体请参考此文 www.onlyoffice.com/blog/zh-han…
使用宝塔安装
如果上述安装方式有困难,正巧你使用了宝塔面板,也可通过宝塔面板安装。使用宝塔安装还可以同步配置域名、HTTPS 等,更为便捷。
- 建议配置域名使用(需要有域名才能启用 HTTPS)
- 请复制 JWT 密码备用
点击 [确定] 即可开始安装。根据不同的网络情况,安装过程可能持续30分钟-1小时,请耐心等待安装完成。
启用 HTTPS
建议启用 HTTPS 安全访问,宝塔内置 HTTPS 支持。如下图所示,一步步点击操作即可。
配置到 REBUILD 中使用
当我们准备好 ONLYOFFICE (Document Server) 以后,只需将地址与 JWT_TOKEN/JWT密码(如有)填写到 REBUILD 中即可。进入 REBUILD 管理中心 - 通用,如下图所示:
至此,配置完成。如有疑问欢迎留言。
常见问题
如何获取 JWT
安装完成后,进入 ONLYOFFICE 访问页面,复制获取 JWT 命令,然后在服务器上执行即可获取。
安装字体
默认情况下 ONLYOFFICE 仅安装了部分字体,中文环境常用的如宋体、黑体等均未安装,这将导致使用了这些字体的文件不能准确显示,为此你需要为 ONLYOFFICE 安装这些字体。
首先 下载 字体文件,并传输到服务器上,例如放在 /data/custom.zip 目录,然后按照以下命令执行。请注意以下命令的 1-3 步骤为复制字体文件到字体目录,你也可以手动执行复制,而非使用命令。
## d56fd2f8bd3f 为容器 ID,请使用你自己的
## 1.解压
unzip custom.zip
## 2.在容器中新建字体目录
docker exec -u root d56fd2f8bd3f mkdir -p /usr/share/fonts/truetype/custom
## 3.复制字体到容器
docker cp /data/custom/. d56fd2f8bd3f:/usr/share/fonts/truetype/custom/
## 4.重建字体缓存
docker exec -u root d56fd2f8bd3f fc-cache -f -v
## 5.重启容器后生效
docker restart d56fd2f8bd3f