# JA4 / TLS 指纹

用 TLS 握手指纹识别同一客户端，在日志、匹配器、CC 与访问控制、攻击记录里使用。

JA4 是根据客户端 TLS 握手特征计算出的指纹。同一个工具或自动化脚本换了 IP、换了 UA,握手特征通常不变,所以 JA4 适合识别隐藏身份的自动化流量。JA4 只在 HTTPS 请求上产生,由节点在握手时计算。


## 在哪里看到 JA4
- **访问日志**:日志里有 JA4 列,并提供「用该 JA4 创建匹配器」入口,直接把它变成可复用的条件。
- **攻击记录**:「安全中心 › 攻击记录」支持按 JA4 搜索,查看某个指纹带来了哪些攻击。
- **节点详情**:显示只读的「JA4 指纹」支持项,表示该节点是否具备指纹能力。

## 在哪里使用 JA4
- **CC 匹配器与访问控制条件**:条件类型里选「TLS 指纹(JA4)」,同时也可以按「请求头」匹配。
- **CC 计数维度**:CC 过滤可以按 IP、按 TLS 指纹、或按 IP + 指纹计数。
- **回放**:匹配器的「回放」会用最近 24 小时的访问日志试跑一遍,显示它会命中多少请求,上线前先看影响面。

:::warn
单独按 TLS 指纹计数(`ja4`)只能搭配“仅记录”动作。要真正拦截,请使用「IP + 指纹」(`ip_ja4`),避免多个正常用户共用同一浏览器指纹时被一起拦住。
:::

## 推荐用法
1. 在[攻击记录](https://www.gocdn888.com/zh/guide/events)里找到异常请求,从访问日志取出它的 JA4。
2. 创建匹配器,先用「回放」确认命中的请求范围合理。
3. 先以“仅记录”运行一段时间,确认没有误伤后再改成拦截,并使用「IP + 指纹」维度。

:::tip
主流浏览器的指纹会被大量正常用户共享,不要只凭 JA4 封禁;配合 IP 维度或其他条件一起使用。
:::

相关设置见[CC 防护](https://www.gocdn888.com/zh/guide/cc)与[名单与访问控制](https://www.gocdn888.com/zh/guide/lists)。