ikxin / kms-tools

An all-in-one KMS toolbox

English

📖 介绍

一站式 KMS 工具箱，集成了 KMS 激活脚本生成、KMS 服务器检测、KMS 服务器状态监控等功能。

该项目最早诞生于 2020 年 4 月，首发在 Hostloc 论坛，之前仅仅只是一个用来生成 KMS 激活脚本的小工具。上大学的时候我在学校负责维护教学楼和机房的电脑设备，平日里经常需要重装各种各样版本的操作系统，这个小工具提高了激活操作系统的效率。于是在 2022 年 6 月，我将这个小工具翻出来，使用许多新技术对其进行了重构，再一次发布到了 Hostloc 论坛，得到了许多大佬的关注和支持。

后来的一段时间里也会偶尔更新一些功能，但一直都没有很完善，直到前些时候收到了两个特别的 issues「#25、#26」，其中有一个还是非中文语言发起的，我没有想到一个小小的项目能够得到海外朋友的关注。作为我开源的第一款「处女作」，我决定将其继续开发和维护下去。

原先的版本是一个纯前端的工具，为了实现 KMS 检测和 KMS 监控等功能，我使用 Bun + Elysia 写了一个后端服务，将整个项目区分为纯前端版本和全栈版本，前端版本可以调用 kms.ikxin.com 的 API 接口，而全栈版本则可以独立部署所有功能，甚至包含了 Vlmcsd 来作为 KMS 激活服务器。

📦 在线使用

全栈版本

• 官网地址: kms.ikxin.com

纯前端版本

• Cloudflare: kmstools.pages.dev
• Vercel: kmstools.vercel.app

🌈 功能预览

KMS 激活脚本生成	KMS 服务器检测	KMS 服务器状态监控

👀 历史版本

v1.2.0	v1.0.0	v0.1.5

✨ 技术栈

后端

• Bun - 用于 JavaScript 和 TypeScript 应用程序的一体化工具包
• Drizzle ORM - 下一代的无头 TypeScript ORM 框架
• Elysia - 符合人体工程学的 Web 框架，用于使用 Bun 构建后端服务器

前端

• Vue.js - 构建用户界面的 JavaScript 框架
• Vite - 下一代的前端工程构建工具
• Arco Design Vue - ByteDance 开发的企业级产品设计系统
• Vue Router - Vue.js 核心团队开发的路由组件
• Pinia - 类型安全、可扩展性以及模块化设计的状态管理库
• UnoCSS - 即时的按需加载原子 CSS 引擎
• VueUse - 基于 Composition API 的实用函数集合
• Vue I18n - I18n 国际化语言支持
• unplugin-auto-import - 自动按需导入 Composition API 的插件
• unplugin-vue-components - 自动按需导入 Vue 组件的插件
• unplugin-vue-router - Vue Router 自动加载基于文件的路由系统
• unplugin-vue-markdown - Markdown 文档支持

📦 本地构建

不管是全栈版本还是纯前端版本，都需要依赖 Bun 来进行构建，使用以下脚本在本地安装 Bun 环境。

Linux & macOS：

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

Windows：

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

接下来将项目克隆到本地，然后执行命令安装依赖

git clone https://github.com/ikxin/kms-tools.git
cd kms-tools && bun install

全栈版本

1. 创建 MySQL 数据库，使用以下 SQL 创建表的结构

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`)
);
--> statement-breakpoint
CREATE TABLE `server` (
  `id` int AUTO_INCREMENT NOT NULL,
  `host` text NOT NULL,
  `port` int NOT NULL DEFAULT 1688,
  `total` int NOT NULL DEFAULT 0,
  `success` int NOT NULL DEFAULT 0,
  `fail` int NOT NULL DEFAULT 0,
  `delay` float NOT NULL DEFAULT 0,
  `rate` float NOT NULL DEFAULT 0,
  `updated_at` timestamp,
  `created_at` timestamp,
  CONSTRAINT `server_id` PRIMARY KEY(`id`)
);

2. 将 .env.example 文件重命名为 .env，并修改其中的配置项

ENABLE_VLMCSD = false # 是否启用 Vlmcsd 服务
PORT = 3000 # 服务端口
DATABASE_URL = 'mysql://root:password@localhost:3306/database' # 数据库连接地址

3. 运行以下命令启动服务

bun run service

纯前端版本

1. 使用以下命令构建项目

bun run build

2. 运行以下命令启动服务

npx serve dist

⭐ 星星

🧑‍💻 作者

Code with ❤️ by 一纸忘忧

📜 开源协议

MIT License Copyright (c) 2022 ~ Present

kms-tools's Issues

增加 Docker 镜像部署

描述你想要的解决方案

一个不错的项目，希望增加docker镜像部署

Unable to start docker

          Unable to start docker.

Bun v1.1.27 (Linux arm64)

18696 |   module.exports = [

18697 |   module.exports = [

18698 |   module.exports = [

18699 |   module.exports = [

18700 |   module.exports = [

18701 |   module.exports = [

                                        ^

error: Failed to connect

 errno: 103

  code: "ECONNREFUSED"

      at createConnection (/$bunfs/root/kms-tools:18701:33)

      at module code (/$bunfs/root/kms-tools:34688:57)

Docker Compose:

services:
  kms-tools:
    build: .
    ports:
      - 3000:3000
    restart: unless-stopped
  db:
    image: mysql:8
    restart: always
    environment:
      MYSQL_DATABASE: 'db'
      MYSQL_USER: 'kmstool'
      MYSQL_PASSWORD: 'password'
      MYSQL_ROOT_PASSWORD: 'otherpassword'
    ports:
      - '3306:3306'
    volumes:
      - /var/www/vhosts/eniyiweb.net/lisans.eniyiweb.net/db:/var/lib/mysql

volumes:
  my-db:

Originally posted by @eniyiweb in #24 (comment)

可以适配一下手机端么？

可以适配一下手机端么？

大大能不能再构建一个 release

我看更新了好多东西，但是release还是1.2.0，苦于我自己不会构建，如果有空能否烦请你再构建一个最新版的，感谢！

如何让页面显示完整列表

就是访问就直接显示

Windows 10 Windows 8.1 Windows 8 Windows Vista Windows 7 Windows Server 2016 Windows Server 2012 Windows Server 2008

让他不显示下拉箭头了。直接显示全部。怎么改。。。。。

直接上传就可以用吗，还是像上一个版本那样

直接上传就可以用吗，还是像上一个版本那样需要修改kms服务器为自己的才可以用
还有跟第一个版本通用吗？更新直接覆盖可以吗？更新后以前kms激活的是否可以继续使用

请求新增最新版系统 Win11 LTSC2024 Win server 2025 等系统以及 Office LTSC 等新版本的密钥

系统KMS：https://learn.microsoft.com/en-us/windows-server/get-started/kms-client-activation-keys?tabs=server2025%2Cwindows1110ltsc%2Cversion1803%2Cwindows81
OfficeKMS：https://github.com/laomms/PidKeyTool/issues/39
Office密钥信息来源是另一个项目的issue,可以参考

Unable to switch language

Sorry, this is not really an 'issue' I see there are language settings. I do not see any documentation on changing to English, but I can see lang info in vue devtools, but I am unsure how/where to change it. I tried translating to search easier.

I cannot seem to find this. Can you provide information on how to change?