金蝶K/3 V12.3安装配置全流程与跨层故障排查

发布时间:2026/10/28 11:21:54
金蝶K/3 V12.3安装配置全流程与跨层故障排查 简介《金蝶K3服务器安装与配置方法详细图解》面向企业IT运维人员、金蝶K/3实施顾问及需要独立部署服务器的技术学习者围绕K/3 V12.3环境搭建中的准备、安装与排错需求提供一份按步骤展开的图解式操作指南。压缩包内共1个doc文件大小约1.97MB以图文文档形式集中呈现安装流程与配置要点便于打印或对照操作。内容覆盖光盘说明与三种安装方式、标准安装顺序、数据库服务部件、中间层服务部件、WEB服务部件及客户端部件安装并延伸至自定义组合安装、K/3自动部署和常见问题分析与解决其中数据库服务器配置建议、数据库引擎选择、非简体中文环境排序设置等细节均有说明可帮助读者判断环境是否满足要求减少因组件顺序或配置不当导致的返工。目前已有4815人学习适合作为部署前查阅和安装过程排错的参考手册。1. 一张 DVD 和四台机器K/3 V12.3 装之前先算清这笔环境账前阵子帮人补装一套 K/3 V12.3中间层组件注册一路通过客户端一登录就弹「中间层服务器连接失败」重装了三遍系统还是老样子。最后查出来跟 K/3 一点关系没有——那台机器压根没启用网络 DTC 访问。金蝶K3服务器安装与配置方法详细图解这类资料真正值钱的地方是把「详细图解」落到每个部件装之前要准备什么、装的时候勾哪个框、装完在哪里验证按顺序摆清楚。K/3 是多台机器分工的一套系统数据库、中间层、WEB、客户端各管一段任何一层少个组件报错都会出现在另一层。下面按我实际装 V12.3 的顺序走一遍从环境检测到客户端登录参数取舍和踩过的坑都标出来。2. 环境检测与安装顺序资源盘先跑安装盘后上K/3 V12.3 的安装介质是一套 DVD不是一张盘。安装光盘里放安装程序、演示账套、资源包和用户手册资源光盘放的是环境检测之后缺的那些系统组件安装程序还有一张用户手册光盘。很多人拿到盘直接双击安装程序装到一半提示缺 .NET、缺 MDAC又回头找盘这就是没先跑环境检测的代价。2.1 三种安装方式别一上来就刻盘官方给了三条路DVD 光驱本机装、共享 DVD 光驱走网络装、把光盘拷到硬盘再共享装。前两种在单机场景没问题多台服务器一起部署时我一般选第三种把安装盘和资源盘各拷一份到文件服务器映射成固定盘符再动手。\\fileserver\k3\install\ ← 金蝶K/3安装光盘(DVD) 整盘拷贝不要只拷 setup \\fileserver\k3\resource\ ← 金蝶K/3资源光盘 整盘拷贝 \\fileserver\k3\manual\ ← 用户手册光盘给实施顾问查路径里别带空格和中文映射成K:、R:这样的盘符最稳。原因是安装过程中会多次在「安装盘」和「资源盘」之间来回切共享光驱换盘要等十几秒四台机器装下来光等换盘就够喝一壶。拷到硬盘还有个好处环境检测报缺哪个组件直接在资源盘目录里找对应安装包不用满世界翻。装之前还有一件事退出杀毒软件和防火墙。原文专门用「注意」标了这条因为 K/3 安装程序要注册大量 COM 组件、写注册表、装服务杀软的实时防护会把其中几步拦下来装完看着成功用起来各种玄学报错。装完再把杀软启回来别嫌麻烦。2.2 环境检测资源盘先跑缺什么补什么环境检测要按角色分开跑不是跑一次就完事。数据库服务器选「数据库服务部件」中间层选「中间层服务部件」客户端选「客户端部件」检测项不一样。检测不通过时程序会列出缺哪些必需部件这时候插入资源光盘按提示把缺的装上再重新检测绿了才换安装盘。这一步最容易翻车的地方是顺序有人先装了 K/3 安装盘再回头补组件结果组件补上了K/3 的注册信息已经写坏只能卸了重来。血泪经验是——环境检测必须全部通过之后再碰安装程序一次都别提前。检测常见缺的几样IIS、ASP.NET、网络 COM 访问、网络 DTC 访问、指定版本的 .NET Framework。前四个在 Windows Server 2003/2008 的「应用程序服务器」里勾具体勾法在第 4 章讲中间层时展开.NET 版本对不上就按资源盘里带的装别自己去网上下个新版K/3 V12.3 对高版本 .NET 的兼容性没保证。2.3 安装顺序数据库服务部件打头客户端收尾正确的部件顺序是数据库服务部件 → 中间层服务部件 → WEB 服务部件 → 客户端部件。这个顺序不是随便排的中间层装完要连数据库做账套管理WEB 部件装完要注册到中间层客户端最后装是因为它连的是中间层地址前面没通客户端装了也登不上。数据库服务部件严格说不是 K/3 的必需组件K/3 数据库服务的主要功能不依赖它工作。但装了它新建账套、备份账套、恢复账套这三种操作可以直接在中间层的账套管理里做不用每次都开 SQL Server 管理工具。我一般都会装图的就是后面省事。64 位 IA64 架构的数据库服务器有个限制不支持数据库服务部件安装上面说的新建、备份、恢复三种账套操作得直接走 SQL Server其他功能不受影响。64 位 x64 没有这个限制这也是为什么现在还能见到 x64 环境的原因之一。2.4 四类角色的硬件底线别拿客户端的标准装服务器原文给了四张配置建议表我把它压成一张对照表装机前对着核一遍比装到一半发现内存不够强。角色CPU内存存储网络数据库服务器最低 1.6GHz / 2 核推荐 2.4GHz4 核起最低 2GB推荐 4GB 起SCSI 以上RAID10生产库与 TempDB 分两个 LUN空闲 10GB 起推荐 50GB100Mbps与中间层建议 1000Mbps中间层服务器最低 1.6GHz / 2 核推荐 2.4GHz200 并发内 4 核最低 1GB200 并发内推荐 2GB200~400 并发 4GBRAID1 或 RAID5空闲 10GB 起推荐 20GB100Mbps与数据库建议 1000MbpsWEB 服务器最低 1.6GHz / 2 核推荐 2.4GHz8 核最低 1GB推荐 4GBRAID1 或 RAID5空闲 10GB 起推荐 20GB100Mbps与中间层建议 1000Mbps客户端单核 1.7GHz 或双核 1.0GHz 起推荐双核 2.0GHz最低 512MB推荐 1GB空闲 4GB 起推荐 8GB100Mbps数据库那行的核心数和内存是按并发量和数据库实体大小分档的100 并发以内或库实体 10GB 以内4 核 4GB100~200 并发或 10~20GB8 核 8GB200~400 并发或 20~40GB16 核 16GB。中间层是 200 并发以内 4 核 2GB200~400 并发 8 核 4GB400 并发以上别硬扛加一台中间层服务器分流。网络质量两个硬指标延时小于 20ms、丢包小于 0.1%都按 1024 字节的测试包算别拿 ping 默认的 32 字节糊弄过去。3. 数据库服务部件SQL Server 版本矩阵与 Chinese_PRC_CI_AS 排序数据库这一层装错后面中间层、WEB、客户端全跟着遭殃而且报错信息往往指向别处。我见过最折腾的一次客户端登录报「账套不存在」实际是数据库排序不是 Chinese_PRC_CI_AS账套里的中文数据读出来全是乱码中间层认不出来。3.1 操作系统和数据库引擎先配对K/3 V12.3 支持的操作系统覆盖面不算窄但每条都有前提。Windows Server 2003 的 Standard / Enterprise / DataCenterSP1 或 SP2包括 R2 版本64 位 x64 同样支持。Windows Server 2008 只支持完全安装服务器核心安装Server Core不认。Windows 2000 Server 系列 SP4 也能跑但不推荐原因是它的 MSDTC 效能较低会拖 K/3 整体性能。数据库引擎这边能选的就三档数据库引擎支持情况备注SQL Server 2005 Standard / Enterprise SP3支持含 64 位 x64标准版没有物理内存上限可以放心用SQL Server 2008 Standard / Enterprise支持含 64 位 x64只支持完全安装SQL Server 2000 Standard / Enterprise SP4能用只推荐企业版标准版最大 2GB 物理内存会压 K/3 性能没列出来的版本不提供官方支持可能能跑也可能跑不起来生产环境别赌。64 位 IA64 的 SQL Server 2005 / 2008 企业版也在支持列表里但前面说过那类机器装不了数据库服务部件账套的新建、备份、恢复要回 SQL Server 里做。3.2 排序规则装完就改不了的那一项非简体中文环境装 SQL Server排序必须设成Chinese_PRC_CI_AS。CI 是大小写不敏感AS 是重音敏感这两项决定了 K/3 数据库里字符串比较和排序的行为。关键是——排序在实例装完之后不能改想改只能重建实例所以装之前一定要确认。SQL Server 2005 / 2008 在安装向导里能直接指定排序SQL Server 2000 得走自定义安装才看得到这一项。装完先用查询确认一遍别信自己刚才点过-- 确认数据库引擎版本、补丁级别和排序规则 SELECT SERVERPROPERTY(ProductVersion) AS 版本, SERVERPROPERTY(ProductLevel) AS 补丁级别, SERVERPROPERTY(Edition) AS 版本类型, SERVERPROPERTY(Collation) AS 服务器排序;ProductVersion用来看大版本和补丁ProductLevel是 SP 级别Edition区分标准版还是企业版最后那个Collation必须是Chinese_PRC_CI_AS。结果不对就趁早重建实例等账套数据导进去再发现返工量是现在的十倍。3.3 实例装完先跑三条检查SQL Server 装完、K/3 数据库服务部件装之前我习惯先跑三条检查把连接层的问题提前掐掉。# 1. 看 1433 端口有没有在监听 netstat -ano | findstr :1433 # 2. 本机用 sqlcmd 连一下SQL Server 2000 环境换成 osql sqlcmd -S 127.0.0.1 -U sa -P 你的密码 -Q SELECT VERSION # 3. 从中间层那台机器远程连一次验证远程连接和防火墙 sqlcmd -S 192.168.10.21 -U sa -P 你的密码 -Q SELECT 1第一条看端口netstat里出现0.0.0.0:1433或具体 IP 的 1433 才算监听只监听127.0.0.1的话远程连不上得去 SQL Server 配置管理器里把 TCP/IP 协议启用并重启服务。第二条验证本机认证方式sa 能连说明混合认证开着。第三条最关键在中间层服务器上跑通了才说明网络和防火墙这关过了——Windows 防火墙默认拦 1433加一条入站规则放行比装完 K/3 再回来查快得多。3.4 BI 模块和 SQL Server 2008 的兼容组件如果客户要用 K/3 商业分析而数据库引擎又是 SQL Server 2008数据库服务器上还得额外装一个「SQL Server 2005 向后兼容组件」它是 SQL Server 2008 Features Pack 的一部分。不装的话 BI 模块连不上库报错信息跟数据库一点不沾边查起来很费劲。这个组件只跟 BI 有关不用 BI 的客户可以跳过。装之前想清楚这套系统未来上不上 BI上的话现在顺手装掉比上线三个月后再停机补装省事。4. 中间层、WEB 与客户端组件依赖、注册与站点配置中间层是 K/3 的中枢客户端连它、WEB 连它、它连数据库任何一段不通都表现为「登录失败」。这一章把中间层、WEB、客户端三块放在一起讲因为它们的安装步骤高度重叠——都是先在 Windows 里勾组件再跑环境检测再装部件最后注册。4.1 应用程序服务器里的四个勾少一个都不行Windows Server 2003 / 2008 上进「控制面板」→「添加/删除 Windows 组件」→ 选「应用程序服务器」→ 点「详细资料」里面勾四项启用网络 COM 访问、启用网络 DTC 访问、ASP.NET、Internet 信息服务IIS。只装中间层、不装 WEB 部件的话前两项是必须的要装 K/3 WEB 或人力资源部件ASP.NET 和 IIS 也得勾上。Windows 2000 Server 环境简单些装 IIS 就行其余步骤跳过。勾完组件记得把网络 DTC 访问的设置过一遍位置在组件服务里组件服务 → 计算机 → 我的电脑 → 属性 → MSDTC 选项卡 → 安全配置确认「网络 DTC 访问」勾上允许入站、允许出站都开验证方式选「不要求验证」。这一步是中间层和数据库之间分布式事务能不能通的关键勾错一个框装完看着一切正常一跑业务单据就报事务错误。# 确认 MSDTC 服务在跑没跑就启起来 sc query msdtc net start msdtcsc query的输出里STATE是RUNNING才算正常。服务没起来时先别急着装 K/3net start msdtc报错多半是组件没勾全或者依赖服务没起回去把 4.1 的四个勾再核一遍。4.2 中间层安装与组件注册中间层服务器的环境检测通过之后换安装盘选「中间层服务部件」。这一步支持自定义安装可以只装部分组件包我一般全装磁盘占用不大后面要用某个组件时不用再补。装完程序会自动跑「注册中间层组件」。如果自动注册那一下闪过去了没看清或者中途报了错手动补一次开始菜单 → 程序 → 金蝶K3 → 金蝶K3服务器配置工具 → 中间层组件注册。注册成功是后面账套管理能打开的前提注册失败的话账套管理里什么都看不到。Windows Server 2003 且打了 SP2 补丁的环境还有一个额外补丁要装KB936296。这个补丁不装中间层某些组件会工作不正常具体表现是客户端登录时报中间层连接异常但中间层服务看着全是启动状态。原文把它单独列在「注意」里不是没有原因的。4.3 账套管理新建、恢复、注册三件事中间层注册完之后从开始菜单进「金蝶K3服务器配置工具」→「账套管理」这里做三件事新建账套、恢复账套、注册账套。新建账套要求数据库服务部件装好了因为 K/3 要在 SQL Server 里建库建表。恢复账套是从备份文件还原同样依赖数据库服务部件。注册账套是把已经存在的数据库挂到中间层上这个不依赖数据库服务部件但要求数据库连接配置正确。账套管理的连接配置里填数据库服务器地址、sa 密码填完点测试。测试不通的话回到第 3 章的三条检查先确认 1433 通不通、排序对不对再回来填。账套列表里能看到账套名说明中间层到数据库这条链路通了可以往下装 WEB 和客户端。4.4 WEB 部件的 IIS、ASP.NET 和站点配置WEB 服务器的组件勾选比中间层多两项除了网络 COM 访问、网络 DTC 访问还要 ASP.NET 和 IIS四个都得在。装完环境检测通过选「WEB 服务部件」安装。装完系统会自动注册 WEB 端服务部件手动入口是「金蝶K3服务器配置工具」→「HR WEB 服务组件注册」。注册完再跑一遍「站点及远程组件配置工具」一路下一步到完成中间按实际部署选模块。这个工具的作用是把 WEB 站点和中间层组件的对应关系写进配置跳过了这步站点能打开但登录会失败。4.5 HR 登录不了先改 config 里的 localhostWEB 服务器和中间层分开部署的环境有一个坑几乎人人踩HR 客户端平台登录不进去页面能出来输完账号密码就卡住或者报错。原因是 WEB 端的配置文件里WebService 地址还写着localhost指的是 WEB 服务器自己而 HR 服务实际在中间层那台机器上。用记事本打开Kingdee\K3ERP\KDHRAPP\IISServer\server\Kingdee.K3.HR.Server.exe.config找到这一行!-- 默认指向本机WEB 与中间层分机部署时必须改成中间层 IP -- add keyk3hrwebservice valuehttp://localhost/k3hrwebservice/ /把localhost换成中间层服务器的 IPadd keyk3hrwebservice valuehttp://192.168.10.21/k3hrwebservice/ /改完保存重启KDHRHost服务让配置生效# 重启 HR 宿主服务配置才会重新加载 net stop KDHRHost net start KDHRHostk3hrwebservice这个键名不能改只能改 value。IP 用中间层的固定地址别用机器名内网 DNS 解析出问题的时候机器名会变成新的玄学。改完再登 HR 客户端基本就通了。4.6 客户端XP 到 Win7IE 只认 32 位客户端支持的操作系统跨度很大Windows XP Professional SP2/SP3、Vista 的 Ultimate / Enterprise / Business SP1、Windows 7 的四个版本、Windows Server 2003、Windows 2000 Professional 系列 SP432 位和 64 位都有对应条目。Windows 2000 系列不推荐原因还是 MSDTC 效能。客户端部件安装本身不复杂跑环境检测选「客户端部件」缺组件就插资源盘补通过后装客户端部件可以自定义只装部分组件。真正要注意的是浏览器只有 HR / CRM / Portal 的 Web 客户端需要浏览器普通 K/3 GUI 客户端不需要。浏览器版本限定在 IE 6.0 SP1/SP2、IE 7.0、IE 8.0而且都是 32 位。64 位系统上装 HR / Web 客户端时系统内置 32 位和 64 位两套 IE默认调用的就是 32 位版一般不用管。但如果有人手动从开始菜单里翻出 64 位那个 IE 去访问页面会各种异常这个坑在 Win7 64 位上出现频率不低。5. 常见问题排查四条装完必踩的坑5.1 环境检测反复提示缺部件资源盘插了也没用现象环境检测报缺 .NET 或某个系统组件插了资源盘按提示装完再检测还是同一项报缺。原因一种是资源盘没插对——检测程序认的是光盘根目录结构把资源盘内容拷到硬盘某个子目录再指向它程序找不到安装包另一种是装了更高版本的组件K/3 检测的是指定版本号版本对不上照样报缺。解决优先用资源盘原始目录结构拷到硬盘时保持整盘拷贝、盘符映射别只拷 setup 文件。组件版本严格按资源盘带的装不要自己升级。还不行就退出杀毒软件重跑一遍检测杀软拦截安装包解压也是常见原因。5.2 中间层组件注册成功客户端登录报连接失败现象中间层组件注册显示成功账套管理能打开客户端一登录就提示无法连接中间层服务器。原因网络 DTC 访问没启用或者 MSDTC 的安全配置里「允许入站/出站」没勾分布式事务在中间层和数据库之间过不去。Windows Server 2003 打了 SP2 但没装 KB936296 的环境也会出现类似表现。解决先sc query msdtc确认服务在跑再进组件服务检查网络 DTC 访问和入站出站设置验证方式改成「不要求验证」。2003 SP2 环境补装 KB936296装完重启。客户端那台机器上用telnet 中间层IP 135确认 RPC 端口通。5.3 新建账套报数据库连接失败现象账套管理里填好数据库地址和 sa 密码点测试报连接失败或者新建账套到一半报错退出。原因SQL Server 的 TCP/IP 协议没启用只监听了本机或者 Windows 防火墙拦了 1433或者 SQL Server 装的时候选了仅 Windows 认证sa 登录被禁用。解决SQL Server 配置管理器里启用 TCP/IP 并重启服务防火墙加 1433 入站规则认证方式改成混合模式后重启实例。改完在中间层机器上用sqlcmd -S 数据库IP -U sa -P 密码 -Q SELECT 1验证通了再回账套管理操作。5.4 虚拟机里中间层加密服务变成演示版现象整套 K/3 装在虚拟机里中间层一切正常但系统提示演示版导入 License 文件也不生效。原因中间层加密服务不支持在虚拟机中运行在 VMware、Virtual PC 这类环境里会始终以演示版运行License 文件也导不进去。这是产品层面的限制不是配置问题。解决加密服务之外的中间层组件在虚拟机里可以正常工作所以常见做法是中间层应用部分放虚拟机加密服务单独放一台物理机或者整套中间层直接上物理机。装之前先确认部署环境有没有虚拟化要求别等上线了才发现 License 导不进去。6. 验收从数据库端口一路点到客户端登录装完不等于装对。K/3 这套系统的特点是问题会跨层伪装数据库排序错了表现为账套不存在DTC 没开表现为客户端连不上中间层config 里 localhost 没改表现为 HR 登录卡死。所以我装完最后一步固定做一张自检表按顺序从下往上点一遍哪一层断了当场就能定位。顺序检查点操作通过标准1数据库端口netstat -ano | findstr :14331433 在监听非仅本机2排序规则SELECT SERVERPROPERTY(Collation)返回 Chinese_PRC_CI_AS3远程连接中间层机器上sqlcmd -S 数据库IP -U sa -Q SELECT 1返回 14MSDTCsc query msdtcSTATE 为 RUNNING5中间层注册打开账套管理能看到账套列表6WEB 站点浏览器访问 HR 站点登录页正常打开7客户端客户端登录进入主界面能开一张单据第 5 步和第 7 步是分水岭账套管理能看到账套说明数据库、中间层、DTC 这条链路全通客户端能开单据说明从客户端到中间层再到数据库整条链路没问题。中间任何一步卡住就停在那一步查别跳过去继续装——跳过去后面全是连带报错查起来更费劲。还有一个小技巧整套装完先别急着导正式账套用安装盘自带的演示账套跑一遍全流程登录、开单、审核、查报表走一圈。演示账套能跑通说明环境本身没问题再导正式数据演示账套都跑不通那一定是环境哪一层没配好跟数据无关。从那以后我每装完一套 K/3不管对面催得多急都按这张表从 1433 端口一路点到客户端开单一步不落。吃过一次亏——中间层注册成功就交付结果客户第二天做业务单据全报事务错误回头查是 DTC 的入站没勾。希望帮到你。本文还有配套的精品资源点击获取

关于本文作者

来自尧图内容编辑团队

尧图内容编辑团队 内容团队

尧图内容编辑团队

本文由尧图网络内容编辑团队执笔。团队由资深项目经理、前端工程师与设计师组成,所有内容均来自亲手交付的真实项目,先讲清问题、再给出可落地的解法。尧图深耕北京网站建设十年,服务过京华建材集团、智造科技等各行业客户,把一线经验沉淀为可复用的行业观察。

  • 十年建站经验,覆盖建材、制造、服务、文创等
  • 项目经理把关选题与事实准确性
  • 工程师与设计师联合撰写专业细节
  • 统一编辑规范,保证文风与排版一致
  • 每月复盘转化数据,迭代选题方向

延伸阅读

相关资讯与近期热门内容

深度阅读推荐

建站决策前值得细读的三篇

网站改版的5个关键决策
2024-08-12

网站改版的5个关键决策

什么时候该改版、改到什么程度、如何避免流量掉光,京华建材集团改版复盘给出答案。

获取专属建站方案

看完文章,把您的行业与预算告诉我们,免费获取一份量身定制的官网建设方案与报价。

立即免费咨询