项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-08 · 当前星标 ★ 1853
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Go 1.27 或更高版本(README 明确要求)
- 可访问 GitHub 与 Go module 代理(能执行 go get)
- 具备基础 Go 项目结构与编码知识
- 如需 HTTP/3/QUIC,网络环境需允许 UDP 出站
安装与启动步骤
-
1确认 Go 版本
先在终端查看当前 Go 版本,低于 1.27 需先升级,否则无法安装使用 surf。
go version -
2安装 surf 依赖
在已有的 Go 模块目录中执行 go get 拉取库,会自动写入 go.mod 依赖。
go get -u github.com/enetx/surf -
3创建带指纹客户端
用 Builder 链式构造客户端,HTTP3Settings().Grease() 开启 TLS 指纹混淆,再 Build 并 Unwrap 取回客户端。
client := surf.NewClient(). Builder(). HTTP3Settings().Grease().Set(). Build(). Unwrap() -
4调整 HTTP/2 参数
如需 HTTP/2 指纹更像浏览器,可设置头表大小、窗口大小、最大头列表等参数后再 Build。
client := surf.NewClient(). Builder(). HTTP2Settings(). HeaderTableSize(65536). EnablePush(0). InitialWindowSize(6291456). MaxHeaderListSize(262144). ConnectionFlow(15663105). Set(). Build(). Unwrap() -
5配置代理
通过 Proxy 传入 HTTP/HTTPS/SOCKS 代理地址;README 示例为单代理写法,替换成自己的地址即可。
client := surf.NewClient(). Builder(). Proxy("http://proxy.example.com:8080"). Build(). Unwrap() -
6配置自动重试
Retry 第一个参数为最大重试次数,第二个参数为每次重试的等待时间,按需调整。
client := surf.NewClient(). Builder(). Retry(3, 2*time.Second). Build(). Unwrap()
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
HTTP3Settings().Grease() | 否 | 开启 HTTP/3 指纹混淆,降低被识别概率 | HTTP3Settings().Grease().Set() |
HTTP2Settings().HeaderTableSize() | 否 | 设置 HTTP/2 头表大小,模拟浏览器指纹 | HeaderTableSize(65536) |
HTTP2Settings().InitialWindowSize() | 否 | 设置 HTTP/2 初始窗口大小 | InitialWindowSize(6291456) |
Proxy() | 否 | 指定 HTTP/HTTPS/SOCKS4/SOCKS5 代理地址 | http://proxy.example.com:8080 |
Retry() | 否 | 设置最大重试次数与重试间隔时间 | Retry(3, 2*time.Second) |
如何确认成功
执行 go build ./... 编译无报错,程序能成功构造出 surf 客户端实例。
常见问题
Q:Go 版本低于 1.27 能装吗?
A:README 要求 Go 1.27+,建议先升级 Go 工具链再执行 go get,否则可能编译失败或依赖无法解析。
Q:如何模拟 Chrome 或 Firefox 指纹?
A:surf 内置浏览器指纹模拟能力,支持 Chrome v152 与 Firefox v148,并可选择 Windows、macOS、Linux、Android、iOS 平台,具体调用方式请查阅仓库更多示例。
Q:代码片段不完整怎么用?
A:README 只给出 Builder 链式片段,你需要把它放进自己的 Go 模块和函数中,并自行补上后续发起请求的逻辑。
Q:能否自定义 JA3/JA4?
A:可以,通过 HelloID 与 HelloSpec 配置精确的 TLS 指纹,实现更细粒度的仿真与隐私控制。
Q:支持 HTTP/3 代理吗?
A:支持,代理配置包含 HTTP、HTTPS、SOCKS4、SOCKS5,并为 HTTP/3 提供 UDP 支持。
注意事项
- README 未提供完整可运行的 main 示例,需自行补全请求发送与结果处理代码。
- 不要随意使用示例里的 proxy.example.com,请替换为自己的真实代理地址。
- HTTP/3 over QUIC 依赖 UDP 出站,受限网络中可能不可用。
- 引入后请保持 Go 版本与 go.mod 中的依赖一致,避免版本冲突。
核心亮点
- 支持 JA3/JA4 TLS 指纹与 HTTP/3 QUIC 指纹仿真,覆盖主流浏览器特征
- 纯 Go 实现,无需启动 Chrome/Firefox 进程,部署轻量、性能好
- 内置 Chrome/Firefox 请求头顺序与默认值,开箱即用适配常见反爬
不足之处
- 浏览器版本更新快,指纹库需持续跟进,否则易被识别
- 文档与示例相对有限,复杂场景需阅读源码
适用场景
- Go 爬虫项目需要绕过 Cloudflare 等反爬检测
- 自动化测试中模拟真实浏览器网络行为
- API 采集与风控对抗场景下的请求伪装
替代项目
curl-impersonate、cycletls
同类项目推荐
BrowserSynth
开源
在浏览器里用代码生成三维结构艺术,实时预览并导出渲染
A browser implementation of StructureSynth with more primitives, non-uniform scaling···
manifold
开源
组建AI团队,自动搞定复杂长流程工作
Manifold is an experimental platform for enabling long horizon workflow automation u···
bua
开源
用大白话指挥浏览器,AI 帮你自动点击操作
AI-powered browser automation for Go — describe tasks in plain English, let the age···
emunium
开源
用真实系统鼠标键盘操作浏览器,交互更接近真人
Browser automation with real OS mouse and keyboard input. No WebDriver. No CDP-drive···
AITuberFlow
开源
拖拽搭建 AI 虚拟主播,实时互动直播不求人
Visual workflow editor for building AI-powered VTubers
dsh-wechat
开源
在微信里直接指挥 DSH 智能体跑自动化任务
WeChat channel for DeepSeek Harness
steel-browser
开源
一键启动浏览器沙箱,让 AI 代理轻松操控网页
Open Source Browser API for AI Agents & Apps. Steel Browser is a batteries-included ···
PSWriteOffice
开源
用 PowerShell 一条命令搞定 Word、Excel、PDF 等文档自动化
Moved to OfficeIMO. Development, releases, issues and pull requests: https://github.···
aidlc-workflows
开源
给 AI 编码代理装上工程流程,少跳步多交付
AI-Driven Life Cycle (AI-DLC) adaptive workflow steering rules for AI coding agents
