chore(deploy): 移除 Docker 配置与文档中的部署方案,待从代码重议
This commit is contained in:
@@ -6,7 +6,7 @@
|
||||
|
||||
| 项目 | 内容 |
|
||||
|------|------|
|
||||
| 当前状态 | **实现推进中**——设计文档主体定稿;后端 + 同步引擎 + 前端(管理面与成员视图)已落地;部署链与衍生形态待收尾 |
|
||||
| 当前状态 | **实现推进中**——设计文档主体定稿;后端 + 同步引擎 + 前端(管理面与成员视图)已落地;部署方案与衍生形态待定 |
|
||||
| 技术栈 | 全栈 TypeScript(选型见 [`docs/design/技术选型.md`](docs/design/技术选型.md)):Bun + Hono + Drizzle + PostgreSQL · 前端 Vue 3 + antdv-next |
|
||||
|
||||
## 这是什么
|
||||
@@ -79,59 +79,6 @@ bun run dev:web # 前端 Vite(5175)
|
||||
|
||||
更多命令与协作约定见 [`AGENTS.md`](AGENTS.md)。
|
||||
|
||||
## 部署
|
||||
|
||||
生产形态:**Caddy**(前端静态 + `/api` 反代)+ **server / engine 单文件**(Bun `--compile`)+ PostgreSQL。**迁移不随服务启动**——改表后先用 `db:push` / 手动应用 SQL,再起服务。开发不依赖本 Compose——把 `DATABASE_URL` 指到任意可用 PostgreSQL 即可。
|
||||
|
||||
### 起服务
|
||||
|
||||
```bash
|
||||
cp .env.example .env
|
||||
# 必改:DATABASE_URL、SK_KEY_ENCRYPTION_SECRET、NEWAPI_BASE、COOKIE_SECURE
|
||||
docker compose up -d --build
|
||||
```
|
||||
|
||||
- 页面:`http://<服务器>/`;接口文档:`http://<服务器>/api/docs`
|
||||
- 升级:`git pull` → 有表变更时先应用 schema → 再 `docker compose up -d --build`
|
||||
|
||||
### 环境变量要点
|
||||
|
||||
| 变量 | 说明 |
|
||||
|------|------|
|
||||
| `DATABASE_URL` | 数据库配置的**唯一来源**(用户 / 密码 / 库名都在串里)。开发指向本机库;部署同一份即可,compose 会把主机改写为容器服务名 `postgres` |
|
||||
| `SK_KEY_ENCRYPTION_SECRET` | ≥32 字节随机数(base64url)。**生成一次、入库后不可更换**——丢失则已登记 key 无法解密,与库同等备份 |
|
||||
| `NEWAPI_BASE` | 上游 NewAPI 实例根地址 |
|
||||
| `COOKIE_SECURE` | HTTPS / 域名用 `true`;纯 IP + HTTP 用 `false`(否则登录后立刻 401) |
|
||||
| `ADMIN_INIT_USERNAME` / `ADMIN_INIT_PASSWORD` | 可选;同时存在时空库首次静默建管理员 |
|
||||
|
||||
### 服务分工
|
||||
|
||||
| 服务 | 职责 | 对外 |
|
||||
|------|------|------|
|
||||
| `caddy` | 前端静态 + `/api` 反代 | 仅 80 / 443 |
|
||||
| `server` | 管理面 / 成员视图 API | 内网 |
|
||||
| `engine` | 轮询上游、去重入库 | 内网 |
|
||||
| `postgres` | 数据(卷 `pgdata`) | 内网 |
|
||||
|
||||
### HTTPS
|
||||
|
||||
把 `deploy/Caddyfile` 站点行从 `:80` 改成域名(如 `your.domain.example`),重建后 Caddy 自动签证书;同时设 `COOKIE_SECURE=true`。
|
||||
|
||||
### 常用命令
|
||||
|
||||
```bash
|
||||
docker compose ps # 运行状态
|
||||
docker compose logs -f engine # 看同步
|
||||
docker compose restart server # 只重启后端
|
||||
docker compose down # 全停(数据在卷里,不丢)
|
||||
```
|
||||
|
||||
### 注意
|
||||
|
||||
1. `COOKIE_SECURE` 必须与访问方式匹配:HTTP + `true` 会「登录后立刻 401」
|
||||
2. `SK_KEY_ENCRYPTION_SECRET` 更换等于已登记 key 全部作废
|
||||
3. `DATABASE_URL` 密码含 `@` `:` `/` 等字符时做 URL 编码
|
||||
|
||||
## 文档地图
|
||||
|
||||
| 文档 | 什么时候读 | 状态 |
|
||||
|
||||
Reference in New Issue
Block a user