【熊说星空】基础管理：星空客户端安装与应用中常见问题2021.07（直播复盘笔记）

主讲老师：荣希（金蝶总部技术支持）

课程链接：金蝶云•星空客户端安装与应用中常见问题

上课时间：2021.07.22 19:00 - 20:00

主要内容：

• 1、 客户端安装方法

• 2、 WPF客户端安装常见问题 

• 3、 报表客户端常见问题

一、金蝶云星空客户端安装方法

（一）云星空客户端访问方式

• 方式01：Silverlight网页版（后续将不支持该种模式），如http://localhost/K3Cloud/sliverlight/index.aspx

• 方式02：Html网页版，如http://localhost/K3Cloud/html5/

• 方式03：WPF客户端，客户端的右下角的服务器地址进行相关配置

  
  

（二）云星空客户端安装方法

1.安装前环境准备

• 建议先关闭防火墙，退出杀毒软件

• 安装.net 4.5或以上版本，建议安装.net 4.5.2或4.7.2版本

• 关于客户端支持的运行环境、推荐的网络配置和硬件配置可参考金蝶云星空发版说明，如金蝶云星空 V7.6_发版说明 (kingdee.com)

• XP系统的电脑已不支持安装云星空客户端

• 苹果MAC系统不支持云星空客户端，建议使用HTML5网页版

2.安装方法

方法一

Step01：登录云星空网页版之后，点用户名下的【下载中心】，选择【GUI客户端】或【GUI客户端（X86）】，按界面提示步骤进行下载安装。

• 说明：如果客户端电脑是64位操作系统，则选择【GUI客户端】，如果是32位操作系统则选择【GUI客户端（X86）】。

• 右键点击桌面上的【此电脑】选择“属性”即可查看“系统类型”。

• 打开开始-运行输入cmd，然后在cmd命令提示窗，输入“systeminfo”，按下回车键加载完后就可以看到系统类型。

Step02：点击【下载安装引导程序】，下载完成之后，从下载的目录解压K3CloudClientPortal.exe.rar文件，然后运行setup.exe文件进行安装

Step03：安装过程无需特殊的配置，按默认选择点击【下一步】进行安装，直到安装完成后点击【完成】，然后输入云星空的访问网址（如下，http://localhost/k3cloud）

Step04：点击【确认】，开始从服务器端加载客户端组件，加载到100%之后，桌面上会生成云星空客户端的快捷方式。

方法二

Step01：直接用浏览器访问如下网址，下载云星空客户端安装包：http://服务器IP或计算机名或域名/k3cloud/clientbin/k3cloudclinetportal.exe

Step02：后面的步骤跟方法一是相同的，解压-运行安装包安装-输入网址-加载客户端文件，安装完成。

（三）云星空报表客户端安装方法

方式一：报表客户端是无法直接在【下载中心】进行下载安装的，而是登录云星空客户端之后，打开报表时直接加载的

方式二：打开客户端安装目录下的kingdee.bos.deskclient.shell.exe文件，输入云星空访问网址，下拉选择“KDSReport“添加，然后点【运行】即可加载出报表客户端。

（四）云星空客户端卸载方法（四个步骤）

方法一：进入控制面板-程序和功能，找到“kingdee cloud deskclient application”，再点击【卸载/更改】即可进行卸载。

方法二：运行云星空客户端安装包，选择【除去】

【说明】卸载重装客户端的安装步骤，参见如下帖子：Cloud客户端安装&卸载及IE设置 (kingdee.com)

（提示：本篇分为两个部分，客户端安装卸载请直接跳第二部分）

先【卸载各类客户端】

后【卸载引导程序】

• 1、以Win10系统为例，打开【控制面板】→【程序和功能】，找到【K/3 Cloud Desktopapplication】这一项，卸载即可。

•   

• 2、删除“我的文档”下的kingdee文件夹，路径示例：“C:\Users\Ethan\Documents\Kingdee”；

• 3、删除客户端路径：C:\Program Files (x86)\Kingdee\K3Cloud\DeskClient

完成这三个步骤，卸载就完成了（无需再通过Kingdee.BOS.DeskClient.Shell.exe单独卸载客户端程序）。

二、云星空客户端安装的常见问题

（一）关于桌面未生成客户端快捷方式，打开客户端报错“kingdee.bos.xpf.app已停止工作”

问题描述

安装完引导程序之后没有弹出输入云星空网址的界面；从而导致桌面上没有生成客户端的快捷方式

打开客户端提示“kingdee.bos.xpf.app已停止工作”

解决方案：.net是否有安装，操作系统版本是否有问题

• 下载安装.net；或者通过360软件关键，直接搜索Microsoft.NET Franework 4.5，即可找到4.5、4.7.2、4.8版本的.net（建议用推荐版本），选择一个版本点击安装

  

• 打开C:\Program Files(x86)\Kingdee\K3Cloud\DeskClient文件夹，运行Kingdee.BOS.DeskClient.Shell文件，输入云星空访问网址，添加client，然后运行即可

• Win10的19041.208版本的系统（.net有异常）出现这问题，直接换操作系统。

  

【注意】

Win7装了.net 4.6.1（先卸载4.6.1或者不卸载）也会提示该问题，主要是由于兼容性问题。

先装.net更高版本，再重新安装星空。

（二）在下载文件【XXX.dll】时发生一些错误

问题描述：

安装完客户端引导程序，在加载WPF客户端时提示“在下载文件【XXX.dll】时发生一些错误”

带SQL的文件

原因分析：

• 服务器上防火墙、杀毒软件、路由器做了拦截导致【取消拦截】

• 服务器上cloud安装目录下\Program Files(x86)\Kingdee\K3Cloud\WebSite\ClientBin\K3CloudClient缺少报错提示中的文件【找到同版本服务器中拷贝】

• 服务器上cloud安装目录下\Program Files(x86)\Kingdee\K3Cloud\WebSite\ClientBin\K3CloudClient文件夹中的K3CloudClient.manifest文件中没有记录报错提示中的文件的内容。【找到同版本服务器中拷贝，如没有联系客服获取】

（三）检测到异常……

问题描述：个别电脑上云星空客户端安装完，登录进去后界面显示空白，或出现提示“检测到异常……”

原因分析：

由于客户端的图片缓存于IE浏览器的Internet临时文件中，故需要访问IE的临时文件的权限，因此当客户端的操作系统下的临时文件夹访问不了、设置不了大小的话会导致该问题。

解决方案：

1. 重置IE

2. 重启电脑

3. 重新设置IE浏览器的Internet临时文件的路径和空间大小

   

（四）未能解析此远程名称：XXX

问题描述：登录云星空客户端提示“未能解析此远程名称：XXX”，网页版也无法

解决方案：

• 这种情况一般都是个别电脑出现，或者个别网络环境上出现

• 在客户端电脑上，打开控制面板-网络和共享中心-本地连接-属性，选择“internet协议版本4（TCP/IPV4）”，然后单击【属性】

• 然后选择DNS服务器地址，建议可改为114.114.114.114、8.8.8.8

（五）服务器更换访问地址客户端如何改

问题描述：服务器更换了访问地址后，客户端每次要输入新的地址，不能默认带出新的地址

解决方案（三选一即可）

• 方案一：打开安装目录下的kingdee.bos.deskclient.shell.exe文件，卸载WPF客户端然后重新添加

• 方案二：直接修改云星空快捷方式的目标里面的服务器地址

• 方案三：检查计算机文档下的\Kingdee\K3Cloud下的ClientConfig.xml文件，将其中KDServiceSite的值修改为正确的服务器地址。【修改配置文件】

（六）多版本客户端无法交叉使用（伙伴工程师比较遇到的比较多）

问题描述：

更新了2021年5月份补丁之后，多版本客户端无法交叉使用

举例：通过7.3的客户端登录7.6产品后，提示未将对象引入具体实例；通过7.6客户端登录7.3产品，登录后白屏

解决方案

建议采用客户端按产品环境分不同目录进行管理。

比如，低版本存放在C:\Program Files(x86)\Kingdee\K3Cloud\DeskClient\K3CloudClient

高版本存放在C:\Program Files(x86)\Kingdee\K3Cloud\DeskClient\K3CloudClient2

1、新建文件夹K3CloudClient2，用来存放另一个版本的客户端文件

2、改配置文件：C:\Program Files(x86)\Kingdee\K3Cloud\DeskClent\App_Data\DeskAppManager.xml

（七）K/3 WISE老客户不希望直接显示所有数据中心

需求描述：K/3 WISE老客户

希望登录云星空客户端或网页版时，不要直接显示出所有的数据中心，只显示自己要用的数据中心

解决方案

变通处理：通过调整应用服务器配置文件，实现客户端登录界面不显示任何数据中心，需要手工输入数据中心名称

1、打开应用服务器的云星空安装目录\Kingdee\K3Cloud\WebSite\App_Data\common.config文件

2、添加如下内容：<!--登录界面选择数据中心是否手工录入 配置1和0，是-1 否-0 -->

<add key="IsLoginManuallnputDC"

value="1"/>

保存该文件

3、然后停止iis，清理net缓存，然后重启iis

（八）卸载不按四个步骤来

需求描述：

卸载客户端报错：“这个产品的安装来源无法使用。请验证来源是否存在，是否可以访问。C:\Windows\Installer\***.msi”

原因分析：

这种情况多数是先手工删除了客户端的目录，然后去卸载程序

解决方案【强制卸载】

• 下载安装msicuu.exe程序

• 打开该程序，选择Kingdee Cloud Desktop Application，点击Remove，移除安装信息即可。

三、报表客户端常见问题

（一）个别电脑上登录云星空客户端后，双击打开报表没有反应

原因分析：

这种情况，一般是没有按正常流程下载安装云星空客户端，而是直接将其它电脑安装好的客户端拷贝到非默认安装路径来使用的。

解决方案

1. 重新登录网页版，正常下载安装云星空客户端

2. 如果一定要直接拷贝使用，可尝试如下帖子中的方案。将客户端拷贝到非默认安装路径，无法打开报表或者下载中心的其他程序 (kingdee.com)
   

（二）部分客户端经常出现财务报表打开进度到96%后出现闪退或打开报表没有反映，无法进入报表

解决方案

1、常规办法，把客户端完整卸载干净重装即可

2、极端异常情况下，卸载重装无效的话，可通过修改客户端安装目录下\K3Cloud\DeskClient\K3CloudClinet\的Kingdee.BOS.KDSReport.exe文件名

以及修改DeskAppManager.xml文件中记录的Kingdee.BOS.KDSReport.exe文件名，比如两处都改为Kingdee.BOS.KDSReport01.exe

3、个别版本可以替换研发重新编译过的报表客户端执行文件

（三）内网使用正常，外网登录Cloud客户端是正常的，但是外网打开报表报错“无法连接到远程服务器”

解决方案

• 确认cloud外网端口是XXXX，到服务器打开控制面板-管理工具-IIS管理器

• 找到IIS-网址-default web site，右键打开编辑绑定，添加XXXX端口，地址设置为“全部未分配”

• 打开路由器映射，将公网映射的端口统一改为XXXX到XXXX，然后重启IIS和路由器

• 应用服务器防火墙需要开放对应的端口号