Nexus Deploy
3f5eacae60
Server-side checklist for 1panel-network, container host sync, and install API defaults before completing /app/install.html. Co-authored-by: Cursor <cursoragent@cursor.com>
5.6 KiB
1Panel + Docker 一键部署
脚本速查（公共仓库 · 无需令牌）
| 脚本 | 用途 | 一条命令 |
|---|---|---|
quick-install.sh |
仅装 Nexus（1Panel 已就绪） | curl -fsSL "http://66.154.115.8:3000/admin/Nexus/raw/branch/main/deploy/quick-install.sh" | bash |
install-1panel-docker.sh |
重装服务器全链 | curl -fsSL ".../install-1panel-docker.sh" | bash |
install-nexus-fresh.sh |
全新空库安装 | bash deploy/install-nexus-fresh.sh --skip-clone |
update.sh |
一键更新 | curl -fsSL ".../update.sh" | bash |
nexus-1panel.sh |
底层 install / upgrade | bash deploy/nexus-1panel.sh upgrade |
nx |
统一运维菜单 | nx |
档位：--profile 1c4g · 2c8g（默认）· 4c16g
重装服务器（1Panel + Docker + Nexus）
curl -fsSL "http://66.154.115.8:3000/admin/Nexus/raw/branch/main/deploy/install-1panel-docker.sh" | bash
4 核 16G：
curl -fsSL ".../install-1panel-docker.sh" | bash -s -- --profile 4c16g
已装 1Panel，只装 Nexus：
curl -fsSL ".../install-1panel-docker.sh" | bash -s -- --skip-1panel
仅 Nexus Docker
curl -fsSL "http://66.154.115.8:3000/admin/Nexus/raw/branch/main/deploy/quick-install.sh" | bash
安装完成后：https://api.synaglobal.vip/app/install.html
一键更新（日常）
cd /opt/nexus && bash deploy/update.sh
# 或
nx update
# 或菜单
nx # → [4] 一键更新
| 选项 | 说明 |
|---|---|
--check |
仅查 Git，不重建 |
--no-cache |
无缓存重建镜像（entrypoint 变更后必用） |
--no-backup |
跳过 MySQL 备份 |
--prune |
清理悬空镜像 |
远程：
curl -fsSL "http://66.154.115.8:3000/admin/Nexus/raw/branch/main/deploy/update.sh" | bash
curl -fsSL ".../update.sh" | bash -s -- --no-cache
NX 全局命令
安装 / 升级 / 首次运行 nx 会自动注册到 /usr/local/bin：
# 手动注册（任意目录可用 nx）
NEXUS_ROOT=/opt/nexus bash /opt/nexus/deploy/install-nx-cli.sh
nx # 统一运维菜单
nexus-update # 等同 update.sh
nexus-fresh # 等同 install-nexus-fresh.sh
nexus-install # 等同 quick-install.sh
| 菜单 | 功能 |
|---|---|
[1] |
安装向导（档位 / 迁机 / skip-clone） |
[2] |
全新安装 → /app/install.html |
[4] |
一键更新 |
[5] |
重启 Nexus |
[6] |
日志 |
MySQL / Redis（1Panel 应用商店）
Docker 栈仅含 Nexus 容器。MySQL / Redis 在 1Panel 应用商店安装。
1Panel 官方互联方式（必读）
1Panel 维护者说明：应用商店应用使用 bridge + 1panel-network；容器之间用容器名通信（Docker 内置 DNS），不要用 localhost / 127.0.0.1 / host.docker.internal。
| 场景 | 正确主机 |
|---|---|
| Nexus → 1Panel MySQL | 1Panel-mysql-xxxx（容器列表中的名称） |
| Nexus → 1Panel Redis | 1Panel-redis-xxxx |
| OpenResty → 应用 | 127.0.0.1:端口（OpenResty 为 host 网络） |
nx update / nexus-1panel.sh 会：
- 将 Nexus 加入
1panel-network（docker/docker-compose.1panel.yml） - 自动探测 MySQL/Redis 容器名写入
docker/.env.prod（含NEXUS_REDIS_URL=redis://1Panel-redis-xxxx:6379/0） - 安装向导步骤 3 预填 MySQL/Redis 容器名
安装步骤
- 应用商店 → 安装 MySQL、Redis
- 数据库 → 创建库
nexus、用户nexus（仅授权nexus库），记下密码 nx update后打开安装向导步骤 3（主机应已预填1Panel-mysql-…）- 填写 MySQL 密码；Redis 若设了密码一并填写
若仍报 Can't connect to MySQL/Redis on 'host.docker.internal'：说明 Nexus 未接入 1panel-network 或未探测到容器名，在服务器执行：
cd /opt/nexus && bash deploy/detect-1panel-services.sh
nx update --no-cache
步骤 2 会 TCP 检测 MySQL/Redis；步骤 4 验证账号密码。
卸载旧 Compose 容器：
bash deploy/uninstall-mysql-compose.sh
bash deploy/uninstall-redis-compose.sh
1Panel 反代
禁止脚本改 /opt/1panel/apps/openresty/。
- 应用商店 → OpenResty
- 网站 → 反代
http://127.0.0.1:8600 - 参考：
deploy/1panel/openresty-nexus.conf.example
密钥
新机自动生成 NEXUS_SECRET_KEY / NEXUS_API_KEY / NEXUS_ENCRYPTION_KEY → docker/.env.prod，备份 /root/.nexus-install-secrets-*.env。
MySQL 密码在 1Panel 自建库时设定，向导步骤 3 填写。
| 场景 | 命令 |
|---|---|
| 新机 | curl | quick-install.sh |
| 迁机 | nexus-1panel.sh install --from-env /path/to/.env |
| 更新 | update.sh 或 nx update |
Git：公开仓库 clone / pull / curl | bash 无需令牌。
安装向导验收（服务器执行）
在 1Panel 终端（root）一键检查网络、容器名预填、本地 /health 与 /api/install/env-check：
cd /opt/nexus && bash deploy/verify-1panel-install-wizard.sh
通过后再浏览器打开 https://你的域名/app/install.html。常见修复：
cd /opt/nexus && bash deploy/detect-1panel-services.sh
nx update --no-cache
外网 HTTPS 仍失败但脚本本地检查全绿 → 在 1Panel 网站配置反代 http://127.0.0.1:8600（见 deploy/1panel/openresty-nexus.conf.example）。
安装向导热修复
cd /opt/nexus && git pull
bash deploy/update.sh --no-cache
# 或仅同步静态:
bash deploy/sync-install-wizard-to-container.sh