docs: 加强 Docker 部署时 .env 文件创建的说明和提示

- 在 docker-compose.yml 顶部添加醒目的注释说明必须先创建 .env 文件
- 更新 README.md,在 Docker 部署章节开头突出强调创建 .env 的重要性
- 解释为什么必须先创建文件(避免 Docker 创建成目录)
- 改进 docker-compose-init.sh 脚本,增加错误检测和修复功能
- 提供清晰的步骤指引和故障排除方法
This commit is contained in:
shaw
2025-07-24 15:26:41 +08:00
parent 4c572b82ba
commit 232c276c8c
5 changed files with 144 additions and 5 deletions

View File

@@ -224,6 +224,18 @@ npm run service:status
## 🐳 Docker 部署(推荐)
### ⚠️ 首次部署必须执行
```bash
# 创建空的 .env 文件(非常重要!)
touch .env
```
> 🔴 **为什么必须先创建 .env 文件?**
> - Docker 在映射不存在的文件时会创建成**目录**而非文件
> - .env 文件用于存储加密密钥,必须持久化保存
> - 如果变成目录,容器将无法启动
### 使用 Docker Hub 镜像(最简单)
> 🚀 推荐使用官方镜像,自动构建,始终保持最新版本
@@ -287,7 +299,13 @@ docker-compose up -d
git clone https://github.com/Wei-Shaw//claude-relay-service.git
cd claude-relay-service
# 2. 设置管理员账号密码(可选
# 2. 初始化环境(重要!首次部署必须执行
touch .env # 创建空文件,防止 Docker 创建成目录
# 如果 .env 已经错误地变成了目录,先删除:
# rm -rf .env && touch .env
# 3. 设置管理员账号密码(可选)
# 方式一:自动生成(查看容器日志获取)
docker-compose up -d
@@ -296,7 +314,7 @@ export ADMIN_USERNAME=cr_admin_custom
export ADMIN_PASSWORD=your-secure-password
docker-compose up -d
# 3. 查看管理员凭据
# 4. 查看管理员凭据
# 自动生成的情况下:
docker logs claude-relay-service | grep "管理员"