Article

FEERAPI 开源API系统

AI摘要

FeerApi v6.0.1 是一个开源免费的 API 接口管理系统，支持用户权限分级、API 密钥体系、积分支付系统等，功能完善，设计精美，适合个人开发者、团队协作和开源社区使用。

此内容根据文章生成，不代表个人观点，仅用于文章内容的解释与总结

FeerApi v6.0.1 - 开源免费的 API 接口管理系统

一个面向开发者的 API 接口聚合与发布平台，让接口管理变得简单高效

开源仓库: https://gitee.com/xunjinlu/feer-api | 演示站点: https://api.xunjinlu.fun

系统预览

项目简介

FeerApi 是一个基于 PHP + MySQL 开发的开源 API 接口管理/发布系统。从 v5.0 到 v6.0.1，我们进行了全面的功能升级，新增了大量企业级特性，包括用户权限分级、API 密钥体系、积分支付系统、QPS 限流控制、调用统计与实时日志等功能，并支持 Web 一键安装向导，适合快速部署到服务器并开源发布。

核心特点

完全免费 - 开源项目，无需付费即可使用全部功能
权限分级 - 支持普通用户与开发者两种角色，满足不同使用场景
API 密钥 - 完善的密钥管理体系，支持生成、重置、禁用密钥
积分系统 - 完整的积分充值、消费、分成体系，支持码支付/易支付
一键安装 - 5 步 Web 安装向导，无需手动配置
实时统计 - 多维度调用统计图表，实时监控 API 使用情况

功能亮点

1. 用户权限分级（v6.0 新增）

系统支持两种用户类型，注册时可自由选择：

普通用户：聚焦密钥管理、积分充值与接口调用消费，适合仅使用接口的开发者
开发者：保留完整的 API 投稿、接口管理、数据统计等功能，适合发布接口的开发者

后台支持一键切换用户类型，切换后用户端实时生效。

2. 完善的 API 密钥体系（v5.3.40+）

用户可在后台生成多个 API 密钥（最多 5 个）
密钥明文展示，支持一键复制
查看每个密钥的调用次数和最后调用时间
支持密钥禁用、重置、删除操作
删除的密钥立即失效，无法继续调用接口

3. 积分支付与分成系统（v5.5.0+）

积分充值：

支持套餐充值和自定义积分充值
码支付/易支付双网关支持
支付二维码弹窗展示，扫码支付
充值成功后自动更新积分余额

积分消费：

接口可配置积分扣费（支持小数，最低 0.1 积分）
调用时自动扣除积分，余额不足自动拦截
积分消费记录实时展示

开发者分成：

代理接口支持开发者分成（默认 70% 给开发者，30% 给平台）
分成比例后台可配置
自动记录分成流水

4. 多维度调用统计（v5.12.0+）

管理员后台：

四条统计折线：全部用户、密钥用户、积分用户、游客用户
支持筛选显示/隐藏特定类型
实时调用日志，支持按用户类型筛选

用户后台：

开发者：展示自己接口的被调用统计（全部/密钥/积分/游客）
普通用户：展示自己的密钥调用统计（全部/未扣积分/已扣积分）

5. 接口级安全配置

API 密钥要求：可配置接口是否必须携带密钥
QPS 限流：支持配置每秒请求限制（0 为不限流）
积分扣费：可配置单次调用扣除的积分数量
当接口配置积分时，系统自动强制开启密钥要求

6. 实时调用日志（v5.4.0+）

记录每次调用的详细信息：API、请求方法、用户、密钥、IP、时间
记录请求来源：域名、路径、Referer、Origin
支持按用户类型筛选日志
管理员后台可查看全站调用日志

7. 精美的前台展示

动态首页 - 带有 WebGL 背景动画和终端风格的 Hero 区域
接口目录 - 支持分类筛选、实时搜索的接口列表
详情页面 - 展示请求参数、响应示例、在线测试功能
接口标签 - 免费/KEY/积分标签直观展示接口属性
文章系统 - 支持发布教程、文档等内容
友链管理 - 支持申请和展示友情链接
合作伙伴 - 首页展示合作伙伴 Logo（v5.19.0+）
公告横幅 - 滚动公告条，点击弹窗查看完整内容（v5.20.0+）

8. 赞助与打赏系统（v5.14.0+）

前台「赞助我们」页面展示赞助榜单与收款码
后台赞助管理，支持手动登记赞助记录
赞助榜单随机排序，支持固定某些记录在最后
支持 QQ 号自动头像与自定义头像

9. 编辑器体验升级（v5.18.0+）

后台与用户侧的 API 文档、文章内容编辑统一接入 Joe 编辑器
支持 Markdown 工具栏
浅色/深色主题自适应
评论支持配图上传与灯箱预览（v5.3.29+）

技术架构

环境要求

PHP: 建议 7.4+ / 8.x
MySQL: 建议 5.7+ / 8.0
扩展: PDO MySQL、cURL、mbstring、openssl
Web 服务器: Nginx / Apache

目录结构

♾️ text 代码:

├── admin/          # 后台管理
├── api/            # API 接口端点
├── assets/         # 前端静态资源
├── config/         # 配置文件
├── core/           # 核心类库
├── docs/           # 文档
├── includes/       # 公共模板
├── install/        # 安装向导
├── user/           # 用户后台
└── proxy.php       # 代理中转入口

核心组件

MySQLDB.php - MySQL 数据库连接与操作
JsonDB.php - 兼容层（保留旧接口，底层使用 MySQL）
UserAuth.php - 用户认证与第三方登录（QQ/Gitee）
ApiCallLogger.php - 调用统计与日志记录
Security.php - 安全防护工具类

v6.0 重大更新说明

用户权限分级

v6.0 最大的变更是引入了用户权限分级机制：

注册时可选择「普通用户」或「开发者」
普通用户隐藏开发者投稿相关入口，聚焦消费端功能
开发者保留完整的投稿与接口管理功能
后台支持一键切换用户类型

统计口径重构

普通用户首页仅展示「我的调用、注册时间、积分余额」
开发者首页展示「我的API、被调用次数、总调用次数」
调用趋势图根据用户类型展示不同的统计维度

安装部署

一键安装（推荐）

上传源码到站点目录
访问域名首页，自动跳转到 /install/
按向导完成 5 步安装：
- 服务器环境检测
- 数据库信息填写
- 连接测试
- 创建数据库表结构
- 创建管理员账号
安装完成后进入后台：/admin/login.php

Nginx 伪静态配置

♾️ nginx 代码:

location ^~ /install/ {
    try_files $uri $uri/ /install/index.php?$query_string;
}

location / {
    try_files $uri $uri/ $uri.php?$query_string @feerapi_proxy;
}

location @feerapi_proxy {
    rewrite ^ /proxy.php last;
}

使用场景

1. 个人开发者

整理和展示自己的 API 接口
建立个人技术品牌
分享开源项目接口
通过接口调用获得积分收入

2. 团队协作

统一管理团队内部 API
接口文档与测试一体化
调用统计与监控
开发者分成激励

3. 开源社区

建立公共 API 聚合平台
社区成员投稿接口
开源项目接口分发
积分经济体系运营

版本演进

v5.0.0: 存储架构升级为纯 MySQL
v5.3.40: 接口密钥 + QPS 限流上线
v5.5.0: 积分与支付体系首版
v5.12.0: 多维度调用统计增强
v5.14.0: 赞助与打赏系统
v5.18.0: Joe 编辑器集成
v5.19.0: 合作伙伴板块
v5.20.0: 公告横幅系统
v6.0.0: 用户权限分级（普通用户/开发者）
v6.0.1: 用户类型切换修复与体验优化

开源信息

开源仓库: https://gitee.com/xunjinlu/feer-api
演示站点: https://api.xunjinlu.fun
当前版本: v6.0.1
开源协议: 开源免费项目

总结

FeerApi v6.0.1 是一个功能完善、设计精美的 API 接口管理系统。相比 v5.0 版本，新增了用户权限分级、API 密钥体系、积分支付系统、QPS 限流控制、多维度调用统计、实时调用日志、赞助打赏系统等大量企业级特性。无论是个人开发者整理接口、团队建立 API 平台，还是开源社区运营 API 聚合服务，FeerApi 都是一个值得考虑的选择。

最重要的是，它是完全开源免费的！你可以自由部署、修改和分发，打造属于自己的 API 接口平台。