diff --git a/.env.example b/.env.example
index b85a6e2..8ea85f4 100644
--- a/.env.example
+++ b/.env.example
@@ -72,6 +72,11 @@ NODE_ENV=development
 # 格式：redis://用户名:密码@主机:端口
 # REDIS_URL="redis://default:password@host:port"
 
+# Docker Compose 自带的 Redis 容器（compose 自带 redis 服务，仅在启用自带 redis 时用）
+#   - 留空（或空字符串）：不设置 Redis 密码，内网部署常用（默认）
+#   - 填写强密码：Redis 会启用 requirepass，连接时 REDIS_URL 里也要带上相同密码
+REDIS_PASSWORD=
+
 # Redis 键命名空间，多个 VoiceHub 环境共用 Redis 时应分别设置
 # REDIS_KEY_PREFIX="voicehub:v2:"
 
diff --git a/docker-compose.yml b/docker-compose.yml
index 3eb9540..de070a1 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -1,4 +1,6 @@
-name: BYW VoiceHub (1.7.0.0)
+# ⚠️ Docker Compose v2 顶级 name 必须匹配正则 ^[a-z0-9][a-z0-9_-]*$
+#    不能有大写、空格、括号、中文，否则会报 name Does not match pattern 错误
+name: byw-voicehub
 services:
   # ========================================================================
   # 应用本体 - Nuxt 4 (Node SSR)