py-kms客户端使用详解：如何快速测试和验证KMS服务
【免费下载链接】py-kms KMS Server Emulator written in Python 
项目地址: https://gitcode.com/gh_mirrors/py/py-kms
py-kms是一款用Python编写的KMS服务器模拟器，可帮助用户测试和验证KMS服务激活流程。本文将详细介绍如何使用py-kms客户端工具测试KMS服务器连接状态、验证激活功能，并提供Windows和Office系统的完整激活验证步骤。
准备工作：安装与基本配置
获取py-kms项目
首先需要获取py-kms项目源码，通过以下命令克隆仓库：
git clone https://gitcode.com/gh_mirrors/py/py-kms
客户端工具介绍
py-kms提供了专门的客户端测试工具pykms_Client.py，位于项目根目录的py-kms/文件夹下。该工具允许用户模拟KMS客户端请求，测试服务器响应情况，无需实际安装Windows或Office系统。
图：py-kms密钥管理系统示意图
基本测试：使用pykms_Client.py验证服务器
最简单的测试命令
在启动KMS服务器后（使用pykms_Server.py），打开新终端执行以下命令进行基本连接测试：
python3 py-kms/pykms_Client.py <服务器IP地址> 1688 -V INFO
<服务器IP地址>：替换为你的KMS服务器实际IP1688：默认KMS服务端口-V INFO：显示详细日志信息
自定义测试参数
pykms_Client.py支持多种参数来自定义测试场景：
| 参数 | 功能描述 | 示例 |
|---|---|---|
-m | 指定测试产品类型 | -m Windows10 |
-c | 自定义CMID | -c ae3a27d1-b73a-4734-9878-70c949815218 |
-n | 设置客户端机器名 | -n TestPC01 |
-t0 | 连接超时设置（秒） | -t0 30 |
示例：测试Office 2019激活
python3 py-kms/pykms_Client.py 192.168.1.100 1688 -m Office2019 -V DEBUG
Windows系统激活验证步骤
命令行激活流程
Windows系统通过slmgr.vbs脚本进行KMS激活配置，以下是完整验证步骤：
-
卸载现有密钥（可选）
cscript //nologo slmgr.vbs /upk -
安装GVLK密钥
cscript //nologo slmgr.vbs /ipk <Windows GVLK密钥> -
配置KMS服务器
cscript //nologo slmgr.vbs /skms <服务器IP>:1688 -
执行激活
cscript //nologo slmgr.vbs /ato -
查看激活状态
cscript //nologo slmgr.vbs /dlv
图：Windows系统KMS激活命令执行过程
常见错误及解决方法
-
0xC004F074：防火墙阻止1688端口，需在服务器端开放端口：
sudo ufw allow 1688/tcp -
0xC004F069：密钥与系统版本不匹配，需确认使用正确的GVLK密钥（参考项目文档docs/Keys.md）
图：Windows激活成功后状态信息
Office激活验证步骤
配置Office KMS客户端
Office产品需要在安装目录下执行激活命令，步骤如下：
-
打开命令提示符（管理员模式）并导航到Office安装目录：
cd C:\Program Files\Microsoft Office\Office16 # Office 2016/2019 -
查看当前激活状态
cscript //nologo ospp.vbs /dstatus -
卸载现有密钥（如需要）
cscript //nologo ospp.vbs /unpkey:<最后5位密钥> -
安装Office GVLK密钥
cscript //nologo ospp.vbs /inpkey:<Office GVLK密钥>
图：Office密钥卸载与安装过程
连接KMS服务器并激活
-
设置KMS服务器地址
cscript //nologo ospp.vbs /sethst:<服务器IP> -
设置KMS服务器端口
cscript //nologo ospp.vbs /setprt:1688 -
执行激活
cscript //nologo ospp.vbs /act -
验证激活状态
cscript //nologo ospp.vbs /dstatus
图：Office成功激活后状态信息，显示180天剩余期限
高级测试：日志分析与问题排查
启用详细日志
通过设置日志级别为DEBUG，可以获取详细的客户端与服务器交互信息：
python3 py-kms/pykms_Client.py <服务器IP> 1688 -V DEBUG -F client_test.log
日志文件将保存在当前目录的client_test.log中，可用于分析连接问题。
关键日志指标
- 成功连接：日志中出现"Received response from server"
- 激活成功：日志中出现"Activation successful"
- 连接失败：检查"Connection refused"或"Timeout"相关信息
总结与最佳实践
-
测试顺序建议：
- 先使用
pykms_Client.py验证服务器基本功能 - 再在测试环境中验证Windows激活
- 最后测试Office激活流程
- 先使用
-
客户端配置要点：
- 确保防火墙允许1688端口通信
- 使用正确的GVLK密钥（区分Windows和Office版本）
- 管理员权限运行命令提示符
-
参考文档：
- 官方使用指南：docs/Usage.md
- 密钥列表：docs/Keys.md
- 故障排除：docs/Troubleshooting.md
通过本文介绍的方法，您可以全面测试和验证py-kms服务器的功能，确保KMS激活服务正常运行。无论是开发测试还是生产环境部署，这些步骤都能帮助您快速定位问题并确保系统稳定。
【免费下载链接】py-kms KMS Server Emulator written in Python 项目地址: https://gitcode.com/gh_mirrors/py/py-kms
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
