文档在线编辑Office Online Server搭建与部署

　　1. 硬件需求

　　至少需要两台服务器，一台域控制器，一台部署Office Online Server

　　使用office online功能，首先需要的是2台主机，其中一台是要安装office Online服务，另一台主机是需要作为域控制器，由这个主机专门负责管理office online主机

　　WOPI Server -> 域控的主机

　　WOPI Client -> 安装office online的主机

　　2. 软件需求

　　Office Online Server 支持的操作系统

　　64 位版本的 Windows Server 2012 R2

　　建议cn_windows_server_2012_r2_vl_with_update_x64_dvd_6052729.iso

　　64 位版本的 Windows Server 2016（要求 Office Online Server 2017 年 4 月或更高版本）

　　建议cn_windows_server_2016_x64_dvd_9718765.iso

　　Office Online Server安装所需依赖以下软件包：

　　.NET Framework 4.5.2

　　Visual C++ Redistributable Packages for Visual Studio 2013

　　Visual C++ Redistributable for Visual Studio 2015

　　Microsoft.IdentityModel.Extention.dll - MicrosoftIdentityExtensions-64.msi

　　Office Online Server程序

　　建议

　　cn_office_online_server_may_2016_x64_dvd_8480704

　　cn_office_online_server_last_updated_march_2017_x64_dvd_10245068.iso

　　Office Online Server语言包

　　建议cn_office_online_server_language_pack_may_2016_x64_8783021

　　3. Office Online Server安装时要注意的几点事项

　　请勿在运行 Office Online Server 的服务器上安装任何其他服务器应用程序。包括 Exchange Server、SharePoint Server、Skype for Business Server 和 SQL Server。如果服务器不足，则可以在这些服务器的其中一台的虚拟机上运行 Office Online Server。

　　不要在端口 80、443 或 809 上安装依赖 Web 服务器 (IIS) 角色的任何服务或角色，因为 Office Online Server 会定期删除这些端口上的 Web 应用程序。

　　不要安装任何版本的 Office。如果已经安装，在安装 Office Online Server 之前必须将其卸载。

　　不要在域控制器上安装 Office Online Server。它不会在包含 Active Directory 域服务 (AD DS) 的服务器上运行

　　最好按照推荐版本进行安装，如果是Windows Server 2016系统，需要安装Office Online Server2017版本，否则安装“墨迹和手写服务”Windows 服务器不满足先决条件

　　步骤一：配置域控服务器【域控主机】

　　最好是硬盘全部格式化的干净的机器安装Windows Server版的纯净系统，关闭服务器防火墙，配置好IP地址，重启

　　配置管理器 ->添加角色和功能 -> 选择Active Directory域服务 -> 安装等待完成，不要关闭 -> 点击"将此服务器提升为域控制器" -> 选择"添加新林" -> 输入根域名如oos.com -> 输入密码 -> 安装，自动重启

　　先决条件检查这一页,出现了问题,因为账号没有设置密码

　　在cmd窗口设置一下administrator 的用户名和密码并使用密码

　　net user administrator "Abc123"

　　net user administrator /passwordreq:yes

　　步骤二：Office Online Server安装角色和服务【OfficeOnline主机】

　　最好是硬盘全部格式化的干净的机器安装Windows Server版的纯净系统，关闭服务器防火墙，配置好IP地址，重启

　　以管理员身份打开 Microsoft PowerShell 提示符，然后运行此命令示例来安装必需的角色和服务。

　　Windows Server 2012 R2:

　　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

　　Windows Server 2016：

　　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,NET-Framework-Features,NET-Framework-45-Features,NET-Framework-Core,NET-Framework-45-Core,NET-HTTP-Activation,NET-Non-HTTP-Activ,NET-WCF-HTTP-Activation45,Windows-Identity-Foundation,Server-Media-Foundation

　　如果报错找不到源文件按如下操作：然后用powershell> Install-WindowsFeature NET-Framework-Core –Source 'd:\Sources\sxs' 安装就成功了。

　　Office Online Server安装所需依赖以下软件包：

　　.NET Framework 4.5.2

　　Visual C++ Redistributable Packages for Visual Studio 2013

　　Visual C++ Redistributable for Visual Studio 2015

　　Microsoft.IdentityModel.Extention.dll - MicrosoftIdentityExtensions-64.msi

　　Office Online Server程序

　　Office Online Server语言包

　　执行上面操作按照顺序依次安装，安装期间如有提示重启就一定要重启服务器

　　步骤三：域控服务器关联配置【OfficeOnline主机设置加入域】

　　检查一下两台主机的IP：

　　域控制器主机:192.168.28.17

　　OfficeOnline主机:192.168.28.16

　　1、在OfficeOnline主机中打开网络属性，找到ipv4的配置，配置DNS为"域控制器的IP"

　　2、把OfficeOnline服务器加入到域服务器的域中，接下来选择隶属于"域"，设置域就是之前安装域控制主机的时候设置的是oos.com，这里直接填入，继续回弹出输入账号密码，这里输入域控制器的用户名和密码即可

　　3、在域控服务器把OfficeOnline主机添加进管理中：打开域控服务器 -> 服务器管理器 -> 管理 -> 添加服务器 -> 立即查找 -> 选中OfficeOnline主机添加 -> 点击左侧的所有服务器,显示联机即可

　　步骤四：部署使用 HTTP（HTTPS） 的单服务器Office Online Server Farm

　　(如果 Microsoft PowerShell 在您运行时无法识别 New-OfficeWebAppsFarm cmdlet，您可能需要导入 OfficeWebApps 模块。请使用此命令：> Import-Module -Name OfficeWebApps)

　　（二选一）第 1 步：创建 Office Online Server 场（HTTP访问方式）

　　使用 New-OfficeWebAppsFarm 命令创建一个包含一台服务器的新 Office Online Server 场，如以下示例中所示

　　命令

　　创建New-OfficeWebAppsFarm -InternalURL "http:// WIN-VLS1CFRJREK.oos.com/" –ExternalUrl "http://1192.168.28.16/" -AllowHttp:$true -EditingEnabled:$true -ClipartEnabled:$true

　　配置Set-OfficeWebAppsFarm –ExternalUrl " http://192.168.28.16/" -AllowHttp:$true -EditingEnabled:$true -ClipartEnabled:$true

　　参数

　　-InternalURL 是运行 Office Online Server 的服务器名称，例如 http://servername。

　　-ExternalUrl 外部访问地址，一般是服务器的ip地址；

　　-AllowHttp 配置要使用 HTTP 的场。

　　-OpenFromUrlEnabled：允许通过url方式进行预览

　　-EditingEnabled 在 Office Online 中启用编辑（如果它与 SharePoint Server 2016 一起使用）。Skype for Business Server 2015 或 Exchange Server 不使用此参数，因为这些主机不支持编辑。

　　-CacheLocation： 缓存文件存放路径 默认是C:\ProgramData\Microsoft\OfficeWebApps\Working\d

　　-CacheSizeInGB： 最大缓存文件大小 单位GB 默认为15GB

　　Get-OfficeWebAppsFarm 返回当前服务器所属的 OfficeWebAppsFarm 对象的详细信息

　　New-OfficeWebAppsFarm 在本地计算机上创建新 Office Online Server 场

　　Set-OfficeWebAppsFarm 配置现有 Office Online Server 场的设置

　　Remove-OfficeWebAppsMachine 从 Office Online Server 场中删除现有服务器(删除Farm)

　　（二选一）第 1 步：创建 Office Online Server 场（HTTPS访问方式，一定要安装证书）

　　使用 New-OfficeWebAppsFarm 命令创建一个包含一台服务器的新 Office Online Server 场，如以下示例中所示。

　　New-OfficeWebAppsFarm -InternalUrl "https://win-vls1cfrjrek.contoso.com" -ExternalUrl "https://192.168.28.11" -CertificateName "OfficeWebApps Certificate" -EditingEnabled

　　参数

　　-InternalURL 是运行 Office Online Server 服务器完全限定的域名 (FQDN)，如 http://servername.contoso.com。

　　-ExternalURL 是可以在 Internet 上访问的 FQDN。

　　-CertificateName 是证书的友好名称。

　　这个时间PS给我们的反馈是“New-OfficeWebAppsFarm : Office Online 找不到指定的证书。” 尽管你在证书管理器中能找到你生成的证书，并且修改了友好名称，重新修改了友好名称，问题还依然存在。出现这种情况，我的解决方案是：域内，安装“证书颁发机构”角色，并配置完成。然后，在IIS中找到“服务器证书”： 我们在右边“操作”区域，点击“创建域证书”： 注意，在“通用名称”一栏需要填写你oos服务器的FQDN，像这样：oos.com，然后在“指定联机证书颁发机构”里，选择你的证书颁发机构的证书，（如果不能选择可以直接创建）这里的好记名称就是友好名称，完成之后，再回到PS中，再次执行创建oos场的命令，我们会欣然地发现：至此解决了内部使用的证书问题。如果想在公网上使用，需要使用公网认可的证书，自签名证书不能正常的工作，需要在IIS中导入证书再使用。

　　-EditingEnabled 为可选，它在 Office Online 中启用编辑（如果它与 SharePoint Server 2016 一起使用）。Skype for Business Server 2015 或 Exchange Server 不使用此参数，因为这些主机不支持编辑。

　　安装期间应该要选择2次“Y”回车，如没有红色报错信息就成功了

　　注意：在执行创建服务场时可能出现提示用户名或者密码不正确，这时需要把两台服务器密码改成相同，并且重启之后即可

　　第 2 步：验证Office Online Server 场

　　打开http://192.168.28.16/hosting/discovery链接，如无错误则表示office online server安装部署成功

　　打开http://192.168.28.16/op/generate.aspx 链接，如无错误则表示office online server安装部署成功

　　此步如有错误显示“服务器错误”，控制台输入Set-OfficeWebAppsFarm -OpenFromUrlEnabled:$true即可访问成功

　　步骤五：配置Office Online服务器相关

　　1、向服务器场中添加更多服务器

　　第一台服务器运行 Office Web Apps Server 后，在要添加到 Office Web Apps Server 服务器场中的每台服务器上运行 New-OfficeWebAppsMachine 命令。 对于 -MachineToJoin 参数，请使用已存在于 Office Web Apps Server 服务器场中的某台服务器的计算机名称。 例如，如果 server1.oos.com 已在服务器场中，请使用以下名称：

　　打开PowerShell

　　New-OfficeWebAppsMachine -MachineToJoin "server1.oos.com"

　　2、文件太大 指定文件大于Office Online Viewer 配置所支持的文件。减少要联机查看的文件的大小

　　安装后的office online server 对大文件会有限制，所以需要配置才能进行访问，具体配置路径如下

　　C:\Program Files\Microsoft Office Web Apps\OpenFromUrlHost

　　C:\Program Files\Microsoft Office Web Apps\OpenFromUrlWeb

　　将上面两个文件夹中的Settings_Service.ini文件进行修改，在文件最后填入以下内容并保存，注意后面不要加分号。

　　OpenFromUrlMaxFileSizeInKBytes=(System.Int32)512000

　　配置完成后使用CMD命令，输入services.msc打开服务，重启office online服务

　　3、根据域名访问office文件

　　由于微软这款软件对IP有访问限制，所以需将IP转化为域名进行访问，所以需要进行配置，来让软件自动进行域名转化为IP，具体路径如下，找到

　　C:\Windows\System32\drivers\etc

　　（注：此IP是指要访问文档路径的IP）以记事本的方式打开hosts文件

　　以“记事本”的形式打开hosts文件，然后在最后一行加入一句话，如下：

　　192.168.28.16 officeserver.oos.com

　　192.168.28.11 officeserver1.oos.com

　　192.168.28.17 oos.com

　　（hosts文件没法直接保存在当前目录。需要以文本的形式保存到其他路径，然后再复制到原路径下）

　　步骤六：部署Wopi项目

　　1.域控服务器安装java环境

　　我们的java 代码在域控服务器上面运行,所以要现在域控服务器上面安装java环境，并配置Windows系统的环境变量，根据Wopi需求选择JAVA版本进行安装

　　2、Wopi代码及打包

　　接下来就是写代码的事了

　　得到一个文件的JSON信息，请求URL：

　　http://192.168.28.17/wopi/files/{file}

　　注： 记得改WOPI项目中application.properties文件里的filepath，即域控服务器上保存要预览的文件的路径，最好的服务器的物理盘

　　其他需要注意的问题

　　1.office online server虚拟机要一直开启

　　2.只要场部署成功了，域控服务器就可以进入office浏览器界面，与wopi代码无关，只是无法成功打开文件

　　3.无论是预览还是编辑文件之前一定要保持域控上jar包也就是wopi项目的运行

　　4.office online server只能打开或编辑docx、xlsx、pptx文件

　　5.要保证域控和OOS虚拟机可以互相通信，比如接在同一个局域网中

　　6.Office Online Server + WOPI 实现在线查看、编辑（协同）Word、Excel、PowerPoint文件，仅支持 docx、xlsx、pptx，不带x格式的文件不支持

　　7.Word的查看、编辑,请求URL：

　　https:// 192.168.28.11/wv/wordviewerframe.aspx （查看）

　　http:// 192.168.28.xx/wv/WordViewer/request.pdf （查看，生成PDF）

　　http:// 192.168.28.16/we/WordEditorFrame.aspx （编辑）