技术文章
本篇是在 Windows 服务器上准备在线文档服务的记录,为后续与 O2OA 平台对接打基础。安装前要先补齐运行依赖,包括消息队列依赖的语言运行时、队列服务与数据库,社区版无需部署缓存组件,数据库的连接口令与专用账户要提前规划。正式安装文档服务时,若默认端口被站点程序占用会启动失败,可卸载后再以端口参数重新执行安装程序。完成后启动示例服务并访问本地演示页确认可用,再进入平台侧的连接配置。
引言
企业版允许在本地服务器上安装 ONLYOFFICE 文档,并将在线编辑器与 ONLYOFFICE 协作平台或其他流行系统集成。本文将详细介绍在 Windows 服务器上安装 OnlyOffice 社区版的过程,希望对大家有帮助。
ONLYOFFICE Docs 是一个在线办公套件,包含文本、电子表格和演示文稿的查看器与编辑器,完全兼容 office Open XML 格式:.docx、.xlsx 和.pptx,并支持实时协作编辑。
系统要求:
安装必备组件:下载并安装以下组件:
下载安装工具包,并进行相应的安装。
对于这类 exe 执行文件,一般建议大家鼠标右击 ---> 选择以管理员身份运行。
选择需要安装的组件,如下图所示:
选择 Erlang 安装目录,如下图所示:
在安装过程中根据情况,可能会自动安装 C++编译环境,如下图所示:
等待安装完成即可。
选择需要安装的组件(全选),如下图所示:
等待安装完成即可,如下图所示:
![]()
安装比较简单,直接下一步安装即可,此处不再赘述。
点击“下一步”,将密码设置为:123456
数据库密码需要牢记,后续安装 OnlyOffice 时需要用到。
安装比较简单,直接下一步安装即可:
选择需要安装的应用,此处选择 PostgreSQL(64 bit)v15.0-1,如下图所示:
确认需要安装的组件,并指定下载目录:
下载安装后,点击下一步,直到安装完成。
可以使用 pgAdmin 工具或命令提示符创建和管理数据库。
1、运行命令:
"C:Program FilesPostgreSQLpgAdmin 4inpgAdmin4.exe"
2、输入初始密码:123456
创建用户:onlyoffice(密码也是 onlyoffice)
![]()
切换到“定义”选项卡,并在“密码”字段中输入 onlyoffice。
转到“权限”选项卡,然后单击“可以登录吗?”
切换器设置为“是”值
点击“保存”按钮,保存用户权限的设置。
创建一个名为 onlyoffice 的新数据库,Owner 选择刚创建的 onlyoffice 用户,如下图所示:
至此,安装 OnlyOffice 的先决条件已经具备。下面开始安装 OnlyOffice 服务器。
下载 OnlyOffice Docs社区版,下载地址:https://www.onlyoffice.com/download-docs.aspx?from=downloadintegrationmenu#docs-community
选择合适的安装程序版本:For Windows Server2012及以上版本(仅支持64位)
注意:onlyoffice 安装程序默认将80端口作为默认访问端口;如果服务器开启了如 IIS 等类似应用且已占用80端口,可能导致 onlyOffice 服务器无法启动。我们将 OnlyOffice 安装在 C:Program Files 目录下,似乎也无法正常启用80端口。此时,需要卸载之前的安装,并在执行安装程序时指定新端口。
Nginx 日志(C:/Program Files/ONLYOFFICE/DocumentServer/Log/nginx)中报错信息如下:
卸载 OnlyOffice 的过程可以按以下步骤进行:
直接执行C:/Program Files/ONLYOFFICE/Documenterver/unins000.exe 可以进行程序卸载,如下图所示:
等待一段时间,系统将自动完成 OnlyOffice 卸载工作,如下图所示:
1、如果使用80端口作为默认端口,可以直接双击安装程序 onlyoffice-documentserver.exe 进行安装。
2、如果需要使用其他端口作为默认端口,可以在执行安装程序 onlyoffice-documentserver.exe 时添加参数指定默认端口,步骤如下:
默认情况下,ONLYOFFICE Docs 使用端口80侦听传入的连接。从4.3版开始,如果您打算使用 ONLYOFFICE Docs 的端口而非默认端口,可以更改该端口。为此,请使用以下参数运行可执行文件:
onlyoffice-documentserver-ee.exe /DS_PORT=<PORT_NUMBER>
其中<PORT_NUMBER>;是您希望 ONLYOFFICE 文档使用的端口号。
1) 使用 PowerShell 进入安装程序所在的目录:
2) 在 PowerShell 窗口执行命令启动 OnlyOffice 安装程序,如下图所示(DS_PORT 参数后面的数字为需要使用的端口号):
.onlyoffice-documentserver.exe /DS_PORT=8080
指定 OnlyOffice 服务器安装目录:
此处指定为 C:/Program Files/ONLYOFFICE/DocumentServer
1)配置数据库(PostgreSQL)连接信息:
2)配置 RabbitMQ 服务器连接信息:
安装完成,界面如下图所示。
点击 Finish 之后,系统将弹出浏览器访问 example 页面,以验证安装是否成功: http://localhost:8080/example
根据 example 页面的要求,启动 example 服务器,如下图执行命令:
net start DsExampleSvc
在任一目录下执行命令启动 Example 服务器,如下图所示:
如果需要服务器自动启动,可执行命令:
sc config DsExampleSvc start=auto
点击 Go to Test Example按钮 可以跳转到演示页面:
到此,OnlyOffice 服务器安装完成!O2OA 与 OnlyOffice 之间的配置请参考以下文章:
《Office 在线协作(二)- 下载并安装 O2OA 服务器 For Windows Server 2019》
《Office 在线协作(三)- O2OA 连接本地部署的 OnlyOffice Docs Server 服务器 For Windows Server》
相关问题讨论
如何修改 OnlyOffice 配置连接本地部署的 OnlyOffice Docs 服务器?
《Office 在线协作(三)- O2OA 连接本地部署的 OnlyOffice Docs Server 服务器 For Windows Server》
查看原帖讨论 · 15,161 次浏览
自建服务器 onlyoffice 在线协作文档打开一直加载报错下载失败
《Office 在线协作(三)- O2OA 连接本地部署的 OnlyOffice Docs Server 服务器 For Windows Server》
查看原帖讨论 · 74,546 次浏览
onlyoffice 在本地部署了但是无内容显示
《Office 在线协作(三)- O2OA 连接本地部署的 OnlyOffice Docs Server 服务器 For Windows Server》
查看原帖讨论 · 11,461 次浏览
相关内容