Tolan/backend/端口配置说明.md

后端端口配置说明

问题修复

已修复端口配置不生效的问题。现在环境变量可以正常读取。

.env 文件配置

在 backend/ 目录创建 .env 文件：

开发环境

# 服务器配置（大小写敏感）
HOST=0.0.0.0
PORT=8000

# API密钥
DASHSCOPE_API_KEY=your_key
DOUBAO_API_KEY=your_key
DOUBAO_APP_ID=your_id

生产环境（Nginx代理）

# 监听本地8766端口（对应Nginx配置）
HOST=127.0.0.1
PORT=8766

# 不需要配置SSL（Nginx管理）
SSL_KEYFILE=
SSL_CERTFILE=

# API密钥
DASHSCOPE_API_KEY=your_key
DOUBAO_API_KEY=your_key
DOUBAO_APP_ID=your_id

重要提示

1. 变量名大小写敏感：必须使用大写 PORT，不能是 port
2. .env 文件位置：必须在 backend/ 目录下

3. 无需引号：环境变量值不需要加引号 ```bash

   正确

   PORT=8766

# 也可以（但不必要） PORT="8766"

## 验证配置

启动后端时会显示读取到的配置：

==================================================

Tolan 后端服务启动

主机: 127.0.0.1 端口: 8766 ⚠️ SSL证书不存在 将以HTTP模式启动

访问地址: HTTP: http://127.0.0.1:8766

WebSocket: ws://127.0.0.1:8766/ws

如果显示的端口仍然是 8000，检查：
- `.env` 文件是否在 `backend/` 目录
- 变量名是否为大写 `PORT`
- 重启后端服务

## 配置模板

复制以下内容到 `backend/.env`：

```bash
# ========== 服务器配置 ==========
HOST=127.0.0.1
PORT=8766

# ========== SSL证书配置 ==========
SSL_KEYFILE=
SSL_CERTFILE=

# ========== API密钥 ==========
DASHSCOPE_API_KEY=
DOUBAO_API_KEY=
DOUBAO_APP_ID=

# ========== 其他配置 ==========
CORS_ALLOW_ALL=true

然后填入实际的API密钥即可。