Files

T

Nexus Deploy 6276ea08b7 feat(docker): remove bundled Redis; use external host install

Compose stack is MySQL+Nexus only; wizard Redis check is non-blocking
and defaults to host.docker.internal for self-managed Redis.

Co-authored-by: Cursor <cursoragent@cursor.com>

2026-06-06 02:48:00 +08:00

2.4 KiB

Raw Blame History

Nexus Docker

前置

Docker Desktop（Windows/macOS）或 Docker Engine + Compose v2

快速启动（正常模式）

# 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 卷会在重启时恢复配置。

常用命令

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）

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。

2.4 KiB Raw Blame History Unescape Escape