检查默认端口占用情况

Llamafactory-cli WebUI 默认可能使用特定端口（如 7860 或 8000）。通过以下命令查看端口是否被占用：

• Linux/macOS：

  lsof -i :7860  # 替换为实际端口号
  

• Windows：

  netstat -ano | findstr :7860
  

若输出结果非空，表示端口被占用，需终止占用进程或更换端口。

更换 WebUI 监听端口

若默认端口被占用，可通过命令行参数指定新端口。启动时添加 --port 参数：

llamafactory-cli webui --port 7890  # 使用 7890 或其他空闲端口

确保新端口未被防火墙拦截，并在浏览器中访问对应地址（如 http://localhost:7890）。

验证防火墙或安全软件限制

部分系统防火墙或安全软件可能阻止端口访问：

• Linux：检查防火墙规则（如 ufw 或 iptables），临时开放端口测试：

  sudo ufw allow 7860/tcp
  

• Windows：在“Windows Defender 防火墙”中添加入站规则，允许目标端口通行。
• macOS：在“系统设置”>“网络”>“防火墙”中配置例外。

其他潜在问题

• 确保 Llamafactory-cli 版本兼容，更新至最新版本：

  pip install --upgrade llamafactory
  

• 检查日志输出获取详细错误信息：

  llamafactory-cli webui --verbose