Kangle EasyPanel 服务器插件使用教程

插件简介

Kangle EasyPanel 是思博业务系统的一款服务器插件，用于对接 Kangle 虚拟主机面板（EasyPanel），实现虚拟主机的自动化开通、暂停、删除、续费等全生命周期管理。

插件标识：easypanel

适用场景

IDC 服务商使用 Kangle + EasyPanel 管理虚拟主机
需要对接 WHM 接口实现主机自动开通
需要通过思博业务系统统一管理 Kangle 虚拟主机

前置条件

已经部署好思博业务系统
拥有一台安装 Kangle + EasyPanel 的服务器
已获取 EasyPanel 的 API 安全码（security）

第一步：添加服务器

进入思博后台 → 服务器管理 → 添加服务器
填写以下信息：

字段	说明
名称	自定义，如 `kangle`
类型	选择 Kangle EasyPanel
域名/主机名	EasyPanel 服务器 IP 或域名
端口	EasyPanel 端口，默认 `3312`
SSL	是否启用 HTTPS（根据你的 EasyPanel 配置）
密钥/证书	填写 EasyPanel 的 API 安全码（security）
登录用户	可留空，EasyPanel 不使用传统账户认证
登录密码/密钥	可留空

注意：EasyPanel 不使用传统用户名密码认证，而是通过 API 安全码签名验证。密钥/证书 字段即 API 安全码。

配置示例

服务器名称：kangle
域名/主机名：172.66.66.138
公网IP：
密钥/证书：yc5wT9Xrpj29fh5x
端口：3312
SSL：关闭
登录用户：
登录密码/密钥：
插件：Kangle EasyPanel（easypanel）
库存：0
状态：正常 隐藏

填写完成后点击 连接测试，如果配置正确会提示"连接成功"

第二步：创建商品

进入思博后台 → 商品管理 → 添加商品
填写基础信息（商品名称、价格等）
服务器类型 选择关联的 EasyPanel 服务器
在 插件配置 区域，填写以下字段：

字段	说明
产品列表ID	Kangle 后台设置的产品列表 ID

获取产品列表 ID

登录 Kangle 后台（通常是 http://你的服务器:3311）
进入 产品列表 管理
找到你要关联的产品，复制其 ID 号
将该 ID 填入思博商品的 产品列表ID 字段

第三步：用户下单

后台配置完成后，用户即可在前台下单购买该商品：

用户在前台选择商品并完成支付
系统自动调用 EasyPanel API 开通虚拟主机
开通成功后，用户在 产品列表 中可看到已开通的虚拟主机
点击进入主机详情页，可查看控制面板信息

前台功能

用户在主机详情页可看到 控制面板 标签页，其中包含：

一键登录面板：自动填充用户名密码，点击直接跳转 EasyPanel 登录
账号信息：显示登录账号和密码（支持复制）
重置密码：点击可重置虚拟主机密码

插件功能一览

功能	是否支持	说明
连接测试	✅	通过 API 签名验证服务器连通性
自动开通	✅	用户支付后自动调用 `add_vh` 创建主机
暂停	✅	调用 `update_vh` 设置 status=1
解除暂停	✅	调用 `update_vh` 设置 status=0
删除/终止	✅	调用 `del_vh` 删除虚拟主机
续费	✅	自动续费（Kangle 到期时间由系统控制）
升降级	✅	调用 `add_vh` 更新产品列表 ID
重置密码	✅	前台/后台均可重置，自动更新到数据库
前台控制面板	✅	显示登录信息、一键登录、复制账号密码

常见问题

Q1：连接测试失败，提示"API 安全码未配置"

请检查服务器配置中的 密钥/证书 字段是否填写了 EasyPanel 的 API 安全码。EasyPanel 不使用账户密码认证，该字段必须填写安全码。

Q2：连接测试提示"安全码错误"

请核对 EasyPanel 中配置的 API 安全码
安全码在 Kangle 后台的 API 设置中查看或修改

Q3：开通失败，提示"产品列表ID不正确"

请确保商品配置中的 产品列表ID 与 Kangle 后台的产品列表 ID 一致
Kangle 产品列表 ID 通常是数字，可以在 Kangle 后台的产品列表管理中查看

Q4：前台控制面板无法一键登录

检查服务器地址和端口配置是否正确
检查 SSL 配置是否与 EasyPanel 实际配置一致
部分浏览器会拦截新窗口，请允许弹窗

Q5：插件支持新版注册式钩子吗？

支持。该插件已重构为 新版注册式钩子 架构，入口文件仅做钩子注册，业务逻辑封装在 src/EasypanelPlugin.php 中。如有二次开发需求，可参考插件类中的方法进行扩展。