# 2026-06-06 — 修复安装向导 Redis URL 与 1Panel root 用户

## 摘要

步骤 3 Redis 连接失败根因：`_build_redis_url` 生成 `redis://pass@host`（密码被当成用户名）；1Panel Redis ACL 用户名为 `root`。

## 修复

- URL 密码格式改为 `redis://:pass@host` 或 `redis://root:pass@host`
- 向导新增 Redis 用户名，Docker/1Panel 预填 `root`
- 错误提示说明 1Panel 用法

## 涉及文件

- `server/api/install.py`
- `web/app/install.html`
- `tests/test_security_unit.py`
- `deploy/README-1panel.md`

## 验证

```bash
pytest tests/test_security_unit.py -k build_redis_url -q
bash deploy/sync-install-wizard-to-container.sh
```

步骤 3：Redis 用户 `root`、密码 `redis_WP3NyN`、主机 `1Panel-redis-xxxx` → 检测通过。

## 已有 .env 时手动修正

```bash
NEXUS_REDIS_URL="redis://root:你的密码@1Panel-redis-xxxx:6379/0"
```