36 lines
1.7 KiB
Markdown
36 lines
1.7 KiB
Markdown
# 2026-06-06 — 安装向导 Redis:无账号 + 步骤 4 自愈
|
||
|
||
## 摘要
|
||
|
||
确立 1Panel Redis **无账号**铁律;Docker 安装模式仅尝试 `redis://:pass@` 与 `default`;步骤 4 `connection-check` 可自动修正错误的 `NEXUS_REDIS_URL`;前端 1Panel 模式隐藏 Redis 用户名字段。
|
||
|
||
## 动机
|
||
|
||
- 1Panel Redis 只有 `requirepass` 口令,不是 MySQL 式 `root` 用户;历史误读导致 `redis://root:pass@` 认证失败。
|
||
- 步骤 3 在旧版本写入错误 URL 后,步骤 4 仅读 `.env` 原文无法通过,需向导内自愈。
|
||
- 暴露「Redis 用户名」输入框易误导运维填 `root`。
|
||
|
||
## 涉及文件
|
||
|
||
- `server/api/install.py` — `_sanitize_redis_request`、候选顺序、`_init_db_request_from_redis_url`、`_patch_env_redis_url`、`connection-check` 修复
|
||
- `web/app/install.html` — 1Panel 隐藏 `redis_user`、展示 `resolved_redis_url` / `redis_repaired`
|
||
- `deploy/test-1panel-redis.sh` — 移除 root 探测
|
||
- `deploy/verify-1panel-install-wizard.sh` — 3b2856f+ 与 `.env` Redis URL 检查
|
||
- `docs/project/nexus-1panel-operations-knowledge.md` — 全文去 Redis root 表述
|
||
- `tests/test_security_unit.py` — Redis 解析与 connection-check 修复用例
|
||
|
||
## 迁移 / 重启
|
||
|
||
- 已有错误 `.env`:步骤 4 点「重新检测连接」可自动修补;或手动改为 `redis://:密码@1Panel-redis-xxxx:6379/0`
|
||
- 部署:`git pull` → `bash deploy/sync-install-wizard-to-container.sh`(或 `nx update`)
|
||
|
||
## 验证
|
||
|
||
```bash
|
||
pytest tests/test_security_unit.py -k redis
|
||
bash deploy/test-1panel-redis.sh # 服务器,需 REDIS_PASS
|
||
bash deploy/verify-1panel-install-wizard.sh
|
||
```
|
||
|
||
浏览器:步骤 3 仅填 Redis 密码 → 检测 → 初始化 → 步骤 4 连接全绿。
|