rwadurian/backend/services/mining-admin-service
hailin 510a890b33 fix(mining-admin): 修复审计日志 IP 地址记录为内网 IP 的问题,补全全操作的 IP 审计
【根本原因】
- main.ts 缺少 `app.set('trust proxy', 1)`,Express 在 Nginx/Kong 代理后 req.ip
  返回的是代理服务器内网 IP(127.0.0.1),而非真实客户端 IP。
- Nginx 已正确设置 X-Forwarded-For / X-Real-IP,但后端从未读取这些 header。

【修复内容】

1. main.ts
   - 新增 `app.set('trust proxy', 1)`,使 Express 信任 Nginx 第一跳的
     X-Forwarded-For,req.ip 从此返回真实客户端 IP。

2. shared/utils/get-client-ip.ts(新建工具函数)
   - 优先读取 X-Forwarded-For(取逗号分隔的第一个 IP,支持多跳代理)
   - 其次读取 X-Real-IP
   - 兜底使用 req.ip
   - 全服务统一使用此函数,避免各处重复逻辑。

3. auth.controller.ts / auth.service.ts
   - LOGIN:将 req.ip 改为 getClientIp(req)(已记录 IP,修正来源)
   - LOGOUT:之前完全不记录 IP/UA,现在补全传入并存入审计日志。

4. config.service.ts / config.controller.ts
   - setConfig / deleteConfig 新增 ipAddress / userAgent 可选参数。
   - 新增 recordAuditLog 通用方法,供 Controller 记录任意审计事件。
   - 所有写操作(setTransferEnabled、setP2pTransferFee、setConfig、
     deleteConfig)均传入真实 IP 和 UA。
   - activateMining / deactivateMining 之前完全无审计日志,
     现补录 ACTIVATE / DEACTIVATE 类型的 MINING 审计条目。

5. capability-admin.service.ts / capability.controller.ts
   - setCapability / setCapabilities / writeAuditLog 均新增
     ipAddress / userAgent 参数,Controller 层传入真实 IP。

6. pre-planting-restriction.service.ts / controller
   - unlockRestriction 新增 ipAddress / userAgent 参数并写入审计日志。

7. manual-mining.service.ts / controller
   - execute 新增 ipAddress / userAgent 参数并写入审计日志。

8. batch-mining.service.ts / controller
   - execute 新增 ipAddress / userAgent 参数并写入审计日志
     (upload-execute 和 execute 两个入口均已更新)。

【影响范围】
- 仅 mining-admin-service,无数据库 Schema 变更(ipAddress/userAgent 字段已存在)。
- 所有现有接口签名向后兼容(新增参数均为可选)。

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-09 22:32:29 -07:00
..
prisma fix(mining-admin): add @map for targetType column in Notification schema 2026-03-02 08:55:00 -08:00
src fix(mining-admin): 修复审计日志 IP 地址记录为内网 IP 的问题,补全全操作的 IP 审计 2026-03-09 22:32:29 -07:00
.env.example feat(capability): 实现用户能力权限控制系统(Capability-based Permission) 2026-02-27 22:19:56 -08:00
DEVELOPMENT_GUIDE.md feat(mining-ecosystem): 添加挖矿生态系统完整微服务与前端 2026-01-10 17:45:46 -08:00
Dockerfile fix(mining-admin): Docker uploads 目录权限修复,预创建 /app/uploads 并设置 nestjs 用户所有权 2026-01-30 13:19:14 -08:00
nest-cli.json feat(mining-ecosystem): 添加挖矿生态系统完整微服务与前端 2026-01-10 17:45:46 -08:00
package-lock.json fix(mining-admin-service): 更新 package-lock.json 2026-01-28 22:17:01 -08:00
package.json fix(mining-admin-service): 添加 APK/IPA 解析依赖包 2026-01-28 22:15:43 -08:00
tsconfig.json feat(mining-ecosystem): 添加挖矿生态系统完整微服务与前端 2026-01-10 17:45:46 -08:00