检查网络连接状态

确保本地网络可以正常访问外网资源，尤其是托管CDN的域名（如cdn.jsdelivr.net）。通过命令行执行ping cdn.jsdelivr.net测试连通性，若出现超时，需排查防火墙或代理设置。

修改本地hosts文件

部分地区的CDN可能被DNS污染。手动指定可用IP地址：

• 查找cdn.jsdelivr.net的可用IP（如通过ping.gl等服务）
• 编辑/etc/hosts（Linux/macOS）或C:\Windows\System32\drivers\etc\hosts（Windows）
• 添加记录示例：
  185.199.110.153 cdn.jsdelivr.net

配置代理或镜像源

若企业网络限制访问：

• 通过环境变量设置代理（需提前启动代理服务）：
  export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
• 使用国内镜像源替换CDN链接，需修改项目中的webui.py或相关前端文件，将类似以下链接：
  https://cdn.jsdelivr.net/npm/vue@3.2.47/dist/vue.global.min.js
  替换为：
  https://unpkg.zhimg.com/vue@3.2.47/dist/vue.global.min.js

离线部署方案

彻底避免CDN依赖：

1. 下载所有前端依赖到本地
   mkdir -p static/js && wget https://cdn.jsdelivr.net/npm/vue@3.2.47/dist/vue.global.min.js -O static/js/vue.global.min.js
2. 修改HTML模板中的资源引用路径为本地相对路径：
   <script src="/static/js/vue.global.min.js"></script>
3. 确保LLaMA-Factory的静态文件配置正确指向本地目录

验证解决方案

重启webui服务后：

• 浏览器按F12打开开发者工具
• 查看Network选项卡中资源加载状态
• 若仍有404错误，检查控制台输出的具体失败URL路径

备选启动方式

临时绕过前端依赖检查：
python src/llamafactory/cli.py api --no-webui
此命令会启动纯API服务，后续可通过Postman等工具测试功能