refactor: 统一 .env 配置 — 合并 backend/.env + .docker.env 到根目录

- Go 服务 godotenv.Load("../.env") → godotenv.Load("../../.env")
- ethend.sh/config.js 读取路径改为根目录 .env
- 删除 .docker.env.example 和 backend/.env.example,统一为 .env.example
- Docker compose 默认读取根 .env,无需 --env-file
- 同步更新全部文档

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
2026-05-30 10:12:54 +08:00
parent 43d256e197
commit 46441335c0
12 changed files with 49 additions and 92 deletions
+9 -9
View File
@@ -26,7 +26,7 @@
| Docker 配置 | `docker-compose*.yml`, `backend/*/Dockerfile` | 容器化部署配置 |
| Caddy 配置 | `Caddyfile` | 反向代理配置 |
| 文档 | `docs/`, `Deploy.md`, `Migration.md` | 项目文档 |
| 环境变量模板 | `backend/.env.example` | 配置参考模板 |
| 环境变量模板 | `.env.example` | 配置参考模板 |
| 脚本 | `scripts/` | 辅助脚本(migrate.sh, setup-whisper.sh 等) |
| 许可证 | `LICENSE` | 项目许可证 |
@@ -38,7 +38,7 @@
| Windows 可执行文件 | `*.exe` | 旧的 Windows 编译产物 |
| Node.js 依赖 | `node_modules/`, `frontend/web/node_modules/`, `frontend/node_modules/`, `ethend/node_modules/` | 体积大,通过 `npm install` 重新安装 |
| 前端构建产物 | `frontend/web/dist/` | 通过 `npm run build` 重新构建 |
| 敏感配置文件 | `backend/.env` | 包含 API 密钥和密码 |
| 敏感配置文件 | `.env` | 包含 API 密钥和密码 |
| 锁文件 | `package-lock.json`, `frontend/web/package-lock.json`, `frontend/package-lock.json` | 跨平台 npm 依赖树可能不同 |
| Git 内部数据 | `.git/objects`, `.git/refs`, `.git/logs` | 减小压缩包体积 |
| 日志文件 | `*.log`, `logs/`, `debug/logs/` | 运行时产物 |
@@ -56,17 +56,17 @@ cd Cyrene
git checkout dev
```
克隆完成后,手动创建 `backend/.env` 文件:
克隆完成后,手动创建 `.env` 文件:
```bash
# 在 Windows 命令行 (cmd) 中:
copy backend\.env.example backend\.env
copy .env.example .env
# 或在 PowerShell 中:
Copy-Item backend\.env.example backend\.env
Copy-Item .env.example .env
```
然后编辑 [`backend/.env`](backend/.env),填入实际的 API 密钥、数据库密码等配置值。
然后编辑 [`.env`](.env),填入实际的 API 密钥、数据库密码等配置值。
---
@@ -142,7 +142,7 @@ wsl --install -d Ubuntu-22.04
**方式 A:使用 `.env` 文件(推荐)**
项目各服务会自动读取 [`backend/.env`](backend/.env.example),将 `.env.example` 复制为 `.env` 并填入实际值即可。
项目各服务会自动读取 [`.env`](.env.example),将 `.env.example` 复制为 `.env` 并填入实际值即可。
**方式 B:命令行临时设置 (cmd)**
@@ -218,7 +218,7 @@ npm run dev
### 6.3 数据库配置
1. 确保 PostgreSQL 服务已启动
2. 创建数据库和用户(参考 [`backend/.env.example`](backend/.env.example) 中的配置):
2. 创建数据库和用户(参考 [`.env.example`](.env.example) 中的配置):
```sql
CREATE USER cyrene WITH PASSWORD 'your-password';
@@ -227,7 +227,7 @@ CREATE DATABASE cyrene_ai OWNER cyrene;
CREATE EXTENSION IF NOT EXISTS vector;
```
3. 在 [`backend/.env`](backend/.env.example) 中配置数据库连接信息。
3. 在 [`.env`](.env.example) 中配置数据库连接信息。
### 6.4 基础设施服务