为 Web App 预览、缩略图和仅查看共享配置 StorageZones Controller
本地文件预览由您的内部部署 Microsoft Office Web 应用程序 (OWA) 服务器呈现。预览存储在 Citrix 管理的存储区域中的文件时,将由 Citrix 托管的或 Microsoft 托管的 OWA 服务器呈现预览。
重要:
白名单要求:
*.sf-api.com
必须可由 Office 联机服务器访问以进行预览和编辑,才能在存储区域版本 5.0 或更高版本上正常工作。
要求
本地文件预览支持的文件类型
- doc、.docm、.docx、.dot、.dotm、.dotx、.odt
- .ods、.xls、.xlsb、.xlsm、.xlsx
- .odp、.pot、.potm、.potx、.pps、.ppsm、.ppsx、.ppt、.pptm、.pptx
- 图像文件(bmp、gif、jpg、jpeg、png、tif、tiff)
本地文件编辑支持的文件类型
- .docm、.docx、.odt
- .ods、.xlsb、.xlsm、.xlsx
- .odp、.ppsx、.pptx
支持的环境
- 标准区域
- 多租户区
- Web 应用程序
白名单/网络考虑
- OOS 服务器应该能够访问
https://\*.sf-api.com
(或 .eu) - SZC 服务器应该能够访问
https://\*.sf-api.com
和https://\*.sharefile.com
(或 .eu) - SZC 服务器应该能够访问 OOS 服务器
https://\<Customer OOS / OWA Endpoint\>/hosting/discovery
(例如,https://oos.sharefileexample.com/hosting/discovery
)
要编辑本地文件, 文件版本控制 必须在您的 ShareFile 帐户上启用。
在 ShareFile Web 应用程序高级首选项菜单中打开 Microsoft Office 联机编辑的设置不会影响编辑本地文件的能力。该特定切换不会控制您编辑本地文件的能力,但将应用于编辑存储在公有云中的任何文件。启用预备文件的编辑完全由 StorageZones Controller Admin 使用以下步骤进行控制。
Microsoft 服务器兼容性
-
Microsoft Server 2016: 同时支持编辑和预览文件功能。也可以禁用编辑。
-
Microsoft Server 2013: 仅支持预览文件的功能。
体系结构和网络示意图
- 通过身份验证的用户请求在 ShareFile 中预览文件。
- ShareFile 发出重定向到客户端设备与 Office Online Server FQDN
- 客户端设备重定向到 Office Online Server FQDN。注意:HTTPS 连接,DNS 应具有内部服务器 IP 的记录或负载平衡器 VIP 的记录,在客户端设备和端口 443 上的任何防火墙之间具有适用的路由。
- Office 在线服务器处理请求,使 API 调用 StorageZones Controller 服务器。注意:HTTPS 连接,DNS 应具有内部服务器 IP 的记录,或负载平衡器 VIP 的记录,在客户端设备和端口 443 上的任何防火墙之间具有适用的路由。
- StorageZones Controller 检查
https://\<DNSname\>/hosting/discovery
是可访问的。只有在可到达时,SZC 才会将 API 响应发送回 Office 在线服务器。注意: StorageZones Controller 必须连接到 Office 联机服务器。两个内部托管服务器之间的 HTTPS 连接。 - StorageZones Controller 将出站连接到 ShareFile API (sf-api.com)。注意:这是通过任何防火墙、代理或出站路由设备的强制出站连接。确保 StorageZones Controller 服务器可以通过 HTTPS/443 到上述记录的 IP 地址进行出站通信。
- Office Online Server 将出站连接到 ShareFile API。注意:这是通过任何防火墙、代理或出站路由设备的强制出站连接。确保 Office Online Server 可以通过 HTTPS/443 到上述记录的 IP 地址进行出站通信。
- 进行预览。
要让 StorageZones Controller 将文件字节流到 OOS,而不是调用 ShareFile 控制平面来下载内容:我们需要更新 StorageZones Controller 上的配置文件之一的密钥。
C:\inetpub\wwwroot\Citrix\StorageCenter\WopiServer\AppSettingsReleaseOnPrem.config 需要更新。
此配置文件有一个密钥 downloadFileFromSC 当前为 false。将密钥更改为 true 并重新启动 IIS。
这样做会更新配置。OOS 也不再调用 ShareFile 控制平面来下载文件内容。
使用此选项时,说明没有从控制平面到 OOS 的入站流量是否正确?
如果使用上述选项,OOS 将不再与 ShareFile 控制平面建立出站连接。
但是,无论是否使用上述选项,ShareFile 控制平面仍会与 OOS 建立出站连接。
使用一种方法与另一种方法是否有优点或缺点?
在这种方法中,OOS 不直接下载文件内容。StorageZones Controller 下载并将文件字节流式传输到 OOS。因此,它将增加在 StorageZones Controller 服务器上的负载。
下载和流式处理文件字节是一项资源密集型任务。根据用户数量和预览和编辑操作的数量, StorageZones Controller 服务器上的负载增加。
启用本地预览和编辑
要支持浏览器内的文档和图像预览、缩略图、仅查看共享客户管理的存储区域中存储的数据以及本地文件编辑,请按照以下方式配置 StorageZones Controller:
-
在 StorageZones Controller 控制台中,单击 ShareFile 数据 选项卡。
-
在“本 地网络共享配置”部分,启用“配 置 Office Web 应用程序预览”。
- 输入您的 Microsoft Office Web 应用程序 (OWA) 服务器的外部 URL。
- 用户必须通过其 Microsoft Office MSDN 订阅下载和配置 OWA 服务器软件。
-
选择 启用 Office 联机编辑 (如果需要)
-
验证 OWA URL 是否可从外部访问。
-
验证您的 Office 联机服务器是否可以与
*.sf-api.com
通信。 -
在 StorageZones Controller 控制台中,单击 监 控选项卡。
- 验证 OWA 服务器连接 是否有绿色复选标记。
注意:
需要 文件版本控制 为 ShareFile 帐户启用编辑本地文件。如果帐户禁用了“文件版本控制”,则本地编辑将不起作用。
重要:
配置时钟同步:
- 验证存储区域 Controller 上的时间是否已与时间 .Windows.com 或其他 NTP 服务器同步。有关配置时钟同步的信息,请单击此处。
修改 OWA URAL 或禁用预览:
- 上述任一操作都需要为每个主 Controller 和次控制器重新启动 IIS 服务。
限制
- 移动应用程序不支持浏览器内编辑。
- 连接器不支持浏览器内预览。
VDR 帐户不支持 WOPI 预览。
有关如何为仅查看共享配置 Citrix ADC 的信息,请参阅 为 StorageZones Controller 配置 Citrix ADC。
排除 OWA 和 OOS 问题
如果您在预览或编辑本地文件时遇到问题,以下步骤将帮助识别和更正特定问题。
要排除配置故障,请先登录 OWA 或 OOS 计算机。
-
验证 Office WebApps 或 OfficeOnline Windows 服务是否在 services.msc 中运行。
-
在新浏览器中,打开
http://localhost/hosting/discovery
页面。如果此页成功加载,则应返回 XML 响应。 -
以管理员身份运行 PowerShell 并执行以下命令:
Get-OfficeWebAppsFarm
如果在响应中收到警告或错误消息,请检查您的配置设置是否存在任何错误或错误。
网络注意事项:
- OOS 服务器应该能够访问
https://*.sf-api.com
(或 .eu) - SZC 服务器应该能够访问
https://*.sf-api.com
和https://*.sharefile.com
(或 .eu) - SZC 服务器应该能够访问 OOS 服务器
https://<CustomerOOS/OWAEndpoint\>/hosting/discovery
。例如https://oos.sharefileexample.com/hosting/discovery
。