TransformerLab项目：如何修改默认服务端口配置

在TransformerLab项目中，默认情况下API服务会使用8000端口运行。这个设计在实际使用中可能会遇到端口冲突问题，特别是当用户本地环境中已经有其他服务（如Portainer）占用了8000端口时。本文将详细介绍TransformerLab项目中端口配置的工作原理以及如何修改默认端口。

端口配置的现状分析

TransformerLab的核心服务是通过调用transformerlab-api项目中的run.sh脚本来启动的。当前实现存在以下特点：

1. 默认情况下脚本会固定使用8000端口
2. 虽然run.sh脚本支持通过-p参数指定端口号（如run.sh -p 8001），但项目代码中多处硬编码了对8000端口的引用
3. 动态修改端口需要同步调整多个代码位置的配置

端口修改方案

临时解决方案

项目团队已经采取了以下改进措施：

1. 将默认端口从8000改为8338，减少常见端口冲突的可能性
2. 提供了手动修改端口的方法，用户可以通过编辑相关配置文件来指定自定义端口

技术实现细节

端口配置主要涉及以下技术组件：

1. Uvicorn服务器：作为ASGI服务器负责运行Python应用
2. Shell脚本启动：通过run.sh脚本封装启动逻辑
3. 应用层配置：需要确保所有API调用端点使用一致的端口号

最佳实践建议

对于需要自定义端口的用户，建议采用以下方法：

1. 在开发环境中，可以通过修改run.sh调用方式直接指定端口
2. 在生产部署时，建议使用环境变量或配置文件统一管理端口配置
3. 当修改端口后，需要确保所有依赖服务（如前端界面）的调用地址同步更新

未来改进方向

项目团队正在考虑以下增强功能：

1. 实现端口自动检测功能，当默认端口被占用时自动选择可用端口
2. 提供统一的配置界面，允许用户通过图形界面修改服务端口
3. 重构代码结构，消除对固定端口的硬编码依赖

通过以上改进，TransformerLab项目将提供更灵活的端口配置能力，满足不同部署环境的需求。