AI-Video/docs/port-configuration.md

端口配置说明

默认端口

服务	默认端口	说明
FastAPI 后端	8000	API 服务和文档
Next.js 编辑器	3000	时间轴编辑器
Streamlit Web UI	8501	Web 界面

自定义端口

方式 1: 环境变量（临时）

# 自定义所有端口
API_PORT=8080 EDITOR_PORT=3001 WEB_PORT=8502 ./dev.sh

# 只自定义部分端口
API_PORT=8080 ./dev.sh

方式 2: .env 文件（持久）

1. 复制示例配置文件：

   cp .env.example .env
   

2. 编辑 .env 文件，修改端口：

   API_PORT=8080
   EDITOR_PORT=3001
   WEB_PORT=8502
   

3. 启动服务：

   ./dev.sh
   

注意事项

1. 端口冲突：确保选择的端口没有被其他程序占用
2. 防火墙：如需外部访问，请配置防火墙规则
3. 前端重建：修改端口后，Next.js 前端会自动重建（首次启动较慢）

验证端口配置

启动后访问以下地址确认服务正常：

• API 文档: http://localhost:{API_PORT}/docs
• 编辑器: http://localhost:{EDITOR_PORT}
• Web UI: http://localhost:{WEB_PORT}