Nexus/docs/changelog/2026-06-06-install-redis-url-1panel-root.md

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

验证

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 时手动修正

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