OnlyOffice在线文档怎么搭建-Windows10安装指南

一、部署 ONLYOFFICE 文档开发者版本(简易单机模式)

此种部署方式适合功能快速体验或开发调试等场景，无需外置数据库与消息中间件支持，全部服务均封装于单个安装程序内，省去手动搭建 PostgreSQL 或 RabbitMQ 的步骤。

1、前往 ONLYOFFICE 官方网站下载页面，于“文档服务器”分类下点选“开发者版” Windows 安装包(文件名称类似 onlyoffice-documentserver-de.exe)。

2、双击已下载的安装程序，开启图形界面安装引导流程。

3、如需调整默认服务端口(防止与 IIS 或其他网站服务产生冲突)，可在命令行窗口使用管理员权限运行：onlyoffice-documentserver-de.exe /DS_PORT=8080.此处 8080 可更换为任意空闲端口编号。

4、在安装位置选择步骤，确认或修改安装目标文件夹(默认路径为 C:\Program Files\ONLYOFFICE\DocumentServer\)。

5、勾选“启动 ONLYOFFICE 文档服务器示例”复选框后点击结束，安装进程完结时将自动于浏览器内展示 http://localhost/example 示例页面。

二、部署 ONLYOFFICE 文档社区版本(完整微服务架构)

此方案构建符合生产环境标准的文档服务器，包含相互独立的 PostgreSQL 数据库与 RabbitMQ 消息队列组件，各模块分离部署，具备高负载处理及横向扩展能力，但需预先完成基础环境准备。

1、使用管理员权限启动 PowerShell 或命令提示符，按顺序安装下列必备组件：Erlang OTP(为 RabbitMQ 提供运行环境)、RabbitMQ 服务器、PostgreSQL 14 或更高版本(建议包含 pgAdmin 管理工具)。

2、设置 Erlang 运行环境变量：新建系统变量 ERLANG_HOME 指向 Erlang 的安装目录，并在 Path 变量中追加 %ERRLANG_HOME%\bin。

3、激活 RabbitMQ 管理功能插件：执行指令 rabbitmq-plugins enable rabbitmq_management，随后可通过 http://localhost:15672 地址登入管理控制台并新建用户账号。

4、准备 PostgreSQL 数据库：借助 pgAdmin 工具创建名为 onlyoffice 的数据库，配置所有者权限，并确认数据库监听地址包含本地主机。

5、获取 ONLYOFFICE 文档社区版安装程序，执行时附加数据库连接参数，示例命令：onlyoffice-documentserver-ce.exe /DB_HOST=localhost /DB_NAME=onlyoffice /DB_USER=postgres /DB_PASS=your_password。

三、部署 ONLYOFFICE 协作空间社区版本(一体化协作平台)

该版本不仅具备文档处理功能，还融合邮件收发、日程管理、项目协作等模块，采用 MySQL 作为核心数据存储，安装包已包含全部运行依赖项，适合追求快速部署的中小型组织。

1、从 ONLYOFFICE 官方网站下载 Windows 平台协作空间社区版安装文件(扩展名为 .exe)。

ImageCreator 作为 Photoshop 的免费人工智能增强插件，为创作者提供强大工具，例如文本生成图像、图像转换图像、填充及控制网络等功能。

获取插件

2、双击运行安装程序，同意第三方组件使用条款(包含 .NET Framework 4.8、Visual C++ 可再发行组件包、MySQL Connector/ODBC 8.0 等)。

3、安装引导程序将自动检查并安装缺少的组件;如遇 VC++ 安装报错，需独立下载 vc_redist.x64.exe 并通过静默参数安装：vc_redist.x64.exe /install /quiet /norestart。

4、进入数据库配置环节，选择“启用内置 MySQL 实例”，或填写已有 MySQL 服务器的地址、端口、账户名与访问密码。

5、部署结束后，相关服务将自动注册为 Windows 系统服务，可通过浏览器输入 http://localhost 进入登录首页。

四、服务端口与系统防火墙关键设置

Windows 10 系统内置防火墙默认拦截外部设备访问本地服务端口，必须明确添加放行规则方可实现局域网多终端协同编辑功能。

1、使用管理员权限启动 PowerShell，执行以下指令开放文档服务默认端口：New-NetFirewallRule -DisplayName "ONLYOFFICE HTTP" -Direction Inbound -Action Allow -Protocol TCP -LocalPort 80.

2、若采用自定义端口(例如 8080)，需补充对应规则：New-NetFirewallRule -DisplayName "ONLYOFFICE Custom Port" -Direction Inbound -Action Allow -Protocol TCP -LocalPort 8080.

3、同时放行 RabbitMQ 管理界面端口(15672)与 PostgreSQL 服务端口(5432)，指令格式相同，仅需修改 LocalPort 参数值。

4、查验 Windows Defender 防火墙高级安全设置中的“专用网络”与“公用网络”配置条目，确保所设规则生效范围无误。

五、检查服务运行状况与基本访问测试

安装流程结束后需逐一核验关键服务是否正常启动，避免因后台进程未运行导致前端文档编辑器加载异常。

1、开启 Windows 服务管理窗口(services.msc)，查找以下服务项并确认其运行状态为“已启动”：onlyoffice-documentserver、postgresql-x64-14、RabbitMQ。

2、在浏览器中分别输入下列地址进行访问验证：http://localhost（协作空间主界面）、http://localhost/example（文档功能示例页）、http://localhost:15672（RabbitMQ 管理控制台)。

3、若任一地址返回 404 错误或连接失败提示，请检查对应服务的日志记录：文档服务器日志存放于 C:\Program Files\ONLYOFFICE\DocumentServer\logs\ 路径，PostgreSQL 日志位于其数据目录的 \log\ 子文件夹内。

4、打开浏览器开发者工具(按下 F12 键)切换至网络标签页，刷新页面观察所有请求是否均返回 200 状态码，重点查看 core.woff、editor.bin.js 等核心静态资源是否成功载入。