feat(widget): 优化访客在线轨迹、GeoIP与多站点渠道

2026-11-06 18:21:30 +08:00
parent 24fac1bcf1
commit 38d6fc1684
37 changed files with 1071 additions and 123 deletions
@@ -92,6 +92,7 @@ chmod +x deploy/scripts/*.sh
 | `STORAGE_PUBLIC_BASE_URL` | `https://kefu.xx.com/files` | **必须**与应用内 Nginx `/files` 一致 |
 | `HTTP_PORT` | `18080` | 宿主机映射端口；已有 Caddy 占 80 时用非 80 端口 |
 | `DB_PASSWORD` / `JWT_SECRET` / `STORAGE_*` | 强随机 | 脚本可自动生成密钥 |
+| `GEOIP_DB_PATH` | `/app/geoip/GeoLite2-City.mmdb` | 可选离线 IP 城市库；文件放到 `deploy/geoip/` |

 脚本会校验占位符是否改掉，并在 `HTTP_PORT` 已被占用时告警/退出。

@@ -161,6 +162,10 @@ STORAGE_PUBLIC_BASE_URL=https://kefu.example.com/files

 生产链路由 Caddy → 应用 Nginx → API 时，API 优先读取 `X-Forwarded-For` 最左侧地址，`X-Real-IP` 仅作为回退，因此外部访客会显示其公网地址。请保持示例反代配置中的 `X-Forwarded-For` 转发，不要在边缘代理处清空该请求头。

+城市级地区使用 `deploy/geoip/GeoLite2-City.mmdb`。
+部署脚本会自动下载并每 30 天刷新该文件；可用 `GEOIP_DB_URL` 覆盖下载源。
+下载失败时只会使用 CDN 国家头，公网 IP 通常显示“未知”。
+
 任选其一（与上一节「Caddy 共存」二选一即可）：

 1. **CLB / CDN** 终结 HTTPS，回源 CVM `HTTP_PORT`（或仍回源 Caddy）