ONLYOFFICE 文档服务器在 Windows 上的高级配置：端口修改与 JWT 关闭教程

ONLYOFFICE 文档服务器在 Windows 上的高级配置：端口修改与 JWT 关闭教程

如果你已经成功在 Windows 服务器上部署了 ONLYOFFICE 文档服务器，并且它正在默认的 80 端口上平稳运行，那么恭喜你，你已经迈出了坚实的第一步。然而，对于许多技术团队而言，基础安装仅仅是开始。在实际的生产环境或复杂的内部网络架构中，我们常常需要根据安全策略、端口冲突或特定的集成需求，对默认配置进行深度调整。例如，你可能需要将服务迁移到非标准端口以避免冲突，或者为了简化内部开发流程而关闭 JWT 令牌验证，又或者需要允许来自私有 IP 地址的访问以实现跨子网的协作。这些调整并非简单的点击操作，它们涉及到对 ONLYOFFICE 核心配置文件的深入理解和精准修改。本文将带你深入 ONLYOFFICE 文档服务器在 Windows 环境下的配置腹地，手把手教你完成这些高级定制，让你的文档协作环境更贴合实际业务需求。

1. 理解配置架构与准备工作

在动手修改任何配置之前，花几分钟时间理解 ONLYOFFICE 文档服务器在 Windows 上的文件结构和配置逻辑，能让你在后续操作中游刃有余，避免因误操作导致服务不可用。

ONLYOFFICE 文档服务器（通常指 Document Server）在 Windows 上的默认安装路径是 C:\Program Files\ONLYOFFICE\DocumentServer\。这个目录是整个服务的核心，包含了运行所需的所有二进制文件、前端资源以及至关重要的配置文件。与我们今天主题最相关的配置文件位于 DocumentServer\config 子目录下。这里存放着 JSON 格式的配置文件，它们以层级和覆盖的方式工作，理解这一点是关键。

核心配置文件解析：

• default.json: 这是所有配置的基础蓝图。它包含了 ONLYOFFICE 文档服务器所有可配置参数的默认值。强烈建议不要直接修改这个文件，因为它在软件升级时可能会被覆盖。它的角色是提供一份完整的配置参考。
• local.json: 这是用于自定义覆盖的配置文件。系统在读取配置时，会先加载 default.json 中的默认值，然后用 local.json 中定义的项去覆盖对应的默认值。我们的所有修改都应该在这个文件里进行。如果 local.json 不存在，你可以手动创建它。
• production.json (如果存在): 在某些安装或部署模式下可能会看到，其优先级通常高于 local.json，用于生产环境特定的设置。

这种设计模式非常巧妙，它既保证了默认配置的完整性，又为用户提供了安全、持久的自定义入口。在开始前，请确保你拥有对 C:\Program Files\ONLYOFFICE\DocumentServer\ 目录的读写权限，最好以管理员身份运行文本编辑器（如 VS Code、Notepad++）或命令行工具。

注意：在进行任何配置修改前，