# 2026-06-05 — 1Panel Redis 容器名与 NEXUS_REDIS_URL 同步

## 摘要

与 MySQL 对齐：探测到 `1Panel-redis-*` 时同步更新 `NEXUS_REDIS_URL`；安装向导步骤 3 增加 Redis TCP 预检与 1panel-network 错误文案；Compose 默认 Redis URL 优先使用 `NEXUS_1PANEL_REDIS_HOST`。

## 涉及文件

- `deploy/nexus-1panel.sh` — sync 写入 `NEXUS_REDIS_URL`
- `server/api/install.py` — Redis 预检与 `_redis_connect_error_detail`
- `docker/docker-compose.prod.yml` — Redis URL 默认表达式

## 验证

```bash
bash deploy/detect-1panel-services.sh   # 应输出 NEXUS_1PANEL_REDIS_HOST=...
grep NEXUS_REDIS_URL docker/.env.prod   # redis://1Panel-redis-xxxx:6379/0
nx update --no-cache
# 安装向导步骤 3 redis_host 预填容器名；步骤 4 Redis 连接通过
```