OpenAI 兼容 API 平台 · 一键部署
一条命令,把中转站跑起来。
zsAPI 是自建 API 中转/聚合平台:网关转发、用户与分组倍率计费、余额充值、卡密、模型广场、管理后台。 下面的脚本在全新的 Ubuntu / Debian 服务器上自动装环境、编译前后端、建库、注册服务、配好 nginx 并申请 HTTPS 证书。
curl -fsSL https://deploy.0lt.top/zsapi.sh -o zsapi.sh && bash zsapi.sh
用 root 执行。已装过的机器要重装:命令后加 FORCE=1(数据库不会被覆盖)。
脚本会问你四个问题
直接回车 = 用括号里的默认值。
| 问题 | 说明 |
|---|---|
| 站点域名 | 例如 api.example.com。先解析到本机再部署,证书会自动签好;留空则只能用 IP 访问。 |
| 站点名称 | 显示在导航栏和首页。 |
| 管理员用户名 | 默认 admin。 |
| 管理员密码 | 回车自动生成随机密码,结束时打印在屏幕上。 |
需要:Ubuntu 20.04 以上或 Debian 11 以上、root 权限、8G 以上可用磁盘。全程 5 到 15 分钟(第一次要下载 Go、Node 和 npm 依赖)。
也可以一步不落地自动化:
DOMAIN=api.example.com SITE_NAME="我的API" ADMIN_PASS='你的密码' bash zsapi.sh --yes
装完做这四件事
按顺序点几下就好了,每一步的细节都在完整教程里。
01
改站名与注册开关
后台 /system-settings:站点标题、开放注册、邀请奖励、签到、维护公告。
02
换 LOGO
替换 /opt/zsapi-vue/public/favicon.png 后 npm run build;不想编译就直接换 dist/favicon.png。
03
接上游渠道和模型
/channels 添加上游地址与 Key,点「获取模型」「测试」;再到 /models 定价、/groups 配倍率。
04
配易支付收款
把 submit / pid / key 填进 /etc/zsapi/app.php,回调地址填 /api/payment/notify,重启 zsapi-go。
运维速查
所有改动都在下面这几个位置。
| 路径 / 命令 | 说明 |
|---|---|
/etc/zsapi/app.php | 配置:易支付、邮件、短信。改完 systemctl restart zsapi-go |
/opt/zsapi/data/zsapi.sqlite | 数据库(用户、渠道、Key、订单)。定期备份它 |
/opt/zsapi-go | 后端源码与二进制:go build -o zsapi-go-server . |
/opt/zsapi-vue | 前端源码与 dist 产物:npm run build |
tail -f /var/log/zsapi-go.log | 实时日志,排查支付与上游报错就看它 |
文件
| 文件 | 用途 |
|---|---|
| README.md | 完整部署与配置教程(易支付、站名、LOGO、渠道、邮件、常见问题) |
| zsapi-deploy.tar.gz | 源码包(含脚本),可离线部署:解压后 bash install.sh |
| zsapi.sh | 一键部署脚本本体 |