https://github.com/bogdanfinn/tls-client
net/http.Client like HTTP Client with options to select specific client TLS Fingerprints to use for requests.
https://github.com/bogdanfinn/tls-client
Last synced: about 1 month ago
JSON representation
net/http.Client like HTTP Client with options to select specific client TLS Fingerprints to use for requests.
- Host: GitHub
- URL: https://github.com/bogdanfinn/tls-client
- Owner: bogdanfinn
- License: bsd-4-clause
- Created: 2022-07-09T20:21:20.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2025-04-02T06:47:32.000Z (12 months ago)
- Last Synced: 2025-04-02T07:24:46.591Z (12 months ago)
- Language: Go
- Size: 1.08 GB
- Stars: 1,053
- Watchers: 29
- Forks: 187
- Open Issues: 31
-
Metadata Files:
- Readme: Readme.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-go - tls-client - net/http.Client like HTTP Client with options to select specific client TLS Fingerprints to use for requests. (Networking / HTTP Clients)
- awesome-go - tls-client - net/http.Client like HTTP Client with options to select specific client TLS Fingerprints to use for requests. (Networking / HTTP Clients)
- trackawesomelist - tls-client (⭐887) - net/http.Client like HTTP Client with options to select specific client TLS Fingerprints to use for requests. (Recently Updated / [Dec 24, 2024](/content/2024/12/24/README.md))
- awesome-go - bogdanfinn/tls-client
- awesome-fingerprinting - TLS Client
- awesome-go-with-stars - tls-client - 03-03 | (Networking / HTTP Clients)
- awesome-go-cn - tls-client - client) [![godoc][D]](https://godoc.org/github.com/bogdanfinn/tls-client) (网络 / HTTP客户端)
- awesome-go - tls-client - net/http.Client like HTTP Client with options to select specific client TLS Fingerprints to use for requests. Stars:`1.3K`. (Networking / HTTP Clients)
- awesome-go-plus - tls-client - net/http.Client like HTTP Client with options to select specific client TLS Fingerprints to use for requests.  (Networking / HTTP Clients)
- fucking-awesome-go - tls-client - net/http.Client like HTTP Client with options to select specific client TLS Fingerprints to use for requests. (Networking / HTTP Clients)
README
# TLS-Client
### Preface
This TLS Client is built upon https://github.com/Carcraftz/fhttp and https://github.com/Carcraftz/utls (https://github.com/refraction-networking/utls). Big thanks to
all contributors so far. Sadly it seems that the original repositories from Carcraftz are not maintained anymore.
### What is TLS Fingerprinting?
Some people think it is enough to change the user-agent header of a request to let the server think that the client
requesting a resource is a specific browser.
Nowadays this is not enough, because the server might use a technique to detect the client browser which is called TLS
Fingerprinting.
Even though this article is about TLS Fingerprinting in NodeJS it well describes the technique in general.
https://httptoolkit.tech/blog/tls-fingerprinting-node-js/#how-does-tls-fingerprinting-work
### Why is this library needed?
With this library you are able to create a http client implementing an interface which is similar to golangs net/http
client interface.
This TLS Client allows you to specify the Client (Browser and Version) you want to use, when requesting a server.
### Features
- ✅ **HTTP/1.1, HTTP/2, HTTP/3** - Full protocol support with automatic negotiation
- ✅ **Protocol Racing** - Chrome-like "Happy Eyeballs" for HTTP/2 vs HTTP/3
- ✅ **TLS Fingerprinting** - Mimic Chrome, Firefox, Safari, and other browsers
- ✅ **HTTP/3 Fingerprinting** - Accurate QUIC/HTTP/3 fingerprints matching real browsers
- ✅ **WebSocket Support** - Maintain TLS fingerprinting over WebSocket connections
- ✅ **Custom Header Ordering** - Control the order of HTTP headers
- ✅ **Proxy Support** - HTTP and SOCKS5 proxies
- ✅ **Cookie Jar Management** - Built-in cookie handling
- ✅ **Certificate Pinning** - Enhanced security with custom certificate validation
- ✅ **Bandwidth Tracking** - Monitor upload/download bandwidth
- ✅ **Language Bindings** - Use from JavaScript (Node.js), Python, and C# via FFI
### Interface
The HTTP Client interface extends the base net/http Client with additional functionality:
```go
type HttpClient interface {
GetCookies(u *url.URL) []*http.Cookie
SetCookies(u *url.URL, cookies []*http.Cookie)
SetCookieJar(jar http.CookieJar)
GetCookieJar() http.CookieJar
SetProxy(proxyUrl string) error
GetProxy() string
SetFollowRedirect(followRedirect bool)
GetFollowRedirect() bool
CloseIdleConnections()
Do(req *http.Request) (*http.Response, error)
Get(url string) (resp *http.Response, err error)
Head(url string) (resp *http.Response, err error)
Post(url, contentType string, body io.Reader) (resp *http.Response, err error)
GetBandwidthTracker() bandwidth.BandwidthTracker
GetDialer() proxy.ContextDialer
GetTLSDialer() TLSDialerFunc
}
```
### Detailed Documentation
https://bogdanfinn.gitbook.io/open-source-oasis/
### Quick Usage Example
```go
package main
import (
"fmt"
"io"
"log"
http "github.com/bogdanfinn/fhttp"
tls_client "github.com/bogdanfinn/tls-client"
"github.com/bogdanfinn/tls-client/profiles"
)
func main() {
jar := tls_client.NewCookieJar()
options := []tls_client.HttpClientOption{
tls_client.WithTimeoutSeconds(30),
tls_client.WithClientProfile(profiles.Chrome_144),
tls_client.WithNotFollowRedirects(),
tls_client.WithCookieJar(jar), // create cookieJar instance and pass it as argument
}
client, err := tls_client.NewHttpClient(tls_client.NewNoopLogger(), options...)
if err != nil {
log.Println(err)
return
}
req, err := http.NewRequest(http.MethodGet, "https://tls.peet.ws/api/all", nil)
if err != nil {
log.Println(err)
return
}
req.Header = http.Header{
"accept": {"*/*"},
"accept-language": {"de-DE,de;q=0.9,en-US;q=0.8,en;q=0.7"},
"user-agent": {"Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36"},
http.HeaderOrderKey: {
"accept",
"accept-language",
"user-agent",
},
}
resp, err := client.Do(req)
if err != nil {
log.Println(err)
return
}
defer resp.Body.Close()
log.Println(fmt.Sprintf("status code: %d", resp.StatusCode))
readBytes, err := io.ReadAll(resp.Body)
if err != nil {
log.Println(err)
return
}
log.Println(string(readBytes))
}
```
### Questions?
Join my discord support server for free: https://discord.gg/7Ej9eJvHqk
No Support in DMs!
### Appreciate my work?
[](https://www.buymeacoffee.com/CaptainBarnius)
---
## 🛡️ Need Antibot Bypass?
TLS fingerprinting alone isn't enough for modern bot protection. **[Hyper Solutions](https://hypersolutions.co?utm_source=github&utm_medium=readme&utm_campaign=tls-client)** provides the missing piece - API endpoints that generate valid antibot tokens for:
**Akamai** • **DataDome** • **Kasada** • **Incapsula**
No browser automation. Just simple API calls that return the exact cookies and headers these systems require.
🚀 **[Get Your API Key](https://hypersolutions.co?utm_source=github&utm_medium=readme&utm_campaign=tls-client)** | 📖 **[Docs](https://docs.justhyped.dev)** | 💬 **[Discord](https://discord.gg/akamai)**
---
### Powered by
[](https://jb.gg/OpenSource)