Files
appstore/apps/metapi/README.md
T
2026-04-14 23:29:52 +08:00

58 lines
2.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Metapi
Metapi 是一个面向多 AI 中转站聚合场景的统一网关,适合在 1Panel 中部署为集中入口,用于统一转发、令牌管理与定时任务调度。
## 应用简介
该应用将多个 AI 中转服务的访问能力收敛到一个统一网关内,方便在单一入口下完成鉴权、代理调用与日常维护。当前 1Panel 适配版本提供开箱即用的本地应用结构,部署后可直接通过 Web 端口对外提供服务。
## 功能亮点
- 聚合多个 AI 中转站,统一对外暴露访问入口
- 支持管理员令牌与代理令牌配置,方便分权管理
- 支持签到任务与余额刷新任务的 Cron 调度
- 支持数据目录持久化,便于保留运行数据与后续迁移
- 配置项集中在安装表单中维护,适合面板化运维
## 安装说明
安装时建议至少确认以下参数:
- 访问端口
- 数据目录
- `AUTH_TOKEN` 管理员令牌
- `PROXY_TOKEN` 代理令牌
- `CHECKIN_CRON` 自动签到计划
- `BALANCE_REFRESH_CRON` 余额刷新计划
- 时区配置
其中两类令牌都属于关键安全参数,建议直接使用高强度随机值。
## 默认配置
- 访问端口:`4000`
- 容器内部端口:`4000`
- 默认数据目录:`./data`
- 容器内数据目录:`/app/data`
- 默认签到 Cron`0 8 * * *`
- 默认余额刷新 Cron`0 * * * *`
- 默认时区:`Asia/Shanghai`
## 使用建议
- 首次安装时优先更换为高强度 `AUTH_TOKEN``PROXY_TOKEN`
- 若服务器已有统一反向代理,可将 Metapi 作为内部网关服务接入
- Cron 任务建议按实际中转站频率与额度策略调整,避免过于激进
- 数据目录建议放到稳定存储位置,便于备份与故障恢复
## 安装后检查
1. 打开 `http://<服务器IP>:<访问端口>` 确认服务已启动。
2. 检查令牌配置是否生效。
3. 检查数据目录是否已正确挂载。
4. 观察签到与余额刷新任务是否按预期执行。
## 适配说明
当前目录为可直接导入 1Panel 的本地应用包,已按商店应用结构整理,重点保留安装表单、数据挂载和运行参数的面板化配置体验。