GeeTest v4 di C#: GeetestV4Async dan IHttpClientFactory

geetest v4 in c# - GeeTest v4 in C#: GeetestV4Async and IHttpClientFactory

Untuk memakai GeeTest v4 di C#, baca satu captcha_id publik dari halaman, panggil GeetestV4Async dari paket NuGet CapSkip satu kali untuk setiap pengiriman formulir, dan kirim lima nilai yang dikembalikannya dengan nama aslinya. Artikel ini membangunnya sebagai host konsol .NET kecil. HttpClient bertipe dari IHttpClientFactory berbicara dengan situs, satu CapSkipClient berbicara dengan solver di PC Windows Anda sendiri, dan sebuah semaphore mencegah satu batch pengiriman memecahkan semuanya sekaligus. Sisi produknya ada di halaman pemecah GeeTest v4 tersebut, dan tidak ada biaya per pemecahan.

Apa yang Anda butuhkan

  • Build CapSkip yang mencantumkan GeeTest v4, berjalan di PC Windows. Ikuti panduan penyiapan untuk menjalankannya. Saya tidak dapat memeriksa versi aplikasi yang saya pakai, karena aplikasinya tidak merespons di PC ini.
  • SDK .NET 8 atau lebih baru dan paket CapSkip 1.8.0 atau lebih baru, rilis pertama dengan GeetestV4Async (entri changelog bertanggal 2026-11-16). Paket itu sendiri menargetkan .NET Standard 2.0, tetapi contoh di bawah memakai sintaks C# 12 dan paket Microsoft.Extensions, jadi saya hanya menjalankannya di net8.0 dan net10.0. Di sini hanya SDK 10.0.100 yang terpasang, jadi net8.0 dibuild dengan mengubah baris TargetFramework dan dijalankan di runtime 8.0.
  • Halaman yang boleh Anda otomatisasi dan menampilkan widget GeeTest v4, beserta alamat formulir tujuan pengirimannya.
  • Sebuah alamat untuk CapSkip. Pada mode Local, hanya PC yang menjalankannya yang dapat menjangkau 127.0.0.1. Mode Server membuat API dapat dijangkau dari mesin lain juga, dan panduan penyiapan menjelaskan kedua mode di bawah pengaturan koneksi.

Saya tidak dapat menjangkau aplikasi CapSkip yang berjalan saat menguji, jadi tidak ada pemecahan sungguhan yang berjalan dan tidak ada situs sungguhan yang dihubungi. Semua hasil di bawah berasal dari mock buatan saya yang memerankan in.php, res.php, dan sebuah situs dengan formulir komentar. Mock itu mengikuti referensi API SDK, dan aturan situsnya adalah buatan saya, bukan milik GeeTest. Jika sebuah pernyataan bertumpu pada dokumentasi atau pembacaan kode sumber SDK, saya menyebutkannya.

Langkah 1: buat host dan klien bertipe untuk situs

Buat folder proyek dan instal ketiga paket. Saya hanya menguji net8.0 dan net10.0.

dotnet new console -o GeetestWorker
cd GeetestWorker
dotnet add package CapSkip
dotnet add package Microsoft.Extensions.Hosting
dotnet add package Microsoft.Extensions.Http

Hanya di net8.0, ganti dua perintah terakhir dengan yang dipatok versinya ini. Paket 11.0.0 terbaru dapat dibuild di net8.0 tetapi mencetak peringatan framework tidak didukung untuk setiap paket, dan versi yang dipatok dibuild tanpa peringatan apa pun.

# Only on net8.0: use these instead of the two Microsoft.Extensions lines above.
dotnet add package Microsoft.Extensions.Hosting --version 8.0.1
dotnet add package Microsoft.Extensions.Http --version 8.0.1

Tiga blok C# berikutnya adalah file untuk folder proyek, dan masing-masing diawali dengan nama filenya. Simpan sesuai urutan yang ditunjukkan. Yang terakhir, Program.cs, menggantikan file yang dibuat oleh template.

Klien bertipe hanya milik situs target. Menurut kode sumber SDK, CapSkipClient membangun HttpClient statisnya sendiri secara internal dan tidak memiliki constructor yang menerima milik Anda, jadi IHttpClientFactory hanya membantu panggilan Anda sendiri dan tidak lebih. SiteClient mengerjakan dua tugas: membaca captcha_id, dan mengirim formulir.

// SiteClient.cs
using System.Text.RegularExpressions;
using CapSkip;

// The typed client talks to the target site only. CapSkipClient has its own HttpClient.
public sealed class SiteClient(HttpClient http)
{
    // Finds captchaId with either quote style, however deeply the call is nested.
    static readonly Regex IdPattern = new(@"captchaId[""']?\s*:\s*[""']([0-9a-fA-F]{32})[""']");

    public async Task<string> ReadCaptchaIdAsync(string pageUrl, CancellationToken ct)
    {
        var html = await http.GetStringAsync(pageUrl, ct);
        var m = IdPattern.Match(html);
        return m.Success ? m.Groups[1].Value : throw new InvalidOperationException("no captchaId on " + pageUrl);
    }

    // The five values go back under GeeTest's own names. "text" is this form's field.
    public async Task<string> PostAsync(string pageUrl, string formUrl, SolveResult r, string text, CancellationToken ct)
    {
        using var form = new FormUrlEncodedContent(new Dictionary<string, string>
        {
            ["captcha_id"] = r.GeetestCaptchaId!,
            ["lot_number"] = r.LotNumber!,
            ["pass_token"] = r.PassToken!,
            ["gen_time"] = r.GenTime!,
            ["captcha_output"] = r.CaptchaOutput!,
            ["text"] = text,
        });
        using var request = new HttpRequestMessage(HttpMethod.Post, formUrl) { Content = form };
        request.Headers.Referrer = new Uri(pageUrl);  // many frameworks check it on a form post
        using var response = await http.SendAsync(request, ct);
        return $"{(int)response.StatusCode} {await response.Content.ReadAsStringAsync(ct)}";
    }
}

GeeTest v4 tidak punya challenge yang harus diambil per request, berbeda dengan alur v3 di artikel GeeTest v3 di C#. Halaman meneruskan satu id, sama untuk setiap pengunjung, ke initGeetest4 sebagai captchaId, jadi Anda membacanya sekali lalu memakainya kembali. Jika halaman membangun pemanggilan itu saat runtime, dokumentasi SDK menunjuk parameter query captcha_id pada request ke gcaptcha4.geetest.com/load di tab Network browser. Regular expression itu cocok dengan tiga halaman mock seperti yang saya harapkan: pemanggilan dengan tanda kutip ganda, pemanggilan dengan tanda kutip tunggal yang bersarang di dalam dua objek, dan halaman tanpa id, yang melempar InvalidOperationException.

Dua detail klien berasal dari proses nyata. Factory mem-pool message handler-nya, dan handler default menyimpan satu cookie jar untuk setiap request: pada tiga GET, yang kedua dan ketiga membawa cookie yang ditetapkan respons sebelumnya. Dengan UseCookies diatur false, seperti di Program.cs di bawah, tidak ada yang membawanya (mock, net10.0 dan net8.0). Jika formulir Anda membutuhkan cookie sesi dari halaman, baca Set-Cookie per pengiriman dan kirimkan kembali sendiri. HttpClient juga tidak menambahkan Referer dengan sendirinya: setelah baris itu dihapus, mock melihat header kosong, itulah sebabnya kode mengaturnya.

Langkah 2: satu pemecahan per pengiriman

GeetestV4Async menerima captcha_id, alamat halaman, dictionary opsi opsional, dan sebuah CancellationToken. Ia mengembalikan SolveResult. Class di bawah adalah unit yang memecahkan lalu mengirim, dan SemaphoreSlim bernilai tiga membatasi berapa banyak pemecahan yang berjalan sekaligus. Pilih angka yang sanggup ditangani PC CapSkip Anda, karena tiga hanyalah pengaturan mock saya.

// Submitter.cs
using CapSkip;

public sealed class Submitter(CapSkipClient solver, SiteClient site)
{
    // At most 3 solves in flight. Size this to what your CapSkip PC can take.
    readonly SemaphoreSlim gate = new(3);

    public async Task<string> SubmitAsync(string captchaId, string pageUrl, string formUrl, string text, CancellationToken ct)
    {
        SolveResult result;
        await gate.WaitAsync(ct);
        try
        {
            // One solve per submission: this result is used for one form post and dropped.
            result = await solver.GeetestV4Async(captchaId, pageUrl, cancellationToken: ct);
        }
        finally { gate.Release(); }

        // The site decides whether an offline pass counts, so do not send it blindly.
        if (result.IsOffline == true) return "offline pass, not sent";
        return await site.PostAsync(pageUrl, formUrl, result, text, ct);
    }
}

Hasilnya membawa lima nilai sebagai GeetestCaptchaId, LotNumber, PassToken, GenTime, dan CaptchaOutput, semuanya string. Yang pertama bukan CaptchaId karena nama itu sudah dipakai sebagai id yang diberikan CapSkip pada pemecahan (mock membagikan 9101 ke atas), yang dijelaskan changelog. Code menyimpan string JSON mentah yang dikirim API, dan pada proses mock, Token dan Challenge bernilai null, karena keduanya milik tipe lain.

Mengapa memecahkan per pengiriman? Contoh SDK sendiri menyarankan memecahkan lagi untuk setiap pengiriman, dan mock saya memberlakukannya: mengirim satu hasil dua kali mendapat 403 dengan isi yang menyatakan pass token sudah dipakai. Itu aturan mock. Halaman validasi server GeeTest yang saya baca tidak menyebut apakah sebuah pass bisa dipakai dua kali, jadi ikuti saran SDK. Dokumentasi CapSkip juga menyarankan agar mengirim dengan segera, dan halaman GeeTest menyatakan pass_token yang kedaluwarsa gagal divalidasi, yang merupakan alasan lebih kuat untuk memecahkan per pengiriman.

Siapa yang memeriksa hasilnya? Server milik situs itu sendiri. Menurut dokumentasi validasi server GeeTest (halaman itu berbahasa Mandarin), server itu mengirim lot_number, captcha_output, pass_token, dan gen_time ke GeeTest, ditambah captcha_id dan sign_token, yaitu HMAC-SHA256 dari lot_number yang dibuat dengan private key situs. CapSkip tidak pernah melihat kunci itu, dan kode Anda tidak membutuhkannya.

IsOffline adalah bool nullable. Menurut dokumentasi, nilainya true ketika GeeTest tidak dapat dijangkau dan widget-nya meloloskan tanpa challenge, dan situs kemudian memutuskan apakah akan menerimanya. SDK membaca true, kata true dalam huruf besar atau kecil apa pun, dan angka bukan nol sebagai true, nol dan kata false sebagai false, dan apa pun yang tidak dapat dibacanya sebagai null (jawaban mock, keenam bentuk). Kode di atas melewati pass offline. Jika situs Anda menerimanya, hapus baris itu.

Kedua opsi bersifat opsional. Potongan kode ini menggantikan pemanggilan GeetestV4Async di Submitter.cs:

// Snippet, not a file: replace the GeetestV4Async call in Submitter.cs with this one.
result = await solver.GeetestV4Async(captchaId, pageUrl, new Dictionary<string, object?>
{
    ["risk_type"] = "slide",
    ["proxy"] = new Proxy("HTTP", "login:[email protected]:8080"),
}, ct);

Menurut dokumentasi, risk_type menerima salah satu dari sepuluh nilai: slide, icon, nine, word, phrase, match, winlinze, svg_seed, svg_icon, dan ai. GeeTest hanya menerapkan salah satunya jika situs mengizinkan pemanggil memilih. SDK tidak memeriksa nilainya: ia memangkas spasi, membuang nilai kosong, dan mengirim nilai asal-asalan tanpa perubahan, dan menolak angka dengan ValidationException. Ejaan riskType berfungsi sebagai alias. Gunakan proxy ketika situs membutuhkan alamat yang sama untuk pemecahan dan POST formulir, seperti yang dijelaskan dalam artikel proxy pemecah CAPTCHA yang membahasnya. String alamat polos berarti HTTP, dan tipe di luar HTTP, HTTPS, SOCKS5, dan SOCKS5H ditolak secara lokal.

Untuk batch bersamaan, pikirkan juga jaringannya. Dokumentasi API CapSkip menyatakan GeeTest menilai jaringan, dan aliran request yang stabil dari satu alamat adalah yang terjaring oleh pembatasan lajunya. Tambahkan pool proxy di aplikasi CapSkip pada Settings, Captcha types, GeeTest, Configure Proxies. Satu pool melayani v3 dan v4, dan proxy yang Anda kirim bersama sebuah task diutamakan dibanding pool.

Langkah 3: jalankan beberapa pengiriman sekaligus

Program.cs membuat host hanya untuk dependency container-nya, jadi tidak pernah memanggil RunAsync. Ia membaca captcha_id satu kali, memulai lima pengiriman bersamaan, dan mencetak setiap hasilnya. Kelima placeholder adalah teks formulir Anda sendiri. Ubah PageUrl dan FormUrl terlebih dahulu, karena seperti yang ditempelkan, keduanya menunjuk ke example.com, yang tidak memiliki widget.

// Program.cs
using CapSkip;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.Logging;
// Implicit usings import System, which has a TimeoutException too.
using SolverTimeout = CapSkip.TimeoutException;

const string PageUrl = "https://example.com/login";   // the page that shows the widget
const string FormUrl = "https://example.com/comment";  // where its form posts

var builder = Host.CreateApplicationBuilder(args);
builder.Logging.SetMinimumLevel(LogLevel.Warning);  // the host logs every HttpClient call at Information
// Local mode. In Server mode use the server's address, and pass apiKey if validation is on.
builder.Services.AddSingleton(new CapSkipClient(host: "127.0.0.1", port: 8080));
// The factory's pooled handler keeps one cookie jar for every request, so switch it off.
builder.Services.AddHttpClient<SiteClient>(c => c.Timeout = TimeSpan.FromSeconds(20))
    .ConfigurePrimaryHttpMessageHandler(() => new SocketsHttpHandler { UseCookies = false });
builder.Services.AddSingleton<Submitter>();
using var host = builder.Build();

using var budget = new CancellationTokenSource(TimeSpan.FromMinutes(2));
Console.CancelKeyPress += (_, e) => { e.Cancel = true; budget.Cancel(); };

var site = host.Services.GetRequiredService<SiteClient>();
var submitter = host.Services.GetRequiredService<Submitter>();
var texts = new[] { "first", "second", "third", "fourth", "fifth" };

string captchaId;
try { captchaId = await site.ReadCaptchaIdAsync(PageUrl, budget.Token); }
catch (Exception ex) { Console.WriteLine("could not read the captcha id: " + ex.Message); return 1; }

var results = await Task.WhenAll(texts.Select(async text =>
{
    try { return await submitter.SubmitAsync(captchaId, PageUrl, FormUrl, text, budget.Token); }
    catch (Exception ex) { return Describe(ex); }  // one failure must not hide the others
}));

for (var i = 0; i < texts.Length; i++) Console.WriteLine($"{texts[i]}: {results[i]}");
return results.All(r => r.StartsWith("200")) ? 0 : 1;

string Describe(Exception ex) => ex switch
{
    // A cancelled submit surfaces as a NetworkException, a cancelled poll as a TaskCanceledException.
    _ when budget.IsCancellationRequested => "the budget ran out",
    ValidationException => "CapSkip refused the arguments: " + ex.Message,
    ApiException => "CapSkip answered " + ex.Message,
    SolverTimeout => "no answer in time: " + ex.Message,
    NetworkException => "CapSkip is not reachable: " + ex.Message,
    // HttpClient reports its own timeout as a TaskCanceledException.
    TaskCanceledException => "the site did not answer within 20 seconds",
    HttpRequestException => "the site could not be reached: " + ex.Message,
    _ => ex.GetType().Name + ": " + ex.Message,
};

Setiap pengiriman membungkus blok try-nya sendiri. Task.WhenAll hanya melempar ulang kegagalan pertama dan task yang dibatalkan tidak membawa exception untuk dibaca, jadi menangkap di dalam lambda menjaga setiap hasil. Mulai program dengan dotnet run. Baris-baris ini adalah hasil mock, dan identik di net10.0 dan net8.0.

Pengaturan mockYang dicetak program
Pengaturan mock defaultLima baris 200 dan teksnya, exit code 0
Setiap pemecahan siap setelah 2 detikPaling banyak 3 pemecahan berjalan, dua yang terakhir dikirim 3.8 detik setelah tiga yang pertama, dan seluruh proses memakan sekitar 8 detik
Dua pemecahan pertama gagalDua baris dengan error API, tiga dengan 200, exit code 1
Situs mock menolak dua POST formulir dengan 403Dua baris 403, tiga baris 200, dan tidak ada yang diulang
Setiap jawaban membawa isOffline trueLima baris pass offline, tidak dikirim, exit code 1

Pembatalan dan kedua TimeoutException

CancellationToken menjangkau SDK dan HttpClient, jadi satu anggaran mencakup seluruh batch. Dengan mock yang tidak pernah selesai dan anggaran 3 detik, kelima baris menyatakan anggaran habis dan proses berakhir setelah sekitar 3.5 detik. Membatalkan saat in.php menggantung menghasilkan NetworkException yang membungkus TaskCanceledException, dan membatalkan saat polling menghasilkan TaskCanceledException biasa. Memeriksa token anggaran lebih dulu di Describe menangani keduanya.

CapSkip juga melempar TimeoutException miliknya sendiri ketika polling melewati batasnya, dan implicit usings mengimpor System, yang juga memilikinya. Catch polos untuk TimeoutException di samping using CapSkip gagal dikompilasi dengan CS0104, itulah sebabnya Program.cs memberi alias SolverTimeout pada class SDK. HttpClient tidak melempar System.TimeoutException kepada Anda. Dengan situs mock yang tidur 25 detik dan batas klien 20, setiap pengiriman kembali sebagai TaskCanceledException setelah sekitar 20 detik, dan proses berjalan sekitar 20.6 detik secara keseluruhan.

GeetestV4Async memakai recaptchaTimeout, yaitu 300 detik secara default, bukan defaultTimeout (menurut changelog). Saya memeriksanya: dengan defaultTimeout 1 dan recaptchaTimeout 5 terhadap mock yang tidak pernah menjawab, exception muncul setelah 7.87 detik di net10.0 dan 7.85 di net8.0. SDK melakukan polling pada sekitar 0, 0.25, 0.75, 1.75, dan 3.75 detik lalu tidur 4 detik lagi, jadi batas waktu baru terdeteksi saat tidur terakhir itu selesai, jauh setelah 5 detik yang Anda tetapkan.

Kesalahan umum

Apa yang Anda lihatPenyebabPerbaiki
ValidationExceptionDitolak sebelum request apa pun: captcha_id kosong, alamat halaman yang bukan http atau https absolut, risk_type yang bukan string, atau opsi seperti gt atau challenge dari v3Perbaiki argumennya. Mencoba ulang tidak akan membantu
ApiException dengan ERROR_KEY_DOES_NOT_EXISTMock menolak kuncinya. Menurut dokumentasi, aplikasi sungguhan menjawab seperti ini saat API Key Validation aktif dan kuncinya tidak dikenalBerikan kunci di CapSkipClient
ApiException dengan ERROR_CAPTCHA_UNSOLVABLEPemecahan gagal. Saya menghasilkannya dengan mock, dan tidak dapat memeriksa bagaimana aplikasi sungguhan melaporkan pemecahan v4 yang gagalPecahkan lagi, dan jangan pernah mengirim hasil lama
NetworkExceptionTidak ada yang menjawab di host dan port CapSkip, atau pemanggilan dibatalkanJalankan CapSkip, atau periksa host di CapSkipClient
CapSkip TimeoutExceptionPolling melewati recaptchaTimeout, dan SDK baru menyadarinya saat tidur berikutnya selesaiNaikkan recaptchaTimeout jika pemecahan Anda lambat
Situs menjawab 403 atau 400Di mock saya: hasil yang sudah dipakai, field yang hilang, atau pass offline. Situs sungguhan menetapkan aturannya sendiriKirim kelima field dari satu pemecahan yang baru

Mode Server: solver dan host di mesin terpisah

Host ini dapat berjalan di PC kedua sementara CapSkip tetap berada di mesin Windows yang Anda kendalikan. Aktifkan mode Server di pengaturan koneksi PC solver, lalu masukkan alamat PC itu pada argumen host CapSkipClient. Tidak ada hal lain di kode yang berubah. Mode Server mengharuskan CapSkip berjalan sebagai administrator, menurut panduan penyiapan. Panduan penyiapan merekomendasikan IP publik statis untuk akses yang stabil, dan menjelaskan pengaturan koneksi secara lengkap.

Ketika mode Server dimulai, CapSkip membuka portnya ke semua alamat. Untuk membatasinya pada mesin yang Anda harapkan, tambahkan aturan block Windows Firewall untuk yang lain, dan aktifkan API Key Validation agar CapSkipClient harus menunjukkan kunci.

FAQ

Mengapa properti hasilnya bernama GeetestCaptchaId?

CaptchaId sudah terpakai: itu adalah id yang diberikan CapSkip pada pemecahan. GeetestCaptchaId menyimpan captcha_id GeeTest yang digemakan kembali oleh widget, dan merupakan salah satu dari lima field yang diharapkan situs.

Bisakah satu CapSkipClient dipakai bersama oleh beberapa thread?

Saya menjalankan lima pemecahan sekaligus melalui satu instance tanpa masalah di mock, dan kode sumbernya menyalin parameternya per pemanggilan. Saya tidak mengujinya lebih jauh. Jika Anda mendaftarkannya sebagai singleton, seperti di atas, semaphore-lah yang membatasi bebannya.

GeeTest v4 di C# intinya satu pembacaan captcha_id, satu panggilan GeetestV4Async per pengiriman, dan lima field yang dikirim bersamaan. CapSkip adalah pemecah captcha berlisensi tetap yang berjalan di PC Anda sendiri, jadi setiap pemecahan tambahan setelah penolakan tidak dikenai biaya. Untuk tipe lain di .NET, lihat Halaman pemecah CAPTCHA C#, dan untuk format request, baca bagian GeeTest v4 pada dokumentasi API.