mirror of
https://github.com/cita-777/metapi.git
synced 2026-11-01 12:01:53 +08:00
158 lines
3.0 KiB
Markdown
158 lines
3.0 KiB
Markdown
# 🚢 部署指南
|
||
|
||
[返回文档中心](./README.md)
|
||
|
||
---
|
||
|
||
## Docker Compose 部署（推荐）
|
||
|
||
### 标准步骤
|
||
|
||
```bash
|
||
mkdir metapi && cd metapi
|
||
|
||
# 创建 docker-compose.yml（参见快速上手）
|
||
# 设置环境变量
|
||
export AUTH_TOKEN=your-admin-token
|
||
export PROXY_TOKEN=your-proxy-sk-token
|
||
|
||
# 启动
|
||
docker compose up -d
|
||
```
|
||
|
||
### 使用 `.env` 文件
|
||
|
||
如果不想每次 export，可以创建 `.env` 文件：
|
||
|
||
```bash
|
||
# .env
|
||
AUTH_TOKEN=your-admin-token
|
||
PROXY_TOKEN=your-proxy-sk-token
|
||
TZ=Asia/Shanghai
|
||
PORT=4000
|
||
```
|
||
|
||
```bash
|
||
docker compose --env-file .env up -d
|
||
```
|
||
|
||
> ⚠️ `.env` 文件包含敏感信息，请勿提交到 Git 仓库。
|
||
|
||
## Docker 命令部署
|
||
|
||
```bash
|
||
docker run -d --name metapi \
|
||
-p 4000:4000 \
|
||
-e AUTH_TOKEN=your-admin-token \
|
||
-e PROXY_TOKEN=your-proxy-sk-token \
|
||
-e TZ=Asia/Shanghai \
|
||
-v ./data:/app/data \
|
||
--restart unless-stopped \
|
||
1467078763/metapi:latest
|
||
```
|
||
|
||
> **路径说明：**
|
||
> - `./data:/app/data` — 相对路径，数据存到当前目录下的 `data` 文件夹
|
||
> - 也可以使用绝对路径：`/your/custom/path:/app/data`
|
||
|
||
## 反向代理
|
||
|
||
### Nginx
|
||
|
||
流式请求（SSE）需要关闭缓冲，否则流式输出会异常：
|
||
|
||
```nginx
|
||
server {
|
||
listen 443 ssl;
|
||
server_name your-domain.com;
|
||
|
||
ssl_certificate /path/to/cert.pem;
|
||
ssl_certificate_key /path/to/key.pem;
|
||
|
||
location / {
|
||
proxy_pass http://127.0.0.1:4000;
|
||
|
||
# SSE 关键配置
|
||
proxy_buffering off;
|
||
proxy_cache off;
|
||
proxy_set_header Connection '';
|
||
proxy_http_version 1.1;
|
||
chunked_transfer_encoding off;
|
||
|
||
# 标准代理头
|
||
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;
|
||
}
|
||
}
|
||
```
|
||
|
||
### Caddy
|
||
|
||
```
|
||
your-domain.com {
|
||
reverse_proxy localhost:4000 {
|
||
flush_interval -1
|
||
}
|
||
}
|
||
```
|
||
|
||
## 升级
|
||
|
||
```bash
|
||
# 拉取最新镜像
|
||
docker compose pull
|
||
|
||
# 重新启动（数据不受影响）
|
||
docker compose up -d
|
||
|
||
# 清理旧镜像
|
||
docker image prune -f
|
||
```
|
||
|
||
## 回滚
|
||
|
||
如果升级后出现问题：
|
||
|
||
1. **升级前备份**（建议每次升级前执行）：
|
||
|
||
```bash
|
||
cp -r data/ data-backup-$(date +%Y%m%d)/
|
||
```
|
||
|
||
2. **回滚到指定版本**：
|
||
|
||
```bash
|
||
# 修改 docker-compose.yml 中的 image tag
|
||
# 例如：image: 1467078763/metapi:v1.0.0
|
||
|
||
# 恢复数据
|
||
rm -rf data/
|
||
cp -r data-backup-20260228/ data/
|
||
|
||
# 重启
|
||
docker compose up -d
|
||
```
|
||
|
||
## 数据持久化
|
||
|
||
Metapi 的所有运行数据存储在 SQLite 数据库中，位于 `DATA_DIR`（默认 `./data`）目录下。
|
||
|
||
只要挂载了该目录，升级、重启都不会丢失数据。
|
||
|
||
### 备份策略建议
|
||
|
||
- 每日自动备份 `data/` 目录
|
||
- 保留最近 7~30 天的备份
|
||
- 重要操作前手动快照
|
||
|
||
## 下一步
|
||
|
||
- [配置说明](./configuration.md) — 详细环境变量
|
||
- [运维手册](./operations.md) — 日志排查、健康检查
|