surf

环境要求

• Go 1.27 或更高版本（README 明确要求）
• 可访问 GitHub 与 Go module 代理（能执行 go get）
• 具备基础 Go 项目结构与编码知识
• 如需 HTTP/3/QUIC，网络环境需允许 UDP 出站

安装与启动步骤

1. 1确认 Go 版本

   先在终端查看当前 Go 版本，低于 1.27 需先升级，否则无法安装使用 surf。

   go version

   复制

2. 2安装 surf 依赖

   在已有的 Go 模块目录中执行 go get 拉取库，会自动写入 go.mod 依赖。

   go get -u github.com/enetx/surf

   复制

3. 3创建带指纹客户端

   用 Builder 链式构造客户端，HTTP3Settings().Grease() 开启 TLS 指纹混淆，再 Build 并 Unwrap 取回客户端。

   client := surf.NewClient().
       Builder().
       HTTP3Settings().Grease().Set().
       Build().
       Unwrap()

   复制

4. 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. 5配置代理

   通过 Proxy 传入 HTTP/HTTPS/SOCKS 代理地址；README 示例为单代理写法，替换成自己的地址即可。

   client := surf.NewClient().
       Builder().
       Proxy("http://proxy.example.com:8080").
       Build().
       Unwrap()

   复制

6. 6配置自动重试

   Retry 第一个参数为最大重试次数，第二个参数为每次重试的等待时间，按需调整。

   client := surf.NewClient().
       Builder().
       Retry(3, 2*time.Second).
       Build().
       Unwrap()

   复制

关键配置

如何确认成功

执行 go build ./... 编译无报错，程序能成功构造出 surf 客户端实例。

常见问题

注意事项

• README 未提供完整可运行的 main 示例，需自行补全请求发送与结果处理代码。
• 不要随意使用示例里的 proxy.example.com，请替换为自己的真实代理地址。
• HTTP/3 over QUIC 依赖 UDP 出站，受限网络中可能不可用。
• 引入后请保持 Go 版本与 go.mod 中的依赖一致，避免版本冲突。