# Free_ApiManager

**Repository Path**: IkunWindow/free_-api-manager

## Basic Information

- **Project Name**: Free_ApiManager
- **Description**: 一个致力于提供免费API管理服务的开源项目，支持API的创建、测试与文档生成，旨在为开发者简化API开发流程。
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-03-01
- **Last Updated**: 2026-05-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
  <img src="前端.png" alt="LLM API Manager 登录界面" width="600">
</p>

<p align="center">
  <strong>🔐 一站式 API 密钥管理平台（开源版）</strong>
</p>

<p align="center">
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-AGPL--3.0-blue.svg" alt="License"></a>
  <a href="#"><img src="https://img.shields.io/badge/Python-3.10+-blue.svg" alt="Python"></a>
  <a href="#"><img src="https://img.shields.io/badge/FastAPI-0.115+-green.svg" alt="FastAPI"></a>
  <img src="https://img.shields.io/badge/数据库-SQLite%20%7C%20PostgreSQL-orange" alt="Database">
</p>

<p align="center">
  <strong>⚡ 3 分钟快速部署</strong> · 无需安装数据库 · 开箱即用
</p>

<p align="center">
  <strong>简体中文</strong> | <a href="README_EN.md">English</a>
</p>

---

## ✨ 特点

- 🚀 **快速部署** — 一键安装脚本，无需手动配置
- 💾 **零依赖启动** — 默认使用 SQLite，无需安装数据库
- 🔐 **银行级加密** — AES-256 加密存储，密钥永不明文
- 🏷️ **预设服务商** — 支持 OpenAI、Claude、Gemini、DeepSeek 等 10+ 平台
- 🔒 **双因素认证** — 支持 TOTP 二次验证
- 📱 **响应式设计** — 支持手机、平板、电脑访问

---

## ⚡ 快速开始

### Windows

```powershell
# 1. 克隆项目
git clone https://github.com/your-username/api-key-manager.git
cd api-key-manager

# 2. 一键安装（右键 -> 使用 PowerShell 运行）
.\install.ps1

# 3. 启动服务
.\start.ps1

# 4. 访问 http://localhost:8001
```

### Linux / Mac

```bash
# 1. 克隆项目
git clone https://github.com/your-username/api-key-manager.git
cd api-key-manager

# 2. 一键安装
chmod +x install.sh && ./install.sh

# 3. 启动服务
./start.sh

# 4. 访问 http://localhost:8001
```

---

## 🐳 Docker 部署

### 方式一：SQLite 模式（推荐个人使用）

```bash
# 一键启动（最简单）
docker-compose -f docker-compose.sqlite.yml up -d

# 访问 http://localhost:8001
# 数据存储在 ./data/api_manager.db
```

### 方式二：PostgreSQL 模式（推荐生产环境）

```bash
# 1. 创建配置文件
cp .env.example .env

# 2. 编辑 .env，设置必要的环境变量
# - DATABASE_URL=postgresql://user:password@db:5432/api_manager
# - SECRET_KEY=your-secret-key
# - ENCRYPTION_KEY=your-encryption-key
# - ENCRYPTION_SALT=your-encryption-salt

# 3. 启动服务
docker-compose up -d

# 4. 访问 http://localhost:80
```

---

## 🔧 功能列表

### 核心功能

| 功能 | 说明 |
|------|------|
| 🔑 API Key 管理 | 加密存储、分组管理、过期提醒 |
| 🏷️ 预设服务商 | OpenAI、Claude、Gemini、DeepSeek 等 |
| 🔐 TOTP 认证 | 支持 Google Authenticator 等 |
| 🌐 OpenAI 兼容 API | 标准接口，支持所有兼容客户端 |
| 📊 使用统计 | Token 使用量、费用统计 |
| 📝 操作日志 | 完整的操作审计记录 |
| 🔔 登录通知 | 邮件通知异地登录 |

### 高级功能

| 功能 | 说明 |
|------|------|
| 🎫 访问令牌 | 生成可分享的 API 访问密钥 |
| 📱 单设备登录 | 踢出其他设备，保障账户安全 |
| 🔒 账户锁定 | 紧急锁定账户，防止未授权访问 |
| 🛡️ 安全设置 | 登录通知、异地登录验证 |

---

## 📖 文档

- [安装指南](docs/installation.md)
- [配置说明](docs/configuration.md)
- [API 文档](docs/api.md)

---

## 🤝 贡献

欢迎贡献代码！请查看 [贡献指南](CONTRIBUTING.md)。

1. Fork 本仓库
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 创建 Pull Request

---

## 📄 许可证

本项目采用 GNU Affero General Public License v3.0 (AGPL-3.0) 许可证。

这意味着：
- ✅ 可以自由使用、修改和分发
- ✅ 必须保留原作者版权声明
- ✅ 修改后的版本必须以相同许可证开源
- ✅ 网络服务使用时也需提供源代码

详见 [LICENSE](LICENSE) 文件。

---

## 🙏 致谢

感谢所有贡献者的付出！