API Monitor

---

一个全能型的 API 管理与服务器监控面板。 主机、实时 终端、Docker、云服务集成，包括 Cloudflare、OpenAI、Zeabur、Koyeb。

支持Antigravity / Gemini 的模型转 API 调用，有完善的额度使用统计、日志记录、模型列表获取、全链路耗时统计。

🔵 Docker Hub | 🔴 在线演示 (Demo)

Warning

请勿在演示环境中输入真实的敏感数据

📦 快速开始

1. Docker 部署 (推荐)

方式一：Docker Compose (最简)

version: '3.8'
services:
  api-monitor:
    image: iwvw/api-monitor:latest
    container_name: api-monitor
    ports:
      - "3000:3000"
    volumes:
      - ./data:/app/data
    restart: unless-stopped

方式二：Docker CLI

docker run -d --name api-monitor \
  -p 3000:3000 \
  -v $(pwd)/data:/app/data \
  --restart unless-stopped \
  iwvw/api-monitor:latest

2. 本地开发

# 克隆仓库
git clone https://github.com/iwvw/api-monitor.git
cd api-monitor

# 安装依赖
npm install

# 启动开发模式 (热重载: 前端 Vite + 后端 Express)
npm run dev

如需仅运行生产环境模式：

npm run build && npm start

---

🔒 环境变量配置

支持通过 .env 文件或 Docker 环境变量进行配置。可参考根目录下的 .env.example。

变量名	默认值	说明
PORT	3000	服务运行端口
NODE_ENV	production	运行环境 (development / production)
ADMIN_PASSWORD	-	初始管理员密码（首次启动时生效，也可在界面设置）
JWT_SECRET	(随机)	强烈建议设置。用于加密会话 Token
DATA_DIR	/app/data	数据持久化目录 (数据库与日志存放路径)
DB_NAME	data.db	数据库文件名
LOG_LEVEL	INFO	日志级别 (DEBUG, INFO, WARN, ERROR)
LOG_RETENTION_DAYS	7	本地日志文件保留天数
TRUST_PROXY	false	若部署在反代后 (如 Nginx/CF)，建议设为 true
VITE_USE_CDN	true	是否启用 CDN 加载静态资源 (构建时生效)
VITE_CDN_PROVIDER	npmmirror	CDN 节点选择 (npmmirror, jsdelivr, unpkg, bootcdn)

---

📁 目录结构

api-monitor/
├── server.js              # 应用入口
├── src/                   # 核心源码
│   ├── js/modules/        # 前端业务模块
│   ├── db/                # 数据库层
│   ├── middleware/        # Express 中间件
│   ├── routes/            # API 路由
│   ├── services/          # 业务服务
│   └── utils/             # 工具函数
├── modules/               # 可插拔业务模块
│   ├── server-api/        # 服务器/SSH/Docker
│   ├── cloudflare-api/    # Cloudflare DNS
│   ├── antigravity-api/   # Antigravity Agent
│   ├── music-api/         # 网易云音乐代理
│   └── ...                # 更多模块
├── data/                  # 持久化目录 (挂载点)
└── dist/                  # 生产构建产物

详细架构说明 → docs/ARCHITECTURE.md

---

🧩 模块开发指南

本项目采用插件化架构，您可以轻松扩展新功能。详细的开发步骤和规范请参考：

👉 模块开发模板使用指南

---

📄 许可证

本项目基于 MIT 协议开源。

Made with ❤️ by iwvw & jiujiu532