V26 Pro Enterprise
GuYi 授权验证系统
这是一款轻量级、高性能的单码验证系统。支持多应用管理、云端变量下发、设备指纹绑定以及强大的防刷机制。您可以将其集成到任何 EXE、APK 或 Python 脚本中。
重要提示: 为了您的数据安全,请在安装完成后立即删除网站根目录下的
install.php 文件,并在后台修改默认密码。
安装与默认账号
部署步骤
上传源码
将所有文件上传至服务器根目录,确保 PHP 版本 > 7.2。
运行安装程序
浏览器访问 http://你的域名/install.php 并填写数据库信息。
完成部署
安装成功后即可访问后台。
初始管理员凭证
目录结构说明
了解系统文件结构有助于您进行二次开发或故障排查。
Terminal
/ (根目录)
├── cards.php // 后台管理主程序 (可重命名以隐藏后台)
├── Verifyfile/
├── api.php // ★ 核心API接口 (客户端调用此文件)
└── captcha.php // 后台登录验证码
├── config.php // 数据库配置文件 (包含 SYS_SECRET 密钥)
├── database.php // 数据库操作类 (含鉴权逻辑)
├── / // 存放背景图、Logo等素材
├── assets/ // 存放 CSS, JS 静态资源
└── index.php // 404伪装页 (保护目录隐私)
API 接口定义
所有客户端(软件/脚本/APP)均通过此接口与服务器通信。请确保使用 POST 方法。
POST
http://您的域名/Verifyfile/api.php
| 参数名 | 必填 | 说明 |
|---|---|---|
| card_code | 是 | 用户输入的卡密 (兼容参数名: card) |
| device_hash | 是 | 设备唯一标识 (机器码),建议MD5后传入 (兼容参数名: device) |
| app_key | 否 | 应用密钥。用于区分多应用或获取云端变量 (在后台"应用管理"中获取) |
返回数据示例 (JSON)
Response Payload
{
"code": 200, // 200:成功, 403:验证失败, 429:请求过快
"msg": "OK", // 提示信息 (如: 卡密已过期 / 设备不匹配)
"data": {
"expire_time": "2026-12-31 23:59:59", // 到期时间
"variables": { // [云变量] 数据 (可选)
"notice": "最新公告内容...",
"download_url": "https://..."
}
}
}
接入代码示例
Copy & Pasteimport requests, hashlib # 1. 配置参数 api_url = "http://你的域名/Verifyfile/api.php" card = "VIP-88888888" # 模拟机器码 (实际开发请获取本机硬件ID) hwid = hashlib.md5("my_computer_id".encode()).hexdigest() # 2. 发送验证请求 try: res = requests.post(api_url, data={ "card_code": card, "device_hash": hwid, "app_key": "" # 可选 }, timeout=5).json() # 3. 处理结果 if res['code'] == 200: print(f"验证成功! 到期时间: {res['data']['expire_time']}") # print(res['data']['variables']) # 获取云变量 else: print(f"验证失败: {res['msg']}") except Exception as e: print("网络连接失败")
云变量功能说明
GuYi System 提供了一套强大的云端变量下发系统,您可以在后台【应用列表 -> 变量管理】中进行配置。
私有变量 (Private)
仅在 卡密验证通过 后才会返回给客户端。适用于传输加密Key、VIP直链、核心配置等敏感数据。
获取方式:登录成功自动返回公开变量 (Public)
只需提供 app_key 即可获取,无需消耗卡密。适用于软件公告、版本号检测、联系方式等公开数据。
安全最佳实践
-
安装后清理 部署完成后,请务必删除根目录的
install.php,防止站点被重置。 -
修改默认密码 默认密码
admin123仅用于首次登录,请进入【全局配置】页面修改。 -
更新密钥 编辑
config.php,修改SYS_SECRET为随机长字符串,增强 Cookie 安全性。