zsAPI 部署

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一键部署脚本本体