一、概述
TradingAgents-CN 绿色版 发布以后，有朋友反馈启动时报错，不知道如何处理。初步排查后发现，常见原因是 绿色版默认端口 与系统中其他软件发生冲突。
遇到这种情况，可以通过修改绿色版的端口配置来解决。
本文基于 Windows 11 环境测试整理。其他 Windows 版本如果遇到差异问题，可以结合系统日志和相关工具自行排查。
二、默认端口说明
TradingAgents-CN 绿色版默认使用以下端口：
| 服务 | 默认端口 | 说明 | 配置文件 |
|---|---|---|---|
| 前端 Nginx | 80 | Web 界面访问端口 | runtime/nginx.conf |
| 后端 FastAPI | 8000 | API 服务端口 | .env |
| MongoDB | 27017 | 数据库端口 | runtime/mongodb.conf，启动时自动生成 |
| Redis | 6379 | 缓存服务端口 | runtime/redis.conf |
如果本机已经有其他程序占用了这些端口，绿色版启动时就可能报错。
三、修改前端端口，Nginx 默认 80
3.1 修改文件
需要修改：
runtime/nginx.conf3.2 修改步骤
打开配置文件：
runtime/nginx.conf找到类似配置：
server {
listen 80;
server_name localhost;将端口改为新的端口，例如 8080：
server {
listen 8080;
server_name localhost;保存文件后，重启服务：
.\stop_all.ps1
.\start_all.ps1然后访问新地址：
http://localhost:80803.3 注意事项
- 修改前请确认新端口 未被占用。
- 如果使用非标准端口，可能需要配置防火墙规则。
- 修改后建议清除浏览器缓存，或使用无痕窗口访问。
四、修改后端端口，FastAPI 默认 8000
4.1 修改文件
修改后端端口需要同时修改两个文件：
.env
runtime/nginx.conf4.2 修改 .env
打开 .env 文件，找到：
HOST=0.0.0.0
PORT=8000修改为新端口，例如 8001：
HOST=0.0.0.0
PORT=80014.3 修改 Nginx 代理配置
打开：
runtime/nginx.conf找到后端代理配置：
upstream backend {
server 127.0.0.1:8000;
}修改为新的后端端口：
upstream backend {
server 127.0.0.1:8001;
}4.4 重启并验证
保存所有文件后重启服务：
.\stop_all.ps1
.\start_all.ps1访问前端：
http://localhost如果前端端口也改成了 8080，则访问：
http://localhost:8080后端 API 文档地址：
http://localhost/docs如果前端端口改成了 8080，也可以通过：
http://localhost:8080/docs4.5 重要提示
修改后端端口时，必须同时修改：
.env：后端服务监听端口。runtime/nginx.conf：Nginx 代理目标端口。
如果只修改其中一个文件，会导致 前端无法连接后端 API。
五、修改 MongoDB 端口，默认 27017
5.1 修改方式
MongoDB 配置文件通常在启动时自动生成，因此需要修改启动脚本和 .env。
需要修改：
scripts/installer/start_services_clean.ps1
.env5.2 修改启动脚本
打开：
scripts/installer/start_services_clean.ps1找到 MongoDB 启动参数：
$mongoArgs = @(
"--dbpath","`"$mongoDbPath`"",
"--logpath","`"$mongoLogPath`"",
"--port","27017",
)将端口改为 27018：
$mongoArgs = @(
"--dbpath","`"$mongoDbPath`"",
"--logpath","`"$mongoLogPath`"",
"--port","27018",
)5.3 修改 .env
打开 .env，找到 MongoDB 配置：
MONGODB_HOST=localhost
MONGODB_PORT=27017修改为：
MONGODB_HOST=localhost
MONGODB_PORT=27018保存所有文件后重启服务：
.\stop_all.ps1
.\start_all.ps1六、修改 Redis 端口，默认 6379
6.1 修改文件
需要修改：
runtime/redis.conf
.env6.2 修改 Redis 配置
打开：
runtime/redis.conf找到端口配置：
port 6379修改为：
port 63806.3 修改 .env
打开 .env，找到 Redis 配置：
REDIS_HOST=localhost
REDIS_PORT=6379修改为：
REDIS_HOST=localhost
REDIS_PORT=6380保存所有文件后重启服务：
.\stop_all.ps1
.\start_all.ps1七、完整示例：修改所有端口
假设你希望将所有默认端口改为以下端口：
| 服务 | 原端口 | 新端口 |
|---|---|---|
| 前端 Nginx | 80 | 8080 |
| 后端 FastAPI | 8000 | 8001 |
| MongoDB | 27017 | 27018 |
| Redis | 6379 | 6380 |
7.1 修改 runtime/nginx.conf
server {
listen 8080;
server_name localhost;
}
upstream backend {
server 127.0.0.1:8001;
}7.2 修改 .env
HOST=0.0.0.0
PORT=8001
MONGODB_HOST=localhost
MONGODB_PORT=27018
REDIS_HOST=localhost
REDIS_PORT=63807.3 修改 scripts/installer/start_services_clean.ps1
"--port","27018",7.4 修改 runtime/redis.conf
port 63807.5 重启服务
.\stop_all.ps1
.\start_all.ps17.6 访问新地址
http://localhost:8080八、检查端口占用
8.1 PowerShell 检查指定端口
检查 80 端口：
Get-NetTCPConnection -LocalPort 80 -State Listen检查 8000 端口：
Get-NetTCPConnection -LocalPort 8000 -State Listen检查 27017 端口：
Get-NetTCPConnection -LocalPort 27017 -State Listen检查 6379 端口：
Get-NetTCPConnection -LocalPort 6379 -State Listen8.2 查看所有监听端口
netstat -ano | findstr LISTENING查看特定端口，例如 80：
netstat -ano | findstr :80如果端口被占用，可以根据显示的 PID 在任务管理器中定位进程。
九、常见问题
Q1：修改端口后无法访问怎么办？
请检查：
- 所有相关配置文件是否都已修改。
- 服务是否已经重启。
- 新端口是否被其他程序占用。
- 防火墙是否阻止了新端口。
- 是否需要清除浏览器缓存。
建议查看日志：
logs/nginx_error.log
logs/backend_error.logQ2：前端可以访问，但 API 调用失败怎么办？
这通常是因为后端端口配置不一致。
常见情况：
.env中的后端端口已经修改。- 但
runtime/nginx.conf中的upstream backend端口没有修改。
解决方法：确保两个文件中的后端端口一致。
例如：
PORT=8001对应：
upstream backend {
server 127.0.0.1:8001;
}Q3：修改后服务无法启动怎么办？
请检查：
- 新端口是否被其他程序占用。
nginx.conf语法是否正确。.env配置是否填写正确。- MongoDB 和 Redis 端口是否同步修改。
建议查看日志：
logs/nginx_error.log
logs/backend_startup.logQ4：如何恢复默认端口？
可以重新解压绿色版压缩包，或手动改回默认值：
| 服务 | 默认端口 |
|---|---|
| 前端 Nginx | 80 |
| 后端 FastAPI | 8000 |
| MongoDB | 27017 |
| Redis | 6379 |
对应配置：
PORT=8000
MONGODB_PORT=27017
REDIS_PORT=6379runtime/nginx.conf：
listen 80;
upstream backend {
server 127.0.0.1:8000;
}runtime/redis.conf：
port 6379十、技术支持
如果遇到问题，请先查看日志文件：
logs/nginx_error.log
logs/backend_error.log
logs/tradingagents.log也可以运行诊断脚本：
.\diagnose.ps1如需进一步反馈问题，可以提交 Issue，或加入 QQ 群：
935349777反馈时建议附上：
- 错误截图。
- 日志文件内容。
- 修改后的配置文件内容。
- 当前系统版本和端口占用情况。
十一、总结
TradingAgents-CN 绿色版 默认会使用 Nginx 80 端口、FastAPI 8000 端口、MongoDB 27017 端口 和 Redis 6379 端口。如果这些端口被系统中其他软件占用，就可能导致启动失败。
解决思路是：
- 前端端口修改
runtime/nginx.conf。 - 后端端口同时修改
.env和runtime/nginx.conf。 - MongoDB 端口同时修改启动脚本和
.env。 - Redis 端口同时修改
runtime/redis.conf和.env。 - 修改后必须重启所有服务。
按照本文步骤配置后，大多数端口冲突问题都可以顺利解决。
✅ 官方唯一渠道：📦 GitHub 仓库：https://github.com/hsliuping/TradingAgents-CN
Aekor AI-API 中转站，让全球顶尖 AI 大模型“触手可及”！你是否曾为这些烦恼头疼？
🔹 人在国内，却总被海外官网 API 的高延迟、掉线、甚至无法访问困扰？
🔹 想用最强的 GPT、Claude 等模型，却卡在海外信用卡、支付审核等重重阻碍？
🔹 官方 API 太贵？Aekor 为你打通“网络-支付-成本”的任督二脉！
💡 Aekor 核心价值：好用、便宜、快 💡
🚀 高速稳定，告别掉线国内专线加速，API 响应低延迟，告别「转圈圈」的焦虑，开发效率瞬间拉满！
🧠 顶尖模型，随需而调涵盖 GPT 系列、Claude 系列等全球主流大厂模型，一次接入，轻松调用！
🎁 免费白嫖，诚意拉满！
注册即送 20 美元体验额度，够你狠狠测试一轮模型质量与线路稳定性了！
⚠️ 温馨提示：API 中转市场虽多但良莠不齐（甚至有些会偷工减料换小模型糊弄事儿）。Aekor 坚持提供正版稳定的服务，但还是建议：先用免费的 20 刀测试是否契合自身需求，满意了再小额充值上车，理性消费不盲目。
文章评论