chris124567/cfsolve

选用指南

AI 根据 README 整理 · 2026/10/31 18:21:47

使用方式

提供命令行工具和 Rust 库两种使用方式。命令行通过 challenge 命令解决小部件或挑战页面，库则通过 API 调用。

查看 README 依据

You need the Rust version pinned in `rust-toolchain.toml`, plus CMake, a C/C++ compiler, libclang, and Git (to patch and build BoringSSL). ```sh cargo build --release --bin challenge ``` ## Command line tool ```sh ./target/release/challenge --page 'https://example.com/login' /tmp/solve \ --solve --fingerprint profiles/safari-26-ios.json ``` On success it prints the token (or `cf_clearance=...`) and sends progress to stderr. The directory argument holds all requests and responses for debugging, so it must be empty or not exist yet.

| `--proxy <url>` | Send every request through an `http://`, `https://`, `socks5://`, or `socks5h://` proxy. Put credentials in the URL, as in `socks5h://user:password@host:1080`. | | `-h`, `--help` | Show help. | ## Library Add cfsolve as a path dependency and copy its `[patch]` section, since Cargo only reads patches from the top-level `Cargo.toml`: ```toml [dependencies] cfsolve = { path = "/path/to/cfsolve", default-features = false } tokio = { version = "1", features = ["macros", "rt-multi-thread"] } [patch.crates-io] btls-sys = { path = "/path/to/cfsolve/vendor/btls-sys" }

部署要求

需要 Rust 版本（由 rust-toolchain.toml 指定）、CMake、C/C++ 编译器、libclang 和 Git。

查看 README 依据

You need the Rust version pinned in `rust-toolchain.toml`, plus CMake, a C/C++ compiler, libclang, and Git (to patch and build BoringSSL). ```sh cargo build --release --bin challenge ``` ## Command line tool ```sh ./target/release/challenge --page 'https://example.com/login' /tmp/solve \ --solve --fingerprint profiles/safari-26-ios.json ``` On success it prints the token (or `cf_clearance=...`) and sends progress to stderr. The directory argument holds all requests and responses for debugging, so it must be empty or not exist yet.

已知限制

目前仅支持 Safari 和 Chrome(ium) 配置文件类型。发送 cf_clearance cookie 时必须使用与配置文件相同的 IP 地址和用户代理，否则 Cloudflare 会拒绝。

查看 README 依据

included: `profiles/safari-26-ios.json` (Safari on iPhone). Each profile references recorded responses to the challenge's browser checks, stored as JSON in a directory. Keep each profile with its directory when you copy. Producing these files requires some manual (or AI) effort though it can be greatly aided by solving challenges in a real web browser with the proxy set to the address of a running `capture-proxy`, which records the decoded payloads sent to Cloudflare. Currently only Safari and Chrome(ium) profile types are supported. ## Building

as the profile, or Cloudflare will reject it. ### Turnstile with a sitekey or your own HTML `PageSource::Navigate` fetches the page. With only a URL and sitekey, use `PageSource::Blank` and specify the widget: ```rust use cfsolve::{PageSource, Turnstile, Widget}; let turnstile = Turnstile { url: "https://example.com/login".parse()?, page: PageSource::Blank, widget: Some(Widget { sitekey: "SITEKEY".into(), action: Some("login".into()), cdata: None, }), }; let token = browser.solve_turnstile(turnstile, &options).await?; ```