C# ile GeeTest v4: GeetestV4Async ve IHttpClientFactory

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

C’ta GeeTest v4 kullanmak için tek herkese açık captcha_id değerini sayfadan okuyun, CapSkip NuGet paketindeki GeetestV4Async fonksiyonunu form gönderimi başına bir kez çağırın ve dönen beş değeri kendi adlarıyla gönderin. Bu yazı bunu küçük bir .NET konsol host’u olarak kurar. IHttpClientFactory’den gelen tipli bir HttpClient siteyle konuşur, tek bir CapSkipClient kendi Windows bilgisayarınızdaki çözücüyle konuşur ve bir semaphore, bir grup gönderimin hepsinin aynı anda çözmesini önler. Ürün tarafı GeeTest v4 çözücü sayfasındadır ve çözüm başına ücret yoktur.

Neye ihtiyacınız var

  • GeeTest v4 listeleyen, bir Windows bilgisayarında çalışan bir CapSkip derlemesi. Çalışır hale getirmeyi kurulum kılavuzu anlatır. Uygulama bu bilgisayarda yanıt vermediği için hangi uygulama sürümüne sahip olduğumu denetleyemedim.
  • En az .NET 8 SDK ve GeetestV4Async içeren ilk sürüm olan CapSkip paketi 1.8.0 veya daha yenisi (changelog girdisi 2026-11-16 tarihli). Paketin kendisi .NET Standard 2.0 hedefler, ama aşağıdaki örnek C# 12 sözdizimini ve Microsoft.Extensions paketlerini kullanır; bu yüzden onu yalnızca net8.0 ve net10.0 üzerinde çalıştırdım. Burada yalnızca SDK 10.0.100 kurulu, bu yüzden net8.0, TargetFramework satırı değiştirilerek derlendi ve 8.0 runtime üzerinde çalıştırıldı.
  • Otomatikleştirmenize izin verilen, bir GeeTest v4 widget’ı gösteren bir sayfa ve gönderdiği formun adresi.
  • CapSkip için bir adres. Local modunda 127.0.0.1’e yalnızca onu çalıştıran bilgisayar ulaşabilir. Server modu API’yi diğer makinelerden de erişilebilir kılar; kurulum kılavuzu her iki modu da şu başlıkta açıklar: bağlantı ayarları.

Test ettiğimde çalışan bir CapSkip uygulamasına ulaşamadım; bu yüzden gerçek bir çözüm yapılmadı ve gerçek bir siteyle iletişim kurulmadı. Aşağıdaki her sonuç, in.php, res.php ve yorum formu olan bir siteyi oynayan, yazdığım bir mock’tan gelir. Mock, SDK’nın API başvurusunu izler; site kuralları benimdir, GeeTest’inki değil. Bir ifade belgelere ya da SDK kaynağını okumaya dayandığında bunu söylüyorum.

1. Adım: host’u ve site için tipli bir istemciyi oluşturun

Bir proje klasörü açın ve üç paketi kurun. Yalnızca net8.0 ve net10.0 denedim.

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

Yalnızca net8.0 üzerinde son iki komutu şu sabitlenmiş olanlarla değiştirin. En yeni 11.0.0 paketleri net8.0 üzerinde derlenir ama her paket için desteklenmeyen framework uyarısı yazdırır; sabitlenmiş sürümler hiç uyarı olmadan derlendi.

# 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

Sonraki üç C# bloğu proje klasörü için dosyalardır ve her biri dosya adıyla başlar. Onları gösterilen sırayla kaydedin. Sonuncusu, Program.cs, şablonun oluşturduğu dosyanın yerine geçer.

Tipli istemci yalnızca hedef siteye aittir. SDK kaynağına göre CapSkipClient içeride kendi statik HttpClient nesnesini oluşturur ve sizinkini alan bir constructor’ı yoktur; bu yüzden IHttpClientFactory kendi çağrılarınıza yarar, başka hiçbir şeye yaramaz. SiteClient iki iş yapar: captcha_id değerini okur ve formu gönderir.

// 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’te, v3 akışının aksine, istek başına alınacak bir challenge yoktur. v3 için bkz. C# ile GeeTest v3 yazısı. Sayfa, her ziyaretçi için aynı olan tek bir id değerini initGeetest4 fonksiyonuna captchaId olarak verir; bu yüzden onu bir kez okuyup yeniden kullanırsınız. Sayfa bu çağrıyı çalışma zamanında kurduğunda SDK belgeleri, tarayıcının Network sekmesindeki gcaptcha4.geetest.com/load isteğinin captcha_id sorgu parametresine işaret eder. Düzenli ifade üç mock sayfayı beklediğim gibi eşleştirdi: çift tırnaklı bir çağrı, iki nesnenin içine yerleşmiş tek tırnaklı bir çağrı ve id içermeyen, InvalidOperationException fırlatan bir sayfa.

İstemcinin iki ayrıntısı çalıştırmalardan gelir. Factory mesaj handler’larını havuzlar ve varsayılan olan her istek için tek bir çerez kabı tutar: üç GET boyunca ikinci ve üçüncü, bir önceki yanıtın ayarladığı çerezi taşıdı. UseCookies false yapıldığında, aşağıdaki Program.cs içindeki gibi, hiçbiri taşımadı (mock, net10.0 ve net8.0). Formunuz sayfadaki oturum çerezini gerektiriyorsa Set-Cookie değerini gönderim başına okuyun ve kendiniz geri gönderin. HttpClient ayrıca kendiliğinden Referer eklemez: o satır kaldırıldığında mock boş bir başlık gördü; kodun onu ayarlamasının nedeni budur.

2. Adım: gönderim başına bir çözüm

GeetestV4Async, captcha_id değerini, sayfa adresini, isteğe bağlı bir seçenekler sözlüğünü ve bir CancellationToken alır. Bir SolveResult döndürür. Aşağıdaki sınıf, önce çözen sonra gönderen birimdir ve üç değerli bir SemaphoreSlim aynı anda kaç çözümün çalışacağını sınırlar. CapSkip bilgisayarınızın kaldırabileceği bir sayı seçin; üç yalnızca benim mock ayarımdır.

// 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);
    }
}

Sonuç beş değeri GeetestCaptchaId, LotNumber, PassToken, GenTime ve CaptchaOutput olarak taşır; hepsi dizedir. İlki CaptchaId değildir, çünkü bu ad zaten CapSkip’in çözüme verdiği id’dir (mock 9101 ve yukarısını verdi) ve changelog bunu açıklar. Code, API’nin gönderdiği ham JSON dizesini tutar ve mock çalıştırmasında Token ile Challenge null idi, çünkü bunlar başka türlere aittir.

Neden gönderim başına çözülür? SDK’nın kendi örneği her gönderim için yeniden çözmeyi söyler ve mock’um bunu uygular: bir sonucu iki kez göndermek, gövdesi geçiş token’ının zaten kullanıldığını söyleyen bir 403 aldı. Bu mock’un kuralıdır. Okuduğum GeeTest sunucu doğrulama sayfası bir geçişin iki kez kullanılıp kullanılamayacağını söylemiyor; bu yüzden SDK’nın tavsiyesine uyun. CapSkip belgeleri de hızlı göndermenizi söyler ve GeeTest sayfası süresi dolmuş bir pass_token’ın doğrulamada başarısız olduğunu söyler; gönderim başına çözmenin daha güçlü nedeni budur.

Sonucu kim denetler? Sitenin kendi sunucusu. Şu belgeye göre: GeeTest sunucu doğrulama belgeleri (sayfa Çince), sunucu GeeTest’e lot_number, captcha_output, pass_token ve gen_time değerlerini, ayrıca captcha_id ile bir sign_token gönderir; sign_token, lot_number değerinin sitenin özel anahtarıyla üretilen bir HMAC-SHA256 değeridir. CapSkip o anahtarı asla görmez ve kodunuzun ona ihtiyacı yoktur.

IsOffline, null yapılabilir bir bool değeridir. Belgelere göre GeeTest’e ulaşılamadığında ve widget challenge olmadan geçirdiğinde true olur; site o zaman kabul edip etmeyeceğine karar verir. SDK; true değerini, herhangi bir harf büyüklüğüyle true sözcüğünü ve sıfır olmayan bir sayıyı true, sıfırı ve false sözcüğünü false, okuyamadığı her şeyi null olarak okur (mock yanıtları, altı biçimin hepsi). Yukarıdaki kod çevrimdışı bir geçişi atlar. Siteniz bunları kabul ediyorsa o satırı silin.

İki seçenek de isteğe bağlıdır. Bu parça, Submitter.cs içindeki GeetestV4Async çağrısının yerine geçer:

// 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);

Belgelere göre risk_type on değerden birini alır: slide, icon, nine, word, phrase, match, winlinze, svg_seed, svg_icon ve ai. GeeTest birini yalnızca site çağıranların seçmesine izin veriyorsa uygular. SDK değeri denetlemez: boşlukları kırptı, boş birini bıraktı ve saçma bir değeri değişmeden gönderdi, bir sayıyı ise ValidationException ile reddetti. riskType yazımı bir takma ad olarak çalışır. Site çözüm ve form gönderimi için aynı adresi gerektiriyorsa proxy kullanın; ayrıntılar CAPTCHA çözücü proxy yazısında anlatılır. Yalın bir adres dizesi HTTP anlamına gelir ve HTTP, HTTPS, SOCKS5 ve SOCKS5H dışındaki bir tür yerel olarak reddedilir.

Eşzamanlı bir toplu iş için ağı da düşünün. CapSkip API belgeleri GeeTest’in ağı puanladığını ve tek bir adresten gelen sürekli istek akışının hız sınırlamasının yakaladığı şey olduğunu söyler. CapSkip uygulamasında Settings, Captcha types, GeeTest, Configure Proxies altına bir proxy havuzu ekleyin. Bir havuz hem v3’e hem v4’e hizmet eder ve bir görevle birlikte gönderdiğiniz proxy havuzun önüne geçer.

3. Adım: aynı anda birkaç gönderim çalıştırın

Program.cs host’u yalnızca bağımlılık kabı için oluşturur; bu yüzden RunAsync fonksiyonunu hiç çağırmaz. captcha_id değerini bir kez okur, beş gönderimi birlikte başlatır ve her sonucu yazdırır. Beş yer tutucu sizin kendi form metinlerinizdir. Önce PageUrl ve FormUrl değerlerini değiştirin, çünkü yapıştırıldığı gibi, widget’ı olmayan example.com adresine işaret ederler.

// 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,
};

Her gönderim kendi try bloğunu sarar. Task.WhenAll yalnızca ilk hatayı yeniden fırlatır ve iptal edilen görevler okunacak istisna taşımaz; bu yüzden lambda içinde yakalamak her sonucu korur. Programı dotnet run ile başlatın. Bu satırlar mock sonuçlarıdır ve net10.0 ile net8.0 üzerinde aynıydılar.

Mock ayarıProgramın yazdırdığı
Varsayılan mock ayarları200 ve metinden oluşan beş satır, çıkış kodu 0
Her çözüm 2 saniye sonra hazırAynı anda en fazla 3 çözüm, son ikisi ilk üçten 3,8 saniye sonra gönderildi ve bütün çalıştırma yaklaşık 8 saniye sürdü
İlk iki çözüm başarısızAPI hatası içeren iki satır, 200 içeren üç satır, çıkış kodu 1
Mock site iki form gönderimini 403 ile reddediyorİki 403 satırı, üç 200 satırı ve hiçbir şey yeniden denenmedi
Her yanıt isOffline true taşıyorÇevrimdışı geçişten oluşan beş satır, gönderilmedi, çıkış kodu 1

İptal ve iki TimeoutException

CancellationToken hem SDK’ya hem HttpClient’a ulaşır; bu yüzden tek bir bütçe bütün toplu işi kapsar. Hiç bitmeyen bir mock ve 3 saniyelik bir bütçeyle, beş satırın hepsi bütçenin tükendiğini bildirdi ve süreç yaklaşık 3,5 saniye sonra bitti. in.php asılıyken iptal etmek bir TaskCanceledException saran bir NetworkException verdi, yoklama sırasında iptal etmek ise düz bir TaskCanceledException verdi. Describe içinde önce bütçe token’ını denetlemek ikisini de ele alır.

CapSkip, yoklama sınırını aştığında kendi TimeoutException sınıfını da fırlatır ve örtük using satırları, bir tane daha olan System ad alanını içe aktarır. using CapSkip yanında TimeoutException için çıplak bir catch CS0104 ile derlenmedi; Program.cs’in SDK sınıfını SolverTimeout olarak takma adlandırmasının nedeni budur. Ancak HttpClient size System.TimeoutException fırlatmaz. Mock site 25 saniye uyurken ve istemci sınırı 20 iken her gönderim yaklaşık 20 saniye sonra bir TaskCanceledException olarak döndü ve çalıştırma toplam yaklaşık 20,6 saniye sürdü.

GeetestV4Async, defaultTimeout değil, varsayılan olarak 300 saniye olan recaptchaTimeout kullanır (changelog’a göre). Bunu denetledim: defaultTimeout 1 ve recaptchaTimeout 5 iken hiç yanıt vermeyen bir mock’a karşı istisna net10.0 üzerinde 7,87 saniye, net8.0 üzerinde 7,85 saniye sonra geldi. SDK yaklaşık 0; 0,25; 0,75; 1,75 ve 3,75 saniyelerde yoklar, sonra 4 saniye daha uyur; bu yüzden süre sınırı, koyduğunuz 5 saniyeden epey sonra, son uykunun bittiği anda fark edilir.

Yaygın hatalar

GördüğünüzNedenDüzeltme
ValidationExceptionHerhangi bir istekten önce reddedildi: boş bir captcha_id, mutlak bir http veya https olmayan bir sayfa adresi, dize olmayan bir risk_type veya v3’ten gt ya da challenge gibi bir seçenekArgümanı düzeltin. Yeniden denemek yardımcı olmaz
ERROR_KEY_DOES_NOT_EXIST ile ApiExceptionMock anahtarı reddetti. Belgelere göre gerçek uygulama, API Key Validation açıkken ve anahtar bilinmiyorken bunu yanıtlarAnahtarı CapSkipClient içinde geçirin
ERROR_CAPTCHA_UNSOLVABLE içeren ApiExceptionÇözüm başarısız oldu. Bunu bir mock ile ürettim ve gerçek uygulamanın başarısız bir v4 çözümünü nasıl bildirdiğini denetleyemedimYeniden çözün ve eski sonucu asla göndermeyin
NetworkExceptionCapSkip host ve portunda kimse yanıt vermedi ya da çağrı iptal edildiCapSkip’i başlatın ya da CapSkipClient içindeki host değerini denetleyin
CapSkip TimeoutExceptionYoklama recaptchaTimeout sınırını aştı ve SDK bunu yalnızca bir sonraki uykusu bittiğinde fark ederÇözümleriniz yavaşsa recaptchaTimeout değerini yükseltin
Site 403 veya 400 yanıtı veriyorMock’umda: zaten kullanılmış bir sonuç, eksik bir alan ya da çevrimdışı bir geçiş. Gerçek bir site kendi kurallarını koyarBeş alanın hepsini tek bir taze çözümden gönderin

Server modu: çözücü ve host ayrı makinelerde

Bu host, CapSkip kontrol ettiğiniz bir Windows makinesinde kalırken ikinci bir bilgisayarda çalışabilir. Çözücü bilgisayarın bağlantı ayarlarından Server modunu açın, sonra o bilgisayarın adresini CapSkipClient için host argümanına yazın. Kodda başka hiçbir şey değişmez. Kurulum kılavuzuna göre Server modu CapSkip’in yönetici olarak çalışmasını gerektirir. Kurulum kılavuzu kararlı erişim için sabit bir genel IP önerir ve bağlantı ayarları bölümünü ayrıntılı olarak açıklar.

Server modu başladığında CapSkip portunu her adrese açar. Onu beklediğiniz makinelerle sınırlamak için diğer hepsi için bir Windows Güvenlik Duvarı engelleme kuralı ekleyin ve CapSkipClient bir anahtar sunmak zorunda kalsın diye API Key Validation’ı açın.

FAQ

Sonuç özelliği neden GeetestCaptchaId olarak adlandırılıyor?

CaptchaId zaten alınmıştı: CapSkip’in çözüme verdiği id’dir. GeetestCaptchaId, widget’ın geri yansıttığı GeeTest captcha_id değerini tutar ve sitenin geri beklediği beş alandan biridir.

Tek bir CapSkipClient nesnesini iş parçacıkları arasında paylaşabilir miyim?

Mock’ta tek bir örnek üzerinden aynı anda beş çözümü sorunsuz çalıştırdım ve kaynak parametrelerini çağrı başına kopyalar. Bunun ötesinde denemedim. Yukarıdaki gibi singleton olarak kaydederseniz yükü sınırlayan şey semaphore’dur.

C’ta GeeTest v4, bir captcha_id okuması, gönderim başına bir GeetestV4Async çağrısı ve birlikte gönderilen beş alana iner. CapSkip, kendi bilgisayarınızda çalışan sabit lisanslı bir captcha çözücü olduğu için bir reddin ardından yapılan her ek çözüm ücretsizdir. .NET’teki diğer türler için bkz. C# CAPTCHA çözücü sayfası, istek biçimi için ise bkz. API belgelerinin GeeTest v4 bölümü.