windows 10 上部署 onlyoffice 有三类路径：一、开发者版（单机集成，免配依赖）；二、文档社区版（需手动装 erlang/rabbitmq/postgresql）；三、协作空间社区版（安装包自带 mysql 与运行库）。
如果您希望在 Windows 10 系统上本地搭建 OnlyOffice 在线文档服务，则需根据目标版本（开发者版、社区版或企业版）选择对应安装路径。不同版本对系统组件、端口配置及依赖服务的要求存在显著差异。以下是针对 Windows 10 环境的多种可行安装方法：
一、安装 ONLYOFFICE 文档开发者版（轻量级单机部署）
该方法适用于快速验证功能或开发测试场景，不依赖外部数据库与消息队列，所有服务集成于单一安装包中，无需手动配置 PostgreSQL 或 RabbitMQ。
1、访问 ONLYOFFICE 官方下载页面，在“文档服务器”区域选择“开发者版”Windows 安装包（文件名形如 onlyoffice-documentserver-de.exe）。
2、双击运行下载的安装文件，启动图形化安装向导。
3、若需修改默认监听端口（避免与 IIS 或其他 Web 服务冲突），在命令行中以管理员身份执行：onlyoffice-documentserver-de.exe /DS_PORT=8080，其中 8080 可替换为任意未被占用的端口号。
4、在安装路径选择界面，确认或更改目标目录（默认为 C:\Program Files\ONLYOFFICE\DocumentServer\）。
5、勾选“打开 ONLYOFFICE 文档服务器演示”选项后点击完成，安装完成后将自动在浏览器中打开 http://localhost/example 页面。
二、安装 ONLYOFFICE 文档社区版（完整微服务架构）
此方案构建标准生产级文档服务器，包含独立的 PostgreSQL 数据库与 RabbitMQ 消息队列，各组件解耦运行，支持高并发与扩展性，但需提前部署基础依赖。
1、以管理员身份运行 PowerShell 或 CMD，依次安装以下先决条件：Erlang OTP（用于 RabbitMQ 运行时）、RabbitMQ Server、PostgreSQL 14+（含 pgAdmin 工具）。
2、配置 Erlang 环境变量：新建系统变量 ERLANG_HOME 指向 Erlang 安装路径，并在 Path 中添加 %ERLANG_HOME%\bin。
3、启用 RabbitMQ 管理插件：执行命令 rabbitmq-plugins enable rabbitmq_management，然后通过 http://localhost:15672 访问管理界面并创建用户。
4、初始化 PostgreSQL：使用 pgAdmin 创建名为 onlyoffice 的数据库，设置 owner 权限，并确保监听地址包含 localhost。
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 格式）。
2、双击启动安装程序，接受第三方组件许可协议（含 .NET Framework 4.8、Visual C++ Redistributables、MySQL Connector/ODBC 8.0 等）。
3、安装向导将自动检测并安装缺失组件；若提示 VC++ 安装失败，需单独下载并静默安装 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 日志位于 data\log\ 子目录下。
4、在浏览器开发者工具（F12）的 Network 标签页中刷新页面，观察请求是否全部返回 200 状态码，重点关注 core.woff、editor.bin.js 等静态资源加载结果。
