# soul-api 域名 404 原因与解决

> 来源：soul-api/宝塔反向代理说明.txt

## 原因

域名请求先到 Nginx，若没有把请求转发到本机 8080 的 Go，或站点用了 root/静态目录，就会 404。

---

## 一、先确认 Go 是否在跑（必做）

在宝塔终端或 SSH 里执行：

```
curl -s http://127.0.0.1:8080/health
```

- 若返回 `{"status":"ok"}`：说明 Go 正常，问题在 Nginx，看下面第二步。
- 若连接被拒绝或超时：说明 8080 没在监听。去 宝塔 → Go项目管理 → soulApi → 服务状态，看是否「运行中」；看「项目日志」是否有报错。

---

## 二、Nginx 必须「整站走代理」，不能走 root

添加了反向代理仍 404，多半是：

- 站点默认有 `location / { root ...; index ...; }`，请求被当成静态文件处理，`/health` 找不到就 404；
- 或反向代理只绑在了子路径（如 `/api`），`/` 和 `/health` 没被代理。

**做法**：让 soulapi.quwanzhi.com 的**所有路径**都走 8080，不要用 root。

在宝塔：网站 → soulapi.quwanzhi.com → 设置 → 配置文件，找到该站点的 `server { ... }`，按下面两种方式之一改。

### 方式 A：只保留一个 location /（推荐）

把 server 里**原来的** `location / { ... }`（含 root、index 的那段）**删掉或注释掉**，只保留下面这一段：

```nginx
location / {
    proxy_pass http://127.0.0.1:8080;
    proxy_http_version 1.1;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}
```

保存 → 重载 Nginx（或 宝塔 里点「重载配置」）。

### 方式 B：整站用下面这一整段 server（HTTPS 示例）

若你希望整站只做反向代理、不混静态，可以把该站点的 server 块整体替换成下面内容（把 your_ssl_cert 等换成你实际的证书路径；没有 SSL 就只用 listen 80 那段）：

```nginx
server {
    listen 80;
    listen 443 ssl http2;
    server_name soulapi.quwanzhi.com;
    # SSL 证书路径按宝塔实际填写，例如：
    # ssl_certificate    /www/server/panel/vhost/cert/soulapi.quwanzhi.com/fullchain.pem;
    # ssl_certificate_key /www/server/panel/vhost/cert/soulapi.quwanzhi.com/privkey.pem;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}
```

保存并重载 Nginx。

---

## 三、改完后自测

- 本机：`curl -s https://soulapi.quwanzhi.com/health`
- 或浏览器打开：https://soulapi.quwanzhi.com/health  

应看到：`{"status":"ok"}`

- 打开 https://soulapi.quwanzhi.com/ 应看到「部署成功」页面。