PocketBase中如何在记录事件钩子中获取客户端IP地址

在PocketBase开发过程中，开发者经常需要在记录事件钩子中获取客户端的IP地址信息。本文将详细介绍几种可行的实现方案。

问题背景

在PocketBase的RecordEvent钩子中，默认无法直接访问HTTP请求上下文，因此无法像在RequestEvent钩子中那样直接获取客户端IP地址。这是一个常见的需求场景，特别是在需要记录用户操作来源或实现基于IP的限制功能时。

解决方案分析

方案一：通过中间件传递IP信息

开发者最初尝试使用中间件将IP信息存入请求上下文：

app.OnServe().BindFunc(func(se *core.ServeEvent) error {
    se.Router.BindFunc(func(e *core.RequestEvent) error {
        e.Request = e.Request.WithContext(context.WithValue(e.Request.Context(), "ip_address", "{{get_ip}}"))
        return e.Next()
    })
    return se.Next()
})

然后在RecordEvent钩子中尝试获取：

app.OnRecordValidate("user_votes").BindFunc(func(e *core.RecordEvent) error {
    app.Logger().Warn(fmt.Sprintf("%+v", e.Context.Value("ip_address")))
    return e.Next()
})

但这种方法不可行，因为RecordEvent钩子与请求上下文是分离的。

方案二：使用专用字段存储IP

更可靠的解决方案是在集合中添加专门的IP地址字段：

1. 首先在user_votes集合中添加ip_address字段
2. 在请求钩子中获取IP并设置到记录中：

app.OnRecordBeforeCreateRequest("user_votes").Add(func(e *core.RecordCreateEvent) error {
    ip := e.RealIP() // 获取真实IP
    e.Record.Set("ip_address", ip)
    return nil
})

3. 然后在记录钩子中通过记录字段访问：

app.OnRecordValidate("user_votes").Add(func(e *core.RecordEvent) error {
    ip := e.Record.GetString("ip_address")
    // 使用IP进行验证逻辑
    return nil
})

技术要点

1. IP获取方法：

   • RemoteIP()：获取直接连接的客户端IP
   • RealIP()：考虑代理情况，获取真实客户端IP

2. 钩子类型选择：

   • 使用RecordBeforeCreateRequest等请求相关钩子获取IP
   • 在纯记录钩子中通过字段访问

3. 安全性考虑：

   • 建议使用RealIP()方法处理反向代理场景
   • 重要操作应结合IP验证和用户认证

最佳实践

1. 对于需要IP信息的场景，建议在设计集合时就添加相应字段
2. 考虑使用组合验证方式，如IP+用户ID+时间戳等
3. 对于敏感操作，建议在请求钩子中进行初步验证

通过以上方法，开发者可以灵活地在PocketBase中实现基于IP的各种业务逻辑和安全控制。