主讲老师：陈北春（金蝶总部技术支持）
课程链接：金蝶云星空文件服务器配置及常见问题
上课时间：2021.08.05 19:00 - 20:00
主要内容：
1、了解文件服务五种存储方式
2、学习如何安装及配置文件服务器
3、学习四种附件预览方式及配置方法
4、常见问题处理
其它：
小熊补充的论坛中我自己写的帖子和别人的解决办法
另外我自己遇到的主要是电子回单附件这一块的问题，相关解决办法也附在最后。
一、文件服务器安装及配置
（一）文件服务器是用来干什么的
存储附件（单据附件、基础资料附件）
单据上的附件的位置：
附件列表
单据头或体的附件控件上
上传文件字段
（二）存储方式：总共五种
（1）线下私有云：建议使用文件服务器，不建议使用默认的数据库存储方式（目前数据库存储方式，仅图片类型文件支持在线预览，其他类型的文件，目前都不支持在线预览。）
（2）公有云的亚马逊云存储统一由金蝶总部运维配置
（3）关于数据库存储的疑难点可参考文章：如果文件比较大，会影响数据库的性能。excel文件无法在线预览，报错此文件存储位置为数据库，暂不支持在线预览，但是图片是可以的 (kingdee.com)
（4）金蝶云存储：个人云存储的服务已停止无法使用，企业云存储有用到的企业也不多
（5）对接第三方文件服务实例：文件服务.二开案例.第三方文件服务集成至金蝶云星空 (kingdee.com)
（三）文件服务执行流程图
针对私有云部署文件服务器，不需要外网地址，客户端不需要直接连接文件服务器。
（四）文件服务器安装
【分享】K3 Cloud文件服务器配置指南 (kingdee.com)
金蝶云星空文件服务器部署，包含以下两种情况：
Q&A：
针对于分开部署：因为未勾选【管理站点】，下一步的时候需要连接管理中心配置。
针对于部署在一起：如果一开始安装时未勾选文件服务器，等星空应用服务器都安装好了才想起来需要安装文件服务器怎么办？需要在应用服务器上使用批处理文件，安装文件服务器，请下载压缩包InstallFS.zip（见本文章附件），并在应用服务器所在服务器解压，参照压缩包内的使用说明（或参见下图，红圈和黄色的部分时需要根据目前星空安装包和安装目录中的文件更新的，否则执行批处理时会提示某文件找不到），运行批处理文件，安装文件服务器。可以通过网址测试文件服务器是否部署正常。
如何测试文件服务器已安装，可参考文章中解答（【熊说星空】文件服务器连接异常：请检查地址及端口等配置是否正确，远程服务器返回错误404未找到 (kingdee.com)）第二部分中的前提事项确认：文件服务器是否已部署、是否部署正常
（五）文件服务器与应用服务器分开部署配置
Step01：修改文件服务器上{安装目录}\WebSite\App_Data\Common.config及WebSite\App_Data\Common.config文件中的<add key="managementSiteUrl"value="http://{MC的IP}:8000"/>
Step02：修改管理中心上{安装目录}\ManageSite\App_Data\KDEnvironment.xml文件中
加下述行<WebServer HostName= "fileserver的IP" Type="All" />
需要注意事项：
应用服务器与文件服务器版本必须一致，如果不一致，需要对文件服务器安装补丁，另外需要开放管理中心/应用服务器的8000、8088/8087端口和文件服务器的8088/8087及IIS端口，或者关闭两者的防火墙，否则安装补丁时选择不到文件服务器站点。
（六）文件服务器设置
Step01：使用administrator登录星空，打开基础管理-公共设置-文件服务设置，选择文件服务器，点设置按钮
Step02：打开文件服务器列表，点击新增
| 协议类型 | 可以选择http或者https，默认为http，建议将文件服务器部署在内网，不对外公开，一般用http即可。 若希望使用https，需要修改配置文件，可参考：文件服务设置，配置使用HTTPS (kingdee.com) |
| 文件服务器地址 | 当前部署文件服务器的IP地址（一般内网访问的话配置内网IP地址即可） |
| 端口 | 当前部署文件服务器端口，默认为80端口，可为空 |
| 虚拟目录 | 当前安装文件服务器虚拟目录站点名称，默认为K3CloudFileServer
|
上述参数填完后，需要保存，只有保存成功后才可以设置存储目录。
Step03：新增附件存储目录，必须先在文件服务器上建立存储目录，并授予该目录用户NetWord Service读写权限，且须先启用文件服务器。
填入路径格式：D:\CloudFiles支持设置多个路径，但只有一个默认存储路径，作为文件存储目录。
当设置了一个默认路径后，其它默认路径会被取消。
Step04：配置好后使用检测文件服务器是否可用进行一个全面的检测，检测完成后会给出检测结果，检测不通过的项，根据提示信息进行逐一配置。然后可以测试附件的新增、下载是否正常。
其中9、10检测不通过，不影响附件上传下载，只影响flash及PDF预览方式在线预览
其中2检测不通过，可参考文章【熊说星空】文件服务器连接异常：请检查地址及端口等配置是否正确，远程服务器返回错误404未找到 (kingdee.com)
二、四种附件预览方式介绍
截止金蝶云星空7.7.0.202106版本（直播课程时间为20210805）
一共有4种附件预览方式，在参数设置-BOS平台-文件服务参数中可以设置：
使用flash方式预览（星空最早的方式，将源文件转换生成Flash文件进行预览，要求客户端本地安装flash插件。）
（1）文件服务器上需要安装office2010 32位，预览附件的电脑需要安装flash插件（客户端环境需要安装adobe flash player才能在线预览文件。安装的是：Adobe_Flash_Player_For_IE_ActiveX插件）。
（2）由于安全问题，Adobe公司已停止更新flash，微软也已发文windows系统默认不再支持flash，所以该种预览方式可能出现因flash无法加载，导致预览失败。该种预览方式已不推荐。
（3）如需配置，相关配置方法可以参考：金蝶云星空-文件服务器配置指南 (kingdee.com)中的文件服务器DCOM配置说明（或者本文章附件也放了直播老师讲的录屏）
（4）注意：如果存在首次上传文件转换失败的情况，在线预览时需要进行二次转换，或者可以重新上传文件才可以正常转换，文件的第二次转换则需要应用服务器也安装office2010 32位（针对应用服务器和文件服务器分开部署的情况）。
此处是我在做笔记的时候不知道怎样会遇到这个问题和怎么解决，具体还得待实战。（5）报错示例：Fi提醒，就是配置有问题的。
使用PDF方式预览：该预览方式需要文件服务器上安装office2010 32位，需要与flash在线预览相同的配置和部署，但客户端不需要安装flash。具体介绍可参考星空附件预览：附件支持PDF方式预览 (kingdee.com)
（1）office配置请参考：金蝶云星空-文件服务器配置指南 (kingdee.com)中的文件服务器DCOM配置说明（或者本文章附件也放了直播老师讲的录屏）
（2）注意
①使用pdf方式预览仅支持文件服务器存储附件，云存储附件因为无法部署office暂不支持
②如果存在首次上传文件转换失败的情况，在线预览时需要进行二次转换，或者可以重新上传文件才可以正常转换，文件的第二次转换则需要应用服务器安装office2010 32位，如果需要可安装。
③客户端pdf方式预览，需要客户端操作系统安装IE11及以上版本才可以，因为pdf预览用了IE浏览器的内核。如果用浏览器pdf预览，则没有这个要求。
如果环境之前用的是flash方式预览，后面转为pdf方式预览，可以在数据库中执行：UPDATE T_BAS_FileServerFileInfo SET FSWFLOCATIONPATH = '' WHERE 1 = 1；（执行前可以先备份一下T_BAS_FileServerFileInfo表格），这样之前上传的附件就可以以PDF方式预览了。
此处是我在做笔记的时候不知道怎样会遇到这个问题和怎么解决，具体还得待实战。使用本地文件服务预览：文件服务器附件本地预览 (kingdee.com)
（1）附件存储在文件服务器，启用本地文件服务预览，将下载文件至客户端本地进行预览。
支持使用客户端本地软件来预览附件，例如在线预览word文档，只需客户端安装有office即可。
（2）勾选支持图片时：将下载图片至客户端本地进行预览。不勾的话图片默认在线预览。
（3）配置方法
Step01：管理员administator登陆，打开参数设置-基础管理-BOS平台下的参数：使用本地文件服务器预览
Step02：管理员administator登陆，打开文件服务器配置，打开附件测试功能新增附件，例如选择一个excel文档，点击在线预览，此时弹出本地服务安装界面，点击下载并安装。
Step03：安装好本地服务后，再次点击在线预览，文件会正常打开Excel。
使用第三方预览服务：如对接OfficeWeb365方式预览
文件服务.新增特性.金蝶云星空对接OfficeWeb365第三方预览服务 (kingdee.com)【预览效果可见此处】
TIP：本地文件服务预览跟第三方预览服务，可组合使用，如配置桌面端使用本地文件服务方式预览，移动端使用第三方预览服务。但是不能配置桌面端同时使用本地服务及第三方预览服务方式预览。（1）将OfficeWeb365第三方预览服务集成到金蝶云星空下，支持桌面端及移动端。
（2）OfficeWeb365是第三方产品，星空仅提供对接平台，需要用户自己注册账号，且需要收费，免费版可以使用，但限制较多。相关费用直接交给OfficeWeb365。
前提：星空需要有外网地址（3）配置方法：
Step01：登录OfficeWeb365（地址为：https://officeweb365.com/），录入域名及端口，点击添加。此处的域名设置，是星空站点的域名（要求外网地址）及端口，如果使用https，则添加默认的443端口，如下图：
Step02：点击域名设置，选择需要设置的域名，点击进入基本设置界面，点击开启秘钥，如下图，记下来向量及密钥，星空配置需要用到：
Step03：切换进入高级设置页签，开启文件地址加密，如下图：
Step04：星空BOS平台参数设置：系统管理员登录金蝶云星空系统，进入参数设置界面，选择BOS平台参数设置，切换文件服务参数页签，勾选“使用第三方预览服务”复选框，可选择支持桌面端或移动端，录入网站ID、端口、向量及密钥即可，如下图所示：
三、常见问题
（一）附件下载正常，但下载的文件大小0KB（应用服务器和文件服务器分开部署）
问题原因：文件服务器组件版本与应用服务器不一致
解决办法：需要在文件服务器上更新相同版本补丁。
（二）上传附件提示：远程服务器返回错误：(413）Request Entity Too Large
问题原因：客户端向Web服务器发送一个较长的HTTP请求，超过了ISAPI扩展的UploadReadAheadSize配置的长度，导致失败。
解决办法：打开IIS，依次选择服务器-管理-配置编辑器，节选择到“system.webServer/serverRuntime”修改“uploadReadAheadSize”的值，如附件最大10MB可设置为“10485760”，建议根据附件实际需求修改，不要设置过大的值。（此处的10485760是指：10MB=10*1024KB=10*1024*1024byte）
（三）文件服务器检测或上传附件提示（500）内部服务器错误
问题原因：
（1）文件服务器、应用服务器内存占用超过百分之九十五。
（2）文件服务器组件冲突，或配置文件有误。
解决办法：排查步骤详情参见：文件服务器—在线预览时报500错误解决法 (kingdee.com)
（四）上传附件提示：文件XXXX正由另一进程使用，因此该进程无法访问此文件
问题原因：服务器有程序正在使用这个文件，一般都是服务器安装了加密或者备份的软件，可能中途的时候这些软件来使用附件了。
（五）单据上传了附件，结果附件却找不到了
问题原因：
（1）附件菜单绑定的操作有附件管理操作、单据体附件管理操作，要区分开。
（2）单据列表的附件菜单看到的是单据头上的附件。
（3）单据体挂附件操作时，每行分录都有自己的附件，是分隔开的。
（六）附件下载报错，其它格式的附件下载是正常的，只有某个后缀报错
如后缀为MSG的附件，客户端下载报错“未将对象引用设置到对象的实例”，用浏览器下载提示：很抱歉，您所访问的页面不存在。
其它格式的附件下载是正常的，只有这种后缀为msg格式的附件下载报错。
用浏览器下载提示：
问题原因：IIS站点缺少对应文件后缀的MIME类型
解决办法：后缀为MSG的附件下载报错“未讲对象引用设置到对象的实例” (kingdee.com)
（1）运行输入inetmgr进入IIS管理器；点击左侧根目录，然后在右侧找到MIME类型
（2）双击打开【MIME类型】，然后点击右侧的添加按钮
（3）上图的文件扩展名输入“.msg”，MIME类型输入“application/vnd.ms-outlook”，然后点击【确定】
（4）添加之后，显示如下图所示。
（5）重新登录云星空，重新操作msg格式的附件下载，可以正常下载了。
更多其他格式的添加，可参考如下帖子。
IIS 之 添加MIME扩展类型及常用的MIME类型列表 - Now,DayBreak - 博客园 (cnblogs.com)
（七）附件上传白名单及非法字符限制
问题原因：在参数设置-BOS平台-文件服务参数中可以设置：文件上传白名单和文件名非法字段。
文件上传白名单：限制文件上传的后缀白名单，如：txt，pdf，doc……
文件名非法字符：限制文件名不允许包含的非法字段，如 V:*?"<>;
（八）文件服务工具：附件万能迁移工具
可实现任意存储方式之间互相迁移，灵活高效。迁移过程可溯源，失败数据可回复，安全可控。
相关帖子：
（九）文件服务器迁移（线下的）
若文件服务器迁移，为保证文件服务器的正常操作，
建议文件存储目录保持与旧服务器的一致，文件夹名称及路径要完全相同。
如果文件服务器IP有变化，
旧版本：可以参考下面帖子修改更新数据库：不同文件服务器之间的附件迁移指导 (kingdee.com)
新版本：可以在文件服务器设置里面修改文件服务器地址。
如果文件存储目录有变化，请参考下面帖子修改
（十）文件服务器上传有问题如何获取相关日志
四、其它（论坛中常见问题及解答）【收集中】
（一）【熊说星空】文件服务器连接异常：请检查地址及端口等配置是否正确，远程服务器返回错误404未找到 (kingdee.com)
（二）关于公有云附件预览问题可参考公有云附件预览——PDF预览问题 (kingdee.com)
五、涉及到电子回单附件相关问题汇总
【熊说星空银企】网上银行：浏览和打印电子回单不显示电子回单上的文字 (kingdee.com)
【熊说星空银企】下载电子回单报错：电子回单文件服务器无法访问：由于目标计算机积极拒绝，无法连接 (kingdee.com)
DCOM配置.zip(14.04MB)
InstallFS.zip(0.97KB)
推荐阅读