KMS-Tools使用指南：从环境搭建到功能验证

KMS-Tools是一款集成KMS激活脚本生成、服务器检测和状态监控功能的一站式工具箱。无论你是需要激活Windows系统、Office软件，还是监控KMS服务器状态，这个工具都能满足你的需求。下面将通过实际操作场景，带你逐步掌握KMS-Tools的使用方法。

配置开发环境：从安装到验证

场景描述

你刚接触KMS-Tools项目，想要在本地搭建开发环境，以便体验其全部功能或进行二次开发。这时候需要正确安装依赖工具和项目依赖。

分步指南

1. 安装Bun运行时 Bun是一个快速的JavaScript运行时和包管理器，KMS-Tools使用它来运行项目。你可以根据自己的操作系统选择对应的安装命令：

   [Linux/macOS终端]

   curl -fsSL https://bun.sh/install | bash
   

   [Windows PowerShell]

   powershell -c "irm bun.sh/install.ps1 | iex"
   

   💡 安装完成后，建议关闭当前终端并重新打开，以确保Bun命令能被正确识别。

2. 获取项目代码 将项目代码克隆到本地：

   [终端/命令提示符]

   git clone https://gitcode.com/gh_mirrors/km/kms-tools
   

3. 安装项目依赖 进入项目目录并安装所需依赖：

   [终端/命令提示符]

   cd kms-tools && bun install
   

   ⚠️ 如果安装过程中出现网络问题，可以尝试更换npm镜像源或检查网络连接。

验证方法

🔍 检查Bun是否安装成功：

bun --version

如果输出Bun的版本号，说明安装成功。

🔍 检查项目依赖是否安装完整： 查看项目目录下是否生成了node_modules文件夹，该文件夹包含了项目所需的所有依赖包。

准备数据库：创建表结构

场景描述

KMS-Tools需要使用数据库来存储日志信息，以便你查看KMS服务器的历史状态和激活记录。在使用相关功能前，需要先创建必要的数据库表结构。

分步指南

1. 安装MySQL数据库 确保你的系统中已经安装了MySQL数据库。如果尚未安装，可以从MySQL官方网站下载并按照指引进行安装。

2. 创建数据库和表 登录MySQL后，执行以下SQL语句创建必要的表结构：

   [MySQL命令行]

   CREATE TABLE `logs` (
     `id` int AUTO_INCREMENT NOT NULL,
     `host` text NOT NULL,
     `delay` int NOT NULL DEFAULT 0,
     `content` text,
     `status` boolean NOT NULL DEFAULT false,
     `created_at` timestamp NOT NULL,
     CONSTRAINT `logs_id` PRIMARY KEY(`id`)
   );
   

   📌 这个表用于存储KMS服务器检测日志，包括服务器地址、响应延迟、检测内容、状态和检测时间等信息。

验证方法

🔍 检查表是否创建成功：

USE 你的数据库名;
DESCRIBE logs;

如果能看到表结构信息，说明表创建成功。

运行项目：从启动到访问

场景描述

环境配置完成后，你需要启动KMS-Tools项目并通过浏览器访问，以使用其提供的各项功能。

分步指南

1. 启动项目 在项目目录中执行以下命令启动项目：

   [终端/命令提示符]

   bun run
   

   ⚠️ 如果启动失败，检查是否有端口被占用，或者数据库连接配置是否正确。

2. 访问项目 打开浏览器，输入以下地址访问KMS-Tools：

   http://localhost:3000
   

   你将看到KMS-Tools的主界面，包含激活、检测、监控等功能模块。

   KMS-Tools主界面展示了各功能模块入口

验证方法

🔍 检查项目是否正常运行： 在浏览器中访问http://localhost:3000，如果能看到项目主界面，说明项目启动成功。

使用激活功能：生成激活脚本

场景描述

你需要激活Windows系统或Office软件，这时候可以使用KMS-Tools的激活功能生成相应的激活脚本。

分步指南

1. 选择激活类型 在项目主界面点击"激活"选项卡，然后根据需要选择"Windows"、"Windows Server"或"Office"。

2. 配置激活参数

   • 选择系统/软件版本
   • 输入KMS服务器地址
   • 输入许可证密钥（部分版本可能需要）

3. 生成激活脚本 点击"创建脚本"按钮，系统将生成相应的激活脚本。

   激活功能界面允许你配置参数并生成激活脚本

4. 使用激活脚本 将生成的脚本复制到目标计算机上，以管理员身份运行该脚本即可完成激活。

   💡 对于Windows系统，你可以将脚本保存为.bat文件，然后右键点击该文件并选择"以管理员身份运行"。

验证方法

🔍 检查激活是否成功： 在目标计算机上，通过"设置 > 系统 > 激活"查看系统激活状态，或在Office软件中通过"文件 > 账户"查看激活状态。

使用检测功能：验证KMS服务器

场景描述

你想知道某个KMS服务器是否可用，或者想测试不同KMS服务器的响应速度，这时候可以使用KMS-Tools的检测功能。

分步指南

1. 进入检测功能 在项目主界面点击"检测"选项卡。

2. 配置检测参数

   • 输入KMS服务器地址
   • 选择端口（默认为1688）
   • 选择要检测的Windows版本
   • 选择检测协议

3. 执行检测 点击"检测"按钮，系统将连接到指定的KMS服务器并进行检测。

   KMS服务器检测界面显示检测结果和详细信息

验证方法

🔍 查看检测结果： 检测完成后，界面将显示检测状态（成功/失败）、响应时间等信息。如果显示"SUCCESS"，说明KMS服务器可用。

使用监控功能：跟踪服务器状态

场景描述

你需要长期监控多个KMS服务器的运行状态，以便及时了解服务器的可用性和性能变化。

分步指南

1. 进入监控功能 在项目主界面点击"监控"选项卡。

2. 查看服务器状态 监控界面将显示多个KMS服务器的状态信息，包括：

   • 服务器地址和端口
   • 成功率
   • 平均延迟
   • 总请求数
   • 成功/失败次数
   • 最后更新时间

   监控界面展示多个KMS服务器的实时状态

3. 刷新监控数据 点击界面上的刷新按钮，可以更新服务器状态数据。

   💡 你可以定期刷新数据，或设置自动刷新间隔，以便实时掌握服务器状态。

验证方法

🔍 检查监控数据是否更新： 点击刷新按钮后，观察服务器状态数据是否有变化，特别是"更新时间"字段是否更新为当前时间。

通过以上步骤，你已经掌握了KMS-Tools的基本使用方法。无论是搭建环境、准备数据库，还是使用各项功能，都可以按照上述指南进行操作。如果在使用过程中遇到问题，可以查看项目中的帮助文档或提交issue寻求帮助。