小白部署教程

从服务器到可访问域名的完整流程

1

购买一台 Ubuntu 22.04 或 Debian 12 VPS。

2

把域名 A 记录解析到服务器公网 IP。

3

用 SSH 登录服务器,并安装 Docker。

4

创建 /opt/newapi,把生成器里的 docker-compose.yml 粘贴进去。

5

执行 docker compose up -d 启动 NewAPI。

6

配置 Nginx 或 Caddy 反代,访问域名完成初始化。

7

添加模型渠道、令牌和倍率配置。

8

上线前执行一次备份,并记录管理员账号。

常见问题

域名打不开

确认 DNS 已解析到服务器 IP,并检查 80/443 端口是否放行。

容器启动失败

运行 docker compose logs -f 查看报错,优先检查数据库密码和目录权限。

HTTPS 失败

Caddy 需要域名正确解析;Nginx 可配合 acme.sh 或 certbot。

后台访问慢

检查服务器带宽、模型渠道延迟,必要时启用 Redis。