检查 Nginx 服务状态

确保 Nginx 服务正在运行。执行以下命令检查状态：

systemctl status nginx

若服务未运行，启动 Nginx：

sudo systemctl start nginx

若启动失败，查看日志定位问题：

journalctl -u nginx -xe

验证 Nginx 配置文件语法

检查 Nginx 配置文件的语法是否正确：

sudo nginx -t

若输出显示语法错误，需修正配置文件（通常位于 /etc/nginx/nginx.conf 或 /etc/nginx/sites-available/ 下的自定义配置）。

检查反向代理配置

确保 Nginx 反向代理配置正确指向 LLaMa-Factory 的 WebUI 服务（默认端口为 7860）。示例配置如下：

server {
    listen 80;
    server_name your_domain_or_ip;

    location / {
        proxy_pass http://127.0.0.1:7860;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

替换 your_domain_or_ip 为实际域名或服务器 IP。保存后重新加载配置：

sudo systemctl reload nginx

检查端口冲突与防火墙

确认 7860 端口未被其他进程占用：

sudo netstat -tulnp | grep 7860

若存在冲突，停止占用进程或修改 LLaMa-Factory 的 WebUI 端口。

确保防火墙允许 HTTP（80）和 WebUI 服务端口（如 7860）的流量：

sudo ufw allow 80/tcp
sudo ufw allow 7860/tcp
sudo ufw reload

验证 LLaMa-Factory WebUI 服务

确保 LLaMa-Factory 的 WebUI 服务已启动并监听正确端口。手动启动服务：

llamafactory-cli webui --port 7860

检查服务日志是否有错误输出。

检查域名解析（若使用域名）

若配置了域名，确保域名已正确解析到服务器 IP。使用以下命令测试：

ping your_domain
nslookup your_domain

排查 SSL 配置（可选）

若启用 HTTPS，确保证书路径正确且 SSL 配置无误。示例 SSL 配置片段：

server {
    listen 443 ssl;
    server_name your_domain;
    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;
    # 其他 SSL 参数...
    location / {
        proxy_pass http://127.0.0.1:7860;
        # 代理头设置...
    }
}

查看浏览器控制台与网络请求

通过浏览器开发者工具（F12）查看控制台错误和网络请求状态码，定位前端或代理层问题。

重启相关服务

依次重启 LLaMa-Factory 和 Nginx 服务：

sudo systemctl restart nginx
# 重新启动 LLaMa-Factory WebUI