配置生成器

生成可复制的 NewAPI 部署脚本

先用 SQLite 快速跑通，正式运营建议切到 MySQL 或 PostgreSQL，并替换模板里的默认密码。

1. 安装 Docker

适用于 Ubuntu / Debian 系服务器。CentOS 建议使用官方 Docker 文档。

apt update -y
apt install -y ca-certificates curl gnupg
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo $VERSION_CODENAME) stable" > /etc/apt/sources.list.d/docker.list
apt update -y
apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
docker --version

2. docker-compose.yml

把下面内容保存到 /opt/newapi/docker-compose.yml。上线前请替换 change_this_password。

services:
  newapi:
    image: calciumion/new-api:latest
    container_name: newapi
    restart: always
    ports:
      - "3000:3000"
    volumes:
      - ./data:/data
    environment:
      - TZ=Asia/Shanghai
      - SQL_DSN=/data/new-api.db

3. Nginx 反代配置

域名需先解析到服务器 IP。Caddy 会自动申请 HTTPS 证书。

server {
    listen 80;
    server_name api.example.com;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_read_timeout 300s;
        proxy_send_timeout 300s;
    }
}

4. 启动 NewAPI

进入目录，粘贴配置文件后启动容器。

mkdir -p /opt/newapi
cd /opt/newapi
nano docker-compose.yml
docker compose up -d
docker compose logs -f

5. 更新命令

升级前建议先执行备份命令。

cd /opt/newapi
docker compose pull
docker compose down
docker compose up -d
docker image prune -f

6. 备份命令

会在 /opt 目录生成一个带时间戳的压缩包。

cd /opt
tar -czvf newapi-backup-$(date +%Y%m%d-%H%M%S).tar.gz newapi