# Nexus Docker

## 前置

- [Docker Desktop](https://www.docker.com/products/docker-desktop/)（Windows/macOS）或 Docker Engine + Compose v2

## 快速启动（正常模式）

```bash
# 1. 生成密钥（写入 docker/.env，已 gitignore）
python docker/generate_env.py

# 2. 构建并启动
docker compose up -d --build

# 3. 健康检查
curl -s http://localhost:8600/health   # 期望: ok

# 4. 打开 SPA
# http://localhost:8600/app/
```

默认管理员需在安装向导或已有 DB 中配置；若 DB 为空且未跑过 install，可删卷后走安装模式。

## 安装向导模式

不创建 `docker/.env`（或清空 `NEXUS_SECRET_KEY`）时，应用以 **安装模式** 启动：

- http://localhost:8600/app/install.html

完成向导后 `.env` 会写入容器；`nexus-state` 卷会在重启时恢复配置。

## 常用命令

```bash
docker compose logs -f nexus
docker compose down          # 停止，保留数据卷
docker compose down -v       # 停止并删除数据卷（清空 DB）
docker compose build --no-cache nexus
```

## 服务

| 服务 | 端口 | 说明 |
|------|------|------|
| nexus | 8600 | FastAPI + 静态 `/app/` |
| mysql | 3306 | 数据库 `nexus`（Compose 内） |
| redis | — | **不在 Compose 内**；宿主机/1Panel 自建，默认 `host.docker.internal:6379` |

## 生产注意

- 修改 `MYSQL_*` 与 `NEXUS_*` 为强密码，勿使用 `generate_env.py` 默认值上生产。
- 建议前置 Nginx/TLS，仅暴露 443。
- 多实例部署需共享 MySQL、Redis；后台任务由 Redis primary lock 保证单实例执行。

### 1Panel 生产（Compose + OpenResty）

```bash
cp docker/.env.prod.example docker/.env.prod   # 从宝塔 .env 迁入密钥
docker compose -f docker/docker-compose.prod.yml --env-file docker/.env.prod up -d --build
```

- 镜像：`Dockerfile.prod`（含 `npm ci` + `vite build` + **`web/app/install.html` 安装向导**）
- 仅绑定 `127.0.0.1:8600`；OpenResty 反代见 `deploy/1panel/openresty-nexus.conf.example`
- **2C8G 调优**：`docker/mysql-prod-2c8g.cnf`（buffer pool 1G、`max_connections=120`）+ 容器 `mem_limit` + `NEXUS_DB_POOL_SIZE=30`
- 完整迁移步骤：`docs/design/plans/2026-06-04-1panel-docker-production.md`
- 一键安装：`bash deploy/install-1panel-docker.sh`
- 一键升级：`bash deploy/upgrade-1panel-docker.sh`（`--check` 仅查更新）

详见 `docs/design/specs/2026-06-03-docker-design.md`。