OnlyOffice组件的安装示例
环境要求
- 激活可道云授权:企业版及以上;更多了解
- 操作系统: CentOS 7+、Ubtntu 14+、Debian 8+、RedHat 7+
- 服务器内存4G以上
- 剩余磁盘空间不少于10G
- 当前登录用户必须是管理员
重要:
本节仅适用于以及购买可道云企业版授权并激活后的用户。免费用户请忽略本环节。
1.安装docker
安装并启动docker服务
$ curl -fsSL https://get.docker.com | bash -s docker
$ systemctl enable docker && systemctl start docker
2.在线部署方式
1.快速启动
$ docker run -itd -p 8001:80 --name kodoffice --restart always \
registry.cn-hangzhou.aliyuncs.com/kodcloud/kodoffice:mini
- onlyoffice缓存目录是
/var/lib/onlyoffice
,如果编辑文件特别多,可以考虑挂载。 - 验证启动成功,在浏览器访问
http://[域名(IP)]:8001/web/
会看到success,运行正常
.
2.以https方式启动
使用已有ssl证书
/data/certs/onlyoffice.key
/data/certs/onlyoffice.pem
- 确认
/data/certs
目录有证书存在(证书名称必须为onlyoffice.key
、onlyoffice.pem
),在执行下方命令启动
$ docker run -itd -p 8001:443 --name kodoffice --restart always \
-v /data/certs:/etc/onlyoffice/documentserver/certs \
registry.cn-hangzhou.aliyuncs.com/kodcloud/kodoffice:mini
- 验证启动成功,在浏览器访问
https://[域名]:8001/web/
会看到success,运行正常
.
更新证书
- 替换证书文件
/data/certs/onlyoffice.key
、/data/certs/onlyoffice.pem
, 注意证书名称不能改变。 - 重启容器服务
docker restart kodoffice
3.注意事项
- 快速启动是http的方式,如果可道云站点使用了https,请选择https的方式部署,否则无法使用
- 8001端口是可以改的,修改后记得填写解析地址到onlyoffice插件配置里面
3.离线部署方式
提示:
- 离线部署请联系可道云技术售后。
4.配置到可道云
1.安装插件
管理员登陆-进入插件中心 (全部)-找到onlyoffice插件,点击安装
2.配置插件
提示:
- 如果office和可道云部署在同一台服务器, 且office使用
8001
端口, 插件则无需任何配置 。
点击配置插件,将上面office所在服务器ip替换到如图选中的内容(注意结尾/web/
不能去除);
点击”检测office服务器”,如果检测通过这说明全部配置完成,刷新可道云页面,选中一个office文件右键打开方式,选择onlyoffice编辑即可体验。
检测结果无误如下图:
注意:
- 上面配置ip也可以是绑定了到该服务器的域名,不能为localhost
- 不知道如何获取本机ip的,可以通过
ifconfig
指令查看- 如果网络内、或服务器开启防火墙,导致访问不了,可以尝试关闭防火墙或开启8001端口
5.其他问题
如何配置https访问
- 如果部署是以https方式启动,直接访问即可
-
如果部署是以http方式启动的,需要配置nginx反向代理来实现https转http,具体实现参考:
server { listen 8443 ssl http2; server_name cloud.example.com; ssl_certificate /etc/ssl/nginx/cloud.example.com.crt; ssl_certificate_key /etc/ssl/nginx/cloud.example.com.key; ssl_protocols TLSv1 TLSv1.1 TLSv1.2 SSLv2 SSLv3; ssl_ciphers HIGH:!aNULL:!MD5:!3DES; ssl_prefer_server_ciphers on; ssl_session_cache shared:SSL:10m; ssl_session_timeout 10m; location / { proxy_pass http://localhost:8001; proxy_set_header Host $host:$server_port; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; #websocket wss代理 proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "Upgrade"; proxy_cache_key $time_local$host$request_uri$is_args$args; proxy_cache_valid 200 304 301 302 1h; add_header X-Cache $upstream_cache_status; expires 3600s; } }
重启系统后如何自启动
- 安装默认已经加入自启动了