Logo GuYi System Docs
返回后台 支持
V26 Pro Enterprise

GuYi 授权验证系统

这是一款轻量级、高性能的单码验证系统。支持多应用管理、云端变量下发、设备指纹绑定以及强大的防刷机制。您可以将其集成到任何 EXE、APK 或 Python 脚本中。

重要提示: 为了您的数据安全,请在安装完成后立即删除网站根目录下的 install.php 文件,并在后台修改默认密码。

安装与默认账号

部署步骤

上传源码

将所有文件上传至服务器根目录,确保 PHP 版本 > 7.2。

运行安装程序

浏览器访问 http://你的域名/install.php 并填写数据库信息。

完成部署

安装成功后即可访问后台。

初始管理员凭证

Username
GuYi
Password
admin123
首次登录后请务必在【全局配置】中修改密码。

目录结构说明

了解系统文件结构有助于您进行二次开发或故障排查。

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 & Paste
Python
易语言 (E-Lang)
PHP
C#
Java
Node.js
Go
C++
import 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 即可获取,无需消耗卡密。适用于软件公告、版本号检测、联系方式等公开数据。

获取方式:POST app_key 即可

安全最佳实践

  • 安装后清理 部署完成后,请务必删除根目录的 install.php,防止站点被重置。
  • 修改默认密码 默认密码 admin123 仅用于首次登录,请进入【全局配置】页面修改。
  • 更新密钥 编辑 config.php,修改 SYS_SECRET 为随机长字符串,增强 Cookie 安全性。

技术支持

GuYi Support Team

如遇部署报错、接口异常或需要定制开发,请加入官方交流群或联系开发者。