🔥 内测体验官招募中:参与内测,正式版发布免费领专业版授权码(价值 ¥199) 截止 2026-09-30 23:59 立即参与 →
YUXIN KVM AGENT

语信 KVM 受控端

自研 KVM 虚拟化受控端,独立可安装系统,配合语信 IDC 财务系统开售云服务器 / VPS。 支持弹性升级、快照备份、NAT 转发、监控、开机自愈,真实母鸡压测 16 台并发全通过。

下载安装包 (5.7 MB) 查看安装命令 ↓
当前版本 V1.0.0 · 适用 Debian 12 / Ubuntu 22.04+(x86_64)· 安装后绑定授权码使用(一机一码,未授权写操作锁定)
弹性升级
CPU / 内存热升级与冷升级,按 meta 恢复
💾
快照 / 备份
运行中自动关机一致性备份,一键还原
🔌
NAT / IP 管理
公网 IP 池分配回收零泄漏,端口转发
🛡️
开机自愈
母鸡重启自动恢复开机状态的 VM
📊
实时监控
CPU / 内存 / 出入带宽差分采样

⚡ 极速一键安装(推荐)

像宝塔一样简单!复制下面命令到母鸡执行,中文交互提示,一步步引导完成安装,自动生成接入标识和签名密钥:

wget -O install_kvm.sh https://auto.yuxinyun.cn/download/kvmInstall.sh && bash install_kvm.sh
✅ 自动完成
系统依赖安装、目录初始化、服务注册、防火墙配置、配置文件生成
💬 中文交互
授权码输入、网桥配置、IP池设置、超分比例,全程中文提示引导
🔑 自动生成
接入标识(yx_key)和签名密钥(yx_secret)自动生成32位随机串,安全可靠

手动安装命令(高级用户)

在目标母鸡(需已开通 KVM 嵌套虚拟化)上以 root 执行:

# 1. 下载安装包
cd /root && wget -O yx_kvm_agent_V1.0.0_linux-amd64.tar.gz https://auto.yuxinyun.cn/download/kvmGet

# 2. 解压
tar -xzf yx_kvm_agent_V1.0.0_linux-amd64.tar.gz && cd yx_kvm_agent_V1.0.0_linux-amd64

# 3. 修改配置(必做)
vi config.json.linux
#   【接入鉴权】yx_key=接入标识、yx_secret=HMAC签名密钥(建议32位随机串,勿泄露)
#   【授权绑定】yx_license=授权码、yx_license_key=AppKey、yx_license_secret=AppSecret、yx_auth_url=https://auto.yuxinyun.cn
#               (授权站发放,类型选"KVM受控端·机器授权",一机一码)
#   【网络配置】yx_network.yx_bridge=网桥名(默认br0)、yx_ip_pool=公网IP池、yx_gateway=网关、yx_nameserver=DNS

# 4. 一键部署(自动安装 qemu-kvm / libvirt / nftables 等依赖)
chmod +x deploy.sh && ./deploy.sh

# 5. 验证服务
systemctl status kvmd

依赖已装好的母鸡可跳过第 4 步,直接 bash install.sh(支持自定义安装/数据目录)。

安装方法(详细)

1
准备母鸡
Debian 12 / Ubuntu 22.04+(x86_64),BIOS 开启 VT-x/AMD-V(VPS 需开启嵌套虚拟化),root 权限。
防火墙:需开放 8080 端口(受控端 API 监听端口),执行 ufw allow 8080(Debian/Ubuntu)或 firewall-cmd --permanent --add-port=8080/tcp && firewall-cmd --reload(CentOS/Rocky)。
2
修改配置
编辑 config.json.linux:yx_key 接入标识、yx_secret HMAC 签名密钥(建议 32 位随机串,勿泄露); yx_network 里填宿主机网桥(默认 br0)与要分配给客户的公网 IP 池、网关、DNS。
网桥配置:若母鸡没有 br0 网桥,需先创建。Debian/Ubuntu 可安装 bridge-utils(apt install -y bridge-utils),然后编辑 /etc/network/interfaces 或用 netplan 配置网桥,将物理网卡(如 eth0/enp3s0)桥接到 br0。配置完成后执行 ip addr show br0 确认网桥已生效。
授权配置:yx_license 填授权站发放的授权码、yx_license_key / yx_license_secret 填该授权码的 AppKey / AppSecret、yx_auth_url 填授权站地址(https://auto.yuxinyun.cn)。首次启动自动绑定本机指纹,一机一码;未授权时写操作(开/删/重装等)返回 403,只读接口正常。
3
一键部署
deploy.sh 自动安装 qemu-kvm / libvirt / cloud-image-utils / nftables 并注册 systemd 开机自启;install.sh 适合依赖已装好的环境。
4
对接 IDC 财务系统
在财务系统「上游分组」添加 KVM 受控端节点:API 地址 = http://受控端IP:8080,接入标识 = yx_key,签名密钥 = yx_secret,测试节点通过后即可开通云服务器(VPS)。

接口鉴权(Yx-Key / Yx-Ts / Yx-Sign)

所有接口走 POST /yx_api/接口名,请求头携带 Yx-Key(接入标识)、Yx-Ts(秒级时间戳)、Yx-Sign(HMAC-SHA256 签名,防止伪造调用)。完整接口列表(节点信息 / 创建 / 删除 / 开机 / 关机 / 重装 / 重置密码 / 弹性升级 / 快照 / 备份 / 挂起恢复 / 监控 / 控制台 / IP / NAT 等)详见安装包内 docs/API.md。