Office Online Server 2016 中文版部署与排错实战

简介：面向需要在 Windows Server 环境中部署 Office Online Server 2016 中文版的技术人员，这份 Word 文档整理了一套从零开始的详细安装指引，适合系统管理员、运维工程师及需要搭建在线文档预览与协作环境的学习者参考。压缩包内仅含 1 个 docx 文件，大小约 2.04MB，按安装阶段组织内容，便于逐章查阅、打印或随环境搭建同步对照。文档围绕域控服务器准备、PowerShell 角色与服务安装命令、必备运行库获取与安装、主程序及中文语言包安装、Farm 配置、IIS 网站部署等环节展开，并附有访问验证与常见报错处理思路，可帮助读者对照检查配置中的关键点。文档还覆盖新增林与域控升级、管理员密码设置、DNS 提示忽略、安装路径选择、中文语言包安装顺序、托管发现页面与生成页面验证，以及 IIS 站点绑定和 Discovery.xml、Web.config 标记修改等内容，对关键命令行与界面配图记录较完整，可为实际部署和排错提供对照依据。目前已有 3887 人学习，适合作为部署 OOS 2016 中文版时的实操参考手册。

1. 从一次 500 错误说起：office online 中文版装完打不开的真实原因

上线前一晚，我在一台 Windows Server 2012 R2 上把 office online 中文版装完，语言包也点了，重启后浏览器敲http://192.168.128.160/hosting/discovery，页面正常吐出 XML，心里还挺稳。转头打开http://192.168.128.160/op/generate.aspx，一个白底黑字的「服务器错误」，日志翻半天没个准话。折腾到凌晨才发现，锅不在安装包，而在两个前置动作：域控没提前搭好，Farm 建完之后OpenFromUrlEnabled这个开关没开。这种一台机器既当域控又当预览服务的搭法在中小企业里太常见，装不好就是白屏、500、编辑按钮点不动。适合手上有安装包、正卡在配置环节的人。

2. 环境与域控：Windows Server 版本选择和 AD 域搭建

Office Online Server 2016 不是那种双击 setup 就能跑的绿色软件，它对宿主环境有硬性依赖：机器必须在域里，Web 角色必须齐，.NET 必须卡在 4.5.2。所以真正动手之前，我一般先花十分钟把机器规格、系统版本、IP 规划定死，再开始点角色。这一步省不得，后面所有报错基本都能追溯到环境没铺干净。

2.1 机器规格和系统版本，动手前先定死

测试环境我按下面这张表配，生产环境把 CPU 和内存翻倍就行：

有两个版本细节必须说清楚。第一，系统里如果已经预装了 .NET Framework 4.6 或更高版本，第 3 章那个 4.5.2 的安装包会直接拒绝安装，提示已存在更高版本，这种时候只能先把高版本卸掉再装，别硬装。第二，IP 一旦定下来就别改，改了之后 Farm 的绑定地址全部失效，得删掉 Farm 重建，血泪经验。

2.2 添加 AD 域服务角色

打开服务器管理器，走的是纯图形界面路线，步骤本身不难，难在每一步的选择要一致：

1. 服务器管理器 → 管理 → 添加角色和功能；
2. 安装类型选「基于角色或基于功能的安装」，下一步；
3. 服务器选择本机，下一步；
4. 服务器角色列表里勾上「AD 域服务」，弹窗提示添加所需功能时点「添加功能」；
5. 一路下一步到确认页，点「安装」；
6. 安装完成后，角色列表右侧会出现黄色的「将这台服务器提升为域控制器」提示，点它。

第 4 步的弹窗很多人会顺手点右上角的叉，结果角色没装上，后面提升为域控制器时找不到入口。这个弹窗的意思是「装了 AD 域服务还需要配套的管理工具」，必须点「添加功能」。

一套环境里如果只做测试，域控和 Office Online Server 装同一台机器没问题，我在实验室就这么干。生产环境我一般把域控单独拆一台出来，因为域控重启会连带把预览服务拉下水。

2.3 提升为域控制器：新林、根域名和那条 DNS 警告

进入 AD 域服务配置向导后，最关键的是第一屏：

1. 部署操作选「添加一个新林」，这是单机环境唯一合理的选择；
2. 输入根域名，我用的是lab.demo.local这种内部域名，别用公司对外域名，避免以后解析打架；
3. 林功能级别和域功能级别按默认，跟着系统走；
4. 密码那一栏填一个满足复杂度要求的，比如Abc_12312，这是示例，实际用你自己的，大写 + 小写 + 数字 + 符号，长度 8 位以上，这个密码后面登录域账号要用；
5. 走到 DNS 选项那一步会弹红字警告：「无法创建该 DNS 服务器的委派，因为找不到有权威的父区域」或者「无法与父域通信」——直接忽略，点下一步。
6. 数据库、日志文件、SYSVOL 的路径全部默认；
7. 查看选项页确认 NetBIOS 名称和域名无误；
8. 点「安装」，装完系统会自动重启。

那条 DNS 警告是新手最容易卡住的地方。之所以出现，是因为单机新建林时没有父域可以委派，属于预期行为，不是错误。只要这台机器的 DNS 指向自己（127.0.0.1 或本机 IP），域内解析就是通的。我见过有人为了消掉这条警告去改 DNS 服务器地址，结果把整台机器的解析搞崩。

重启完成后，登录界面会变成LAB\Administrator这种域账号格式，说明域控起来了。第一次登录务必用域管理员账号，后面装 Office Online Server 和跑 PowerShell 命令都得靠它。

2.4 重启之后的三件小事

域控装完不代表环境就绪，还有三个动作我每次都会顺手做掉：

一是确认时间同步，域内机器时间偏差超过 5 分钟会导致后续身份验证失败；

二是放行 80 端口。Office Online Server 默认监听 80（走 HTTPS 是 443），Windows 防火墙默认是拦的，内网其他机器访问 discovery 页面会超时：

# 放行 Office Online Server 需要的 HTTP 端口 New-NetFirewallRule -DisplayName "OOS-HTTP" -Direction Inbound ` -Protocol TCP -LocalPort 80 -Action Allow New-NetFirewallRule -DisplayName "OOS-HTTPS" -Direction Inbound ` -Protocol TCP -LocalPort 443 -Action Allow

-Direction Inbound表示入站规则，-Protocol TCP和-LocalPort 80指定协议端口，-Action Allow是放行。如果不加-Profile参数，默认对域、专用、公用三种网络配置文件都生效，测试环境够用。

三是关掉 IE 增强的安全配置。这一步跟安装本身没关系，但不关的话你在服务器上打开generate.aspx会一直弹「已阻止此网站显示存在安全证书错误的内容」之类的提示，验证环节根本没法看：

# 关闭管理员和用户的 IE 增强安全配置，验证页面时才不会到处弹窗 Set-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Active Setup\Installed Components\{A509B1A7-37EF-4b3f-8CFC-4F3A74704073}" -Name IsInstalled -Value 0 Set-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Active Setup\Installed Components\{A509B1A8-37EF-4b3f-8CFC-4F3A74704073}" -Name IsInstalled -Value 0

两条注册表分别对应管理员账户和普通用户，把IsInstalled置 0 即可关闭，改完重启一次生效。这是临时环境的做法，正式服务器上我一般不动它，改用另一台机器验证。

3. 依赖组件：PowerShell 一条命令装齐 Web 角色与四个补丁

Web 角色这块如果靠图形界面一个个勾，勾漏一个后面就是莫名其妙的 500.19 或者 404。我的做法是直接用Add-WindowsFeature一条命令拉齐，装完再拿Get-WindowsFeature核对一遍。角色装完之后才是那四个必备软件，顺序和版本都有讲究，装反了安装程序会给你脸色看。

3.1 那条 Add-WindowsFeature 长命令，逐组拆开看

以管理员身份打开 PowerShell，把下面这条整体粘进去：

# 一次性安装 Office Online Server 所需的全部 Web 角色与 .NET 功能 # 反引号 ` 是 PowerShell 的续行符，粘贴时可以整段贴，也可以手动合并成一行 Add-WindowsFeature Web-Server,Web-Mgmt-Tools,Web-Mgmt-Console,Web-WebServer, ` Web-Common-Http,Web-Default-Doc,Web-Static-Content,Web-Performance, ` Web-Stat-Compression,Web-Dyn-Compression,Web-Security,Web-Filtering, ` Web-Windows-Auth,Web-App-Dev,Web-Net-Ext45,Web-Asp-Net45,Web-ISAPI-Ext, ` Web-ISAPI-Filter,Web-Includes,InkandHandwritingServices,NET-Framework-Features, ` NET-Framework-Core,NET-HTTP-Activation,NET-Non-HTTP-Activ,NET-WCF-HTTP-Activation45, ` Windows-Identity-Foundation,Server-Media-Foundation

参数是一串功能名的逗号分隔列表，少一个都可能让后面的安装或者预览功能出问题。按作用分组看会更清楚：

InkandHandwritingServices和Server-Media-Foundation这两个最容易被忽略，因为名字看起来跟办公预览没关系。但只要你的用户会在预览页上做批注、或者 PowerPoint 里嵌了音频，缺了它们就是功能残缺而不是报错，排查起来极度玄学。

命令跑完会列一张表，Success那一列全是True才算过。中途报某个功能名不存在，一般是系统版本差异，Windows Server 2016 上个别功能名有变化，按提示删掉找不到的那一项重跑即可。

3.2 四个必备软件的安装顺序和版本取舍

Web 角色装完，接着是四个软件。这四个的安装顺序我固定按下面的来，原因是后者依赖前者的运行时：

第一个装 .NET Framework 4.5.2，双击安装包，勾选「我已阅读并接受许可条款」，点「安装」，完成后点「完成」。如果这一步提示「已在此计算机上安装更高版本」，别怀疑安装包坏了，去控制面板看是不是预装了 4.6 以上，卸掉重来。

第二、第三个是 VC++ 运行库，都是勾许可、点安装、点关闭三步。2013 和 2015 两个版本并存不冲突，别只装一个图省事，有的转换进程会同时加载两套运行时。

第四个是Microsoft.IdentityModel.Extention.dll，双击后界面是英文的，勾I accept the terms in the License Agreement，点install，完成点关闭。这里有个拼写注意点：文件名的Extention确实是这么拼的，不是笔误的Extension，搜索下载的时候按原名找，改成正确拼写反而搜不到东西。安装完成后建议去C:\Windows\Microsoft.NET\assembly下面确认一下 dll 落地了，没有的话后面 WOPI 校验会报找不着程序集。

3.3 装完先自检，别急着点 setup.exe

四个软件装完，我会跑一遍自检，确认角色真的装进去了、框架版本真的对：

# 检查关键 Web 功能的安装状态，InstallState 应为 Installed Get-WindowsFeature Web-Server,Web-Asp-Net45,Web-Windows-Auth,InkandHandwritingServices | ` Select-Object Name,InstallState # 读取 .NET Framework 的 Release 值，判断实际版本 (Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full').Release

Get-WindowsFeature输出里只要有一项是Available而不是Installed，说明那一条没装上，单独补一次。第二个命令读注册表里的Release值，对照关系大致是：378389对应 4.5，379893对应 4.5.2，393295及以上对应 4.6 往上。如果读出来是 393295 这种，说明系统里是高版本，前面那个 4.5.2 的安装包根本没装进去，主程序 setup 大概率会在中途失败——这种情况常见做法是先卸高版本再装 4.5.2，或者直接换一台干净的虚拟机，别在原地反复尝试。

4. 安装与配置：OOS 2016 主程序、中文语言包和 Farm 初始化

到这一步环境已经干净了：域控在跑、机器在域里、Web 角色齐、四个运行时补丁到位。剩下的就是三件事——装主程序、装中文语言包、建 Farm。前两件是双击操作，第三件才是真正决定成败的地方，参数填错一个，页面就是白屏或者 500。

4.1 主程序安装：解压路径别带中文

把下载好的 office online server 2016 安装包解压到一个纯英文路径下，比如C:\oos2016\。路径里有中文或者空格，setup 在解压临时文件时偶发失败，报错信息还特别含糊。解压完进目录，双击setup.exe：

1. 勾选「我接受此协议的条款」，点「继续」；
2. 安装路径保持默认，点「立即安装」；
3. 进度条跑完后点「关闭」。

安装过程大概五到十分钟，中途不要点取消。如果进度条卡在某个百分比超过十五分钟不动，先去看事件查看器里的应用程序日志，多半是某个依赖服务没起来，比如 Windows 身份基础或者 WCF 激活。

安装完成后不要立刻去建 Farm，先把语言包装上。

4.2 中文语言包：不装它，预览页面全是英文

中文语言包的安装同样简单，双击安装包，勾许可，点安装，装完关闭。这一步很多人图快跳过，结果预览页面的菜单、右键选项全是英文，用户第一反应是「这系统是不是没装好」。

语言包要在创建 Farm 之前装完。如果 Farm 已经建好才发现没装语言包，常见做法是装完语言包后跑一次iisreset重启 IIS，再清一遍浏览器缓存；实在不生效就Remove-OfficeWebAppsFarm删掉 Farm 重新建，反正这时候还没有业务接入，重建代价很小。这也是我坚持「先语言包、后建 Farm」的原因，顺序对了一次都不用返工。

4.3 创建 Farm：New-OfficeWebAppsFarm 四个参数怎么填

打开 PowerShell，用域管理员账号运行，执行：

# 创建 Office Online Server 服务器场 # 机器必须已加入域，且当前登录账号是域管理员 New-OfficeWebAppsFarm -InternalURL "http://192.168.128.160" -AllowHttp -EditingEnabled

三个参数逐个说：

-InternalURL是内网访问地址，必须填客户端能访问到的地址，可以是 IP 也可以是域名，但要和后面 WOPI 站点、Discovery.xml 里写的一致。填http://192.168.128.160就全程都用这个，别一会儿写主机名一会儿写 IP。

-AllowHttp表示允许 HTTP 访问。生产环境走 HTTPS 的话要换成-CertificateName指定证书，测试环境用-AllowHttp省事。少了这个参数，HTTP 请求会被直接拒掉。

-EditingEnabled打开在线编辑能力。不加的话只能预览、不能编辑，页面上编辑按钮是灰的。

命令执行成功会返回一屏信息，包含 Farm 的创建时间、机器名、版本号。注意引号：从网页上复制命令时经常带进来中文全角引号“”，PowerShell 会报语法错误，遇到意外的标记之类的提示，先把引号改成英文半角。

建完 Farm 之后，IIS 里会自动多出一个站点，监听 80 端口。如果之前 IIS 里已经有默认站点占着 80，Farm 创建会失败或者站点起不来，先停掉默认站点再建。

4.4 Discovery.xml 与 Web.config：WOPI 站点接入的两个改动点

Farm 建好之后，还要部署一个用来验证和接入的 WOPI 站点，这步在 IIS 里操作：

1. 打开 IIS 管理器，右键「网站」→「添加网站」；
2. 网站名自己起，物理路径指向随安装包提供的示例站点目录；
3. 端口填一个不冲突的，比如 8080；
4. 确定之后，去改两个文件。

第一个是App_Data/Discovery.xml，里面每个服务节点下都有一个机器地址，要把它改成 Farm 的 InternalURL：

<!-- Discovery.xml：每个 service 节点下的 machine name 必须指向 Farm 地址 --> <services> <service name="Excel" contentType="application/vnd.ms-excel" url=""> <machine name="http://192.168.128.160" /> </service> <!-- 其余 Word / PowerPoint / OneNote 节点同样处理 --> </services>

这个文件决定客户端拿到预览能力后往哪儿发请求。名字写错、端口写错，表现是预览页能打开但加载文档时一直转圈。

第二个是站点的Web.config，只改主机名和端口两项，键名以你解压出来的示例为准，结构不要动：

<!-- Web.config：主机名与端口要和 Discovery.xml、Farm 的 InternalURL 三方一致 --> <appSettings> <add key="HostName" value="192.168.128.160" /> <add key="HostPort" value="8080" /> </appSettings>

改完保存，回 IIS 里重启一次这个站点。到这里三个地址要保持一致：Farm 的InternalURL、Discovery.xml里的machine name、Web.config里的主机名端口。这三者任意一个对不上，验证环节就会出现「能打开但用不了」的半残状态，比直接报错更难查。

5. 常见问题排查：五个让我重装过两次的坑

这套环境我前后装过六七次，前两次都是推倒重来，后面几次踩的坑越来越靠后。下面这五条按「现象 → 原因 → 解决」记，基本覆盖了从建 Farm 到页面能用之间的绝大多数翻车场景。

5.1 现象：generate.aspx 显示「服务器错误」，discovery 却正常

原因：Farm 建好了，但OpenFromUrlEnabled这个开关没打开。discovery 页面只验证 Farm 是否存在，不校验这个开关，所以给人一种是「装好了」的错觉，generate 页面才真正去调转换服务，一调就挂。

解决：直接在 PowerShell 里补一条：

# 打开「从 URL 打开文档」能力，generate.aspx 依赖这个开关 Set-OfficeWebAppsFarm -OpenFromUrlEnabled:$true

:$true这种写法是 PowerShell 的布尔参数语法，中间不能有空格，写成-OpenFromUrlEnabled: $true会报错。改完不用重启，刷新页面即可。

5.2 现象：New-OfficeWebAppsFarm 报「无法连接到服务器」或者权限相关错误

原因：PowerShell 不是用域管理员身份打开的。用本地管理员跑这条命令，Farm 创建到一半会失败，而且失败后残留的配置会让下一次创建报「Farm 已存在」。

解决：关掉当前 PowerShell，右键「以管理员身份运行」，确认命令行提示符前面显示的是LAB\Administrator这类域账号。如果已经留下残留，先执行Remove-OfficeWebAppsFarm -Force清干净再重建。另外确认这台机器确实在域里，nltest /dsgetdc:lab.demo.local能返回域控信息才算通。

5.3 现象：主程序 setup 装到一半失败，提示缺少 .NET Framework 4.5.2

原因：系统预装了 4.6 或更高版本，第 3 章那个 4.5.2 安装包被跳过没装上，而 Office Online Server 2016 的安装程序检测的是精确版本。

解决：控制面板里卸掉高版本 .NET，重启，重新装 4.5.2，再跑 setup。如果这台机器上还有别的业务依赖高版本框架，别硬卸，直接换一台干净虚拟机重来，比在残废环境上折腾快得多。

5.4 现象：预览页面能打开，点文档一直转圈或者编辑按钮点不动

原因：三个地址不一致。Farm 的InternalURL写的是 IP，Discovery.xml里写的是主机名，或者Web.config里端口还是默认的 80 而站点实际跑在 8080。

解决：拿Get-OfficeWebAppsFarm把 Farm 的实际配置打出来，逐项和两个文件比对，统一改成同一个地址。改Discovery.xml和Web.config后记得重启站点，改 Farm 参数用Set-OfficeWebAppsFarm -InternalURL "http://新地址"，改完iisreset一次。这个坑的隐蔽之处在于不报错，只是慢和点不动，属于典型的黑匣子问题。

5.5 现象：语言包装了，界面还是英文

原因：语言包在 Farm 创建之后才装，Farm 的语言配置没有重新加载；或者浏览器本身的 Accept-Language 是英文。

解决：先iisreset重启，清浏览器缓存再试。还不行就看浏览器语言设置，把它调到中文优先。都不行就删 Farm 重建，重建后语言包会在初始化时被读进去。这条我吃过一次亏，从那以后装机流程里语言包永远排在建 Farm 前面。

6. 装完怎么验证：三个地址加一张验收表

装完不等于能用，我这边的规矩是三个地址全过才算收工。第一个是http://192.168.128.160/hosting/discovery，这个页面返回的是一段 XML，能看到各个服务的 capabilities 信息，说明 Farm 起来了。第二个是http://192.168.128.160/op/generate.aspx，这个页面是一个测试入口，能正常渲染出表单就说明转换服务链路是通的。第三个是你自己加的 WOPI 站点地址，能打开首页并且不报 500.19，说明Web.config没写坏。

除了页面，再补两条命令做交叉验证：

# 查看 Farm 的运行状态与关键开关 Get-OfficeWebAppsFarm | Select-Object FarmOU,Machines,EditingEnabled,OpenFromUrlEnabled,AllowHttp # 确认 IIS 里的 Farm 站点处于 Started 状态 Get-Website | Where-Object { $_.Name -like "*OfficeWebApps*" } | Select-Object Name,State,PhysicalPath

第一条输出的Machines应该是这台机器的名称，EditingEnabled和OpenFromUrlEnabled都应该是True。第二条的State必须是Started，如果是Stopped，页面上表现就是连接被拒绝，而不是 500，很容易误判成网络问题。

把上面这些整理成一张验收表，装机时照着打勾，比凭记忆靠谱：

实际打开文档这一步别省，前面四个全绿但文档打不开的情况我遇到过，原因是Discovery.xml里 PowerPoint 那一节的地址漏改，只改了 Excel 和 Word。所以现在我的习惯是四类文档各点一遍：Word、Excel、PowerPoint、OneNote，一个不落。

从那以后我每次装这套环境，都强制在最后走一遍 generate.aspx 加四类文档实测，不管前面命令返回得多漂亮。踩过的坑多了就知道，命令成功只是纸面成功，页面能点开、文档能翻页才算真的装完。希望帮到你。

本文还有配套的精品资源，点击获取