```
Some checks failed
构建并部署 AI Agent 服务 / deploy (push) Failing after 1m17s

docs(quickstart): 更新快速开始文档以支持Nginx反向代理配置

- 修改环境变量配置方式,从直接创建.env文件改为复制模板文件
- 添加必需和可选配置项的详细说明
- 更新Docker Compose启动命令以使用正确的路径
- 增加Nginx反向代理访问方式的说明
- 为本地开发模式添加额外的数据库配置说明

fix(readme): 修正部署说明中的环境变量配置方法

- 将硬编码的环境变量配置改为使用模板文件复制方式
- 更新Docker Compose启动命令路径
- 补充Nginx反向代理访问说明
- 修正数据库配置注意事项

feat(backend): 支持从环境变量读取数据库连接配置

- 添加os模块导入
- 修改DB_URI配置逻辑,优先从环境变量读取
- 适配Docker和本地开发环境的不同数据库连接地址

refactor(docker): 优化Docker Compose配置支持Nginx代理

- 限制后端端口仅本机访问
- 修改前端API URL为相对路径,通过Nginx代理访问
- 限制前端端口仅本机访问

refactor(frontend): 适配Nginx反向代理后端API调用

- 将硬编码的后端API地址改为相对路径
- 支持通过Nginx代理转发请求到后端服务

chore(scripts): 更新启动脚本中的访问地址提示信息

- 修改前端启动成功后的访问地址提示
- 添加Nginx代理访问方式的说明
```
This commit is contained in:
2026-04-14 01:44:55 +08:00
parent 93ec2b5b8e
commit ebbd73ddf0
7 changed files with 93 additions and 24 deletions

View File

@@ -13,20 +13,32 @@
#### 1. 配置环境变量
```bash
cat > .env << EOF
ZHIPUAI_API_KEY=your_zhipuai_api_key_here
VLLM_LOCAL_KEY=token-abc123
EOF
# 复制模板文件
cp .env.example .env
# 编辑 .env 文件,填入真实的 API Key
vim .env # 或使用你喜欢的编辑器
```
**必需配置项**
- `ZHIPUAI_API_KEY` - 智谱 AI API 密钥(从 [智谱开放平台](https://open.bigmodel.cn/) 获取)
- `VLLM_LOCAL_KEY` - 本地 vLLM 服务认证 Token与 vLLM 容器的 `--api-key` 参数一致)
**可选配置项**
- `DB_URI` - PostgreSQL 连接字符串(默认已配置,通常无需修改)
#### 2. 启动服务
```bash
docker compose up -d --build
docker compose -f docker/docker-compose.yml up -d --build
```
#### 3. 访问应用
**如果配置了 Nginx 反向代理**
- 访问地址:`http://your-domain.com``http://your-server-ip`
**如果未配置 Nginx直接访问容器**
- **前端**: http://localhost:8501
- **后端 API**: http://localhost:8001
@@ -77,10 +89,21 @@ pip install -r requirement.txt
#### 3. 配置环境变量
编辑 `.env` 文件:
复制并编辑 `.env` 文件:
```bash
cp .env.example .env
vim .env
```
**本地开发需要额外配置数据库连接**
```env
ZHIPUAI_API_KEY=your_api_key_here
VLLM_LOCAL_KEY=token-abc123
# 本地开发时,数据库主机改为 localhost
DB_URI=postgresql://postgres:mysecretpassword@localhost:5432/langgraph_db?sslmode=disable
```
#### 4. 启动服务
@@ -95,7 +118,7 @@ python backend.py
streamlit run frontend.py
```
浏览器自动打开 http://localhost:8501
浏览器自动打开前端页面(如果配置了 Nginx访问 `http://your-domain.com`;否则访问 http://localhost:8501
---