落七七 API 管理系统详细部署与开发教程（正版授权版）
一、 重要声明（必读）
在开始本教程之前，关于本套系统的授权与更新机制，有几点需要特别说明：
这个源码是我买的，我加的授权。至于这个授权，已获得原作者同意。你们支付的费用，我要分给原作者七成，剩下的作为引流商城的信息服务费。如果你们购买了这套源码，后续原作者因为某些原因如果不更新，将由我负责更新。
所以请各位放心购买和使用，本系统拥有充足的售后保障与持续的迭代维护能力。作为一款全开源、高并发、专业级的 API 分发管理解决方案，它集成了强大的 QPS 限制、接口计费、可视化数据分析等功能，是开发者构建个人或企业级 API 平台的理想选择。
二、 准备工作：服务器环境与扩展要求
为了保证落七七 API 管理系统的各项功能（特别是极速并发与计费拦截）能够稳定运行，请务必严格按照以下要求配置您的服务器环境。
1. 基础环境配置
- 操作系统： CentOS / Ubuntu / Debian 均可（强烈推荐安装宝塔面板 BT-Panel 以便可视化管理）。
- PHP 版本： 推荐使用 PHP 8.0。请注意，系统对底层代码进行了深度优化，低版本可能无法兼容。
- 数据库： MySQL 5.7+（推荐使用 5.7 或 8.0 版本）。
2. 必须安装的 PHP 扩展（核心重点）
进入宝塔面板 -> 软件商店 -> 您安装的 PHP 版本 -> 设置 -> 安装扩展： - Redis 扩展： 必须安装。系统的 QPS 频率限制（高频计数）完全依赖 Redis 内存缓存，不安装将导致并发限制和频率统计功能失效。
- sg12 扩展： 必须安装。 底层核心文件依赖 sg12 加密扩展进行解析与运行，如果未安装此扩展，访问网站时将会出现致命错误或白屏。
三、 基础部署流程
1. 上传源码与解压
登录宝塔面板，进入“网站”菜单，点击“添加站点”并绑定您的域名。创建完成后，进入网站根目录，将下载好的源码包上传并解压。请确保系统内所有的目录（尤其是接口目录）具有足够的读写权限。
2. 修改核心配置文件
找到网站根目录下的 config.php 文件，这是系统的核心配置文件。您需要将其中的数据库连接信息以及邮箱服务器配置（用于找回密码和发送通知）修改为您自己的信息：
// 数据库配置示例
define('DB_HOST', 'localhost');
define('DB_NAME', '您的数据库名');
define('DB_USER', '您的数据库用户名');
define('DB_PASS', '您的数据库密码');
// 邮件服务器配置
define('SMTP_SERVER', 'smtp.example.com');
define('SMTP_USER', 'service@example.com');
define('SMTP_KEY', '您的邮箱授权码');3. 配置伪静态规则（极为关键）
API 的路由转发完全依赖伪静态。请在宝塔面板的站点设置中，找到“伪静态”选项卡，填入以下 Nginx 伪静态规则并保存：
location / {
try_files $uri $uri/ @router;
}
location @router {
rewrite ^/a/([0-9]+)$ /detail.php?id=$1 last;
rewrite ^/$ /index.php last;
}四、 接口开发规范与添加教程
系统通过“标识（短名）”来调用并管理接口的调用次数与计费状态。请务必按照以下规范进行开发。
1. 推荐的接口源码存放位置
我强烈推荐将您的接口源码统一放置在这个位置结构下：/api/接口名称/api.php。
例如，如果您要写一个 ACG 动漫图片的 API，对应的文件路径就是：api/acg/api.php。
2. 统计次数与付费调用核心代码
要在您的接口源码中接入系统的统计次数、QPS 限制和付费调用功能，必须在接口文件的最顶部引入核心文件并初始化接口短名。
引入的核心代码必须是：
<?php
require_once __DIR__ . '/../../Interface/core.php';
sakura_api_boot('接口标识 短名');（注意：这里的 sakura_api_boot() 括号内填写的必须是你在后台添加接口时设置的“标识（短名）”。下面才是你的业务源码。）
3. 完整的接口开发示例
结合上面的路径要求和核心代码，一个完整的 ACG 图片接口（文件位于 api/acg/api.php）的具体写法如下：
<?php
require_once __DIR__ . '/../../Interface/core.php';
sakura_api_boot('acgapi');
header("Content-Type: text/plain; charset=utf-8");
echo "Hello World";当用户访问这个接口时，系统会自动拦截判断用户的剩余次数、账户余额以及是否触发了 QPS 限制，验证通过后才会输出下方的 “Hello World” 或你的具体业务逻辑。
五、 系统授权激活指引 (必须操作)
本版本为带有授权保护的正版源码，在部署完毕后，必须配置授权文件才能正常使用。
获取授权码的方式请前往专属的授权验证网站：auth.yunbai.icu。在该网站使用您购买的卡密进行自助授权。授权完成后，您将获得一个专属的授权码。
拿到授权码后，请找到系统内的授权文件（通常位于根目录的 auth.php），将其内容完全替换为以下格式：
<?php
return [
'authcode' => '填入你的授权码'
];保存文件后，系统即完成激活，您可以登录后台开始配置您的 API 平台了。
注意，最新版如果是从授权站下载的，会自动填写授权吗
六、 QPS（频率限制）高级机制说明
落七七系统内置了双层 QPS 频率控制机制，能有效防止恶意刷包和 CC 攻击：
- 公共 QPS： 针对不携带 Key（游客）的用户，限制全局的请求频率。可以有效防止公共接口被无差别恶意调用。
- 个人 QPS： 针对带 Key 的注册/付费用户。用户需要在个人中心进行初始化，系统支持单人单接口级别的并发限制。
- 封禁机制： 系统默认配置为：若 30 秒内单 IP 或单 Key 请求超过限制次数，系统将自动在 Redis 层面拦截并封禁 60 秒，极大节省了服务器资源。
