llamafactory-cli webui 启动后无法访问?LLaMa-Factory 部署中的 IP 绑定错误排查与修改
·
检查 IP 绑定配置
确保 webui.py 或相关配置文件中绑定的 IP 地址正确。默认情况下,LLaMa-Factory 可能绑定到 127.0.0.1(仅限本地访问)。如需允许外部访问,需修改为 0.0.0.0。查找以下类似代码片段:
app.run(host="0.0.0.0", port=7860)
验证端口占用
确认端口未被其他进程占用。使用以下命令检查端口状态(Linux/macOS):
netstat -tulnp | grep 7860
若端口被占用,可修改 webui.py 中的端口号或终止占用进程。
防火墙设置
检查防火墙是否阻止了端口访问。在 Linux 系统中,可能需要开放端口:
sudo ufw allow 7860
Windows 用户需在防火墙设置中添加入站规则。
检查网络接口
确保服务器绑定的网络接口正确。在云服务器环境中,可能需要绑定公网 IP 或配置安全组规则。通过以下命令查看可用接口:
ip a
容器化部署问题
若使用 Docker 运行,确保端口映射正确。检查 docker run 命令是否包含 -p 7860:7860 参数,且容器内部绑定的 IP 为 0.0.0.0。
日志分析
查看 LLaMa-Factory 的启动日志,定位具体错误。日志通常包含绑定失败的详细原因。通过以下命令实时查看日志:
tail -f logs/webui.log
代理配置冲突
若系统配置了网络代理,可能导致本地服务无法访问。尝试临时关闭代理或检查代理设置是否拦截了本地流量。
多网卡环境处理
在多网卡服务器中,明确指定绑定的网卡 IP。在 webui.py 中修改 host 参数为具体网卡 IP:
app.run(host="192.168.1.100", port=7860)
更多推荐


所有评论(0)