检查当前占用端口的进程

在终端运行以下命令，查找占用默认端口（通常为7860或8000）的进程：

lsof -i :7860

或使用替代命令：

netstat -tulnp | grep 7860

输出结果会显示进程ID（PID）和名称，例如python3或gunicorn。

终止冲突进程

根据查到的PID强制终止进程：

kill -9 <PID>

若需批量终止所有相关进程：

pkill -f 'port 7860'

修改默认启动端口

在llamafactory-cli命令中显式指定新端口（如改为8080）：

llamafactory-cli webui --port 8080

或在配置文件中修改server_port参数（通常位于configs/webui.yml）。

使用随机空闲端口

添加--share参数让系统自动分配空闲端口：

llamafactory-cli webui --share

验证端口释放

重启服务前确认端口已释放：

ss -tuln | grep 7860

若无输出则表示端口可用。

常见端口冲突场景

• 多实例运行：确保同一时间只有一个LLaMa-Factory的WebUI实例在运行。
• 其他应用占用：如Jupyter Notebook、FastAPI服务可能占用相同端口。
• 上次异常退出：强制关闭终端可能导致进程未正常结束。

防火墙/安全组检查

云服务器用户需检查安全组规则是否放行目标端口，本地开发可临时关闭防火墙测试：

sudo ufw disable  # Ubuntu示例