Electron CAPTCHA: main process से Turnstile हल करें

Electron ऐप से CAPTCHA हल करने के लिए काम main process में ही रखें। BrowserWindow में page लोड करें, webContents.executeJavaScript से sitekey पढ़ें, capskip Node SDK से CapSkip से token माँगें, window को उस User-Agent पर बदलें जो solver बताता है, token को छिपे हुए फ़ील्ड में लिखें और form सबमिट करें। यह electron captcha गाइड उस डेवलपर के लिए है जिसे Electron ऐप के अंदर से Turnstile widget पार करना है, न कि अपनी साइट पर उसे जोड़ना। renderer यह काम IPC से माँगता है और API key कभी नहीं देखता। हर token एक CapSkip Turnstile सॉल्वर से आता है, जो आपके अपने Windows PC पर चलता है।
आपको क्या चाहिए
- एक Windows PC, जिस पर CapSkip वैसे इंस्टॉल हो जैसा सेटअप गाइड बताती है, और जो Local mode में चल रहा हो, जो 127.0.0.1:8080 पर सुनता है।
- npm के लिए Node.js 22.12 या उससे नया, जो electron package की घोषित न्यूनतम सीमा है। capskip package Node.js 18 घोषित करता है, जिसे Electron 45.3.0 के अंदर वाला Node.js पूरा करता है: उसने 24.22.2 बताया। मेरे run में पहली बार शुरू करने पर Electron program डाउनलोड होने में 21.9 सेकंड लगे, जिसे npm install ने नहीं उतारा था।
- Turnstile widget वाला एक page, जिसे ऑटोमेट करने की आपको अनुमति है।
- CapSkip का ऐसा पता जो उस जगह के हिसाब से हो जहाँ ऐप चलता है। Local mode सिर्फ़ अपने ही PC को सेवा देता है, और Server mode आपके नेटवर्क या public IP पर सुनता है, जो शिप किए गए ऐप को चाहिए (आख़िरी सेक्शन देखें)।
मैंने Turnstile इसलिए चुना क्योंकि उसका widget token को एक सादे छिपे input में रखता है, और उसके नतीजे में वह User-Agent आता है जो solver ने इस्तेमाल किया, जबकि Electron का page किसी और User-Agent से लोड होता है। यही टकराव इस काम का वह हिस्सा है जो Electron का है।
सब कुछ Windows 11 पर Electron 45.3.0 (Chrome 156.0.8078.96) और capskip 1.7.0 के साथ चला, मेरे लिखे दो mock के सामने: एक CapSkip बनता है और दूसरा Turnstile जैसे widget वाला contact page। token का text और साइट के हर नियम मेरे हैं, और असली CapSkip ऐप को कोई task नहीं मिला। एक wrapper ने वही main.js शुरू किया, हर window खुलते ही उसे छिपा दिया और बटन को script से क्लिक किया; दिखने वाली windows के साथ एक run का नतीजा वही रहा। मैंने ऐप को package नहीं किया।
Step 1: दो windows, एक preload और IPC bridge
एक खाली फ़ोल्डर बनाएँ और ये तीन कमांड चलाएँ। आख़िरी कमांड npm को प्रोजेक्ट main.js से शुरू करना सिखाती है।
# npm install electron capskip npm init -y npm install electron capskip npm pkg set main=main.js
ऐप को दो windows चाहिए। एक आपका अपना interface दिखाती है और उसे एक preload script मिलती है। दूसरी CAPTCHA वाला page लोड करती है और उसे कुछ नहीं मिलता, इसलिए उस page की कोई script आपके main process तक पहुँचने वाला bridge नहीं पाती। मैंने contextIsolation, nodeIntegration और sandbox साफ़ तौर पर सेट किए, पर Electron 45.3.0 में बिना webPreferences वाली window ने भी यही मान दिखाए, और Electron सुरक्षा गाइड के अनुसार ये defaults क्रमशः version 12, 5 और 20 से लागू हैं।
// main.js
const { app, BrowserWindow, ipcMain } = require("electron");
const { once } = require("node:events");
const path = require("node:path");
const { CapSkip } = require("capskip");
// The page that shows the Turnstile widget.
const SITE_URL = process.env.SITE_URL || "https://example.com/contact";
// The only place that knows the host and the key. Local mode by default.
const solver = new CapSkip({
host: process.env.CAPSKIP_HOST || "127.0.0.1",
port: Number(process.env.CAPSKIP_PORT || 8080),
apiKey: process.env.CAPSKIP_API_KEY || "capskip",
});
let ui;
let site;
let busy = false;
// The page with the CAPTCHA: no preload, so nothing is exposed to it.
function createSite() {
return new BrowserWindow({
width: 900,
height: 700,
webPreferences: { contextIsolation: true, nodeIntegration: false, sandbox: true },
});
}
app.whenReady().then(() => {
// Your own interface: the only window that gets the preload script.
ui = new BrowserWindow({
width: 480,
height: 320,
webPreferences: {
preload: path.join(__dirname, "preload.js"),
contextIsolation: true,
nodeIntegration: false,
sandbox: true,
},
});
ui.loadFile("index.html");
site = createSite();
});
app.on("window-all-closed", () => app.quit());CapSkip यहाँ एक ही बार बनता है, और उसका host, port और key उन environment variables से आते हैं जिन्हें आप खुद पढ़ते हैं, क्योंकि SDK कोई variable नहीं पढ़ता। preload सिर्फ़ एक function सामने रखता है, पूरा ipcRenderer कभी नहीं, और invoke वही लौटाता है जो main process का handler लौटाए।
// preload.js
const { contextBridge, ipcRenderer } = require("electron");
// Expose one narrow function, never ipcRenderer itself.
contextBridge.exposeInMainWorld("captcha", {
send: (email) => ipcRenderer.invoke("captcha:send", email),
});interface की script एक अलग फ़ाइल में है, ताकि उसकी अपनी Content-Security-Policy सिर्फ़ self से scripts की अनुमति दे सके, जैसा security guide सलाह देता है।
<!-- index.html --> <!doctype html> <meta charset="utf-8"> <meta http-equiv="Content-Security-Policy" content="default-src 'none'; script-src 'self'"> <title>Send with CAPTCHA</title> <input id="email" value="[email protected]"> <button id="go">Solve and send</button> <pre id="out"></pre> <script src="renderer.js"></script>
// renderer.js
const go = document.getElementById("go");
const out = document.getElementById("out");
go.addEventListener("click", async () => {
go.disabled = true;
out.textContent = "Solving";
const reply = await window.captcha.send(document.getElementById("email").value);
out.textContent = JSON.stringify(reply, null, 2);
go.disabled = false;
});दोनों windows में require और process undefined थे; interface window में window.captcha के पास एक ही key, send, थी और page window में वह undefined थी; और API key किसी भी page के HTML में नहीं दिखी। एक probe window, जिसमें वही preload था पर दूसरा page खुला था, को handler की sender जाँच से refused reply मिला, जिसकी माँग Electron security guide करता है।
Step 2: वह handler जो solve और submit करता है
इसे main.js के पहले हिस्से के नीचे चिपकाएँ। यह page लोड करता है, widget के data-sitekey attribute से sitekey पढ़ता है, solver.turnstile को बुलाता है, बताया गया User-Agent अपनाता है, form भरता है और लौटने वाले page का इंतज़ार करता है।
// main.js, continued below the first part
// Read the sitekey from the page, solve, set the User-Agent, fill, submit.
async function solveAndSend(email) {
// The user may have closed the page window since the last job.
if (!site || site.isDestroyed()) site = createSite();
await site.loadURL(SITE_URL);
const web = site.webContents;
const sitekey = await web.executeJavaScript(
`document.querySelector("[data-sitekey]")?.dataset.sitekey ?? null`
);
if (!sitekey) return { ok: false, error: "no widget on the page" };
// Turnstile polls on defaultTimeout; this call is capped at 60 seconds.
const solved = await solver.turnstile(sitekey, web.getURL(), { timeout: 60 });
if (web.isDestroyed()) return { ok: false, error: "window closed" };
// Submit with the User-Agent the token was earned with.
if (solved.userAgent) web.setUserAgent(solved.userAgent);
// JSON.stringify keeps a quote in a value from breaking out of the string.
const fill = `(() => {
const form = document.querySelector("form");
form.elements["email"].value = ${JSON.stringify(email)};
let field = form.elements["cf-turnstile-response"];
if (!field) {
field = Object.assign(document.createElement("input"), { type: "hidden", name: "cf-turnstile-response" });
form.appendChild(field);
}
field.value = ${JSON.stringify(solved.code)};
form.requestSubmit();
})()`;
const loaded = once(web, "did-finish-load");
await web.executeJavaScript(fill);
await loaded;
const page = await web.executeJavaScript("document.body.innerText");
return { ok: true, page: page.trim().slice(0, 80) };
}
ipcMain.handle("captcha:send", async (event, email) => {
if (event.sender !== ui.webContents) return { ok: false, error: "refused" };
if (typeof email !== "string" || email.length > 200) {
return { ok: false, error: "bad email" };
}
if (busy) return { ok: false, error: "busy" };
busy = true;
try {
return await solveAndSend(email);
} catch (err) {
// An Error thrown here reaches the renderer as a message only.
return { ok: false, error: err.constructor.name, message: err.message };
} finally {
busy = false;
}
});चार बातें मायने रखती हैं। पहली, 1.7.0 में Turnstile के जवाब में captchaId, code और userAgent थे और token नाम का कोई फ़ील्ड नहीं था, इसलिए token ही code है। दूसरी, reply में ok का मतलब है कि form सबमिट हो गया, यह नहीं कि साइट ने token मान लिया: User-Agent वाला step छोड़ने पर मेरे mock ने ऐप को ok कहा और page पर Verification failed दिखा, इसलिए अपनी साइट का सफलता वाला text देखें। तीसरी, Cloudflare की rendering गाइड कहती है कि implicit rendering cf-turnstile-response नाम का एक अदृश्य input जोड़ता है, और token 300 सेकंड में expire हो जाते हैं और सिर्फ़ एक बार validate होते हैं। अगर आपका page widget के खत्म होने पर कोई callback चलाता है, तो CapSkip API docs सलाह देते हैं कि उसे token के साथ चलाएँ; यह मैंने टेस्ट नहीं किया। मैंने Cloudflare की असली widget script एक छिपी window में एक बार लोड की, उस sitekey के साथ जो Cloudflare टेस्टिंग के लिए प्रकाशित करता है, और input लोड के लगभग 2.5 सेकंड बाद आया, इसलिए कोड फ़ील्ड तब बनाता है जब वह मौजूद न हो। उस token को मैंने कहीं सबमिट नहीं किया और यह टेस्ट नहीं किया कि widget आपके सेट किए मान को दोबारा लिख देता है या नहीं। चौथी, JSON.stringify मानों को script में बुनता है, और quotes और एक backslash वाला email मेरे mock तक बिना बदले पहुँचा।
समय सीमाएँ और बंद की गई window
Turnstile client के डिफ़ॉल्ट 120 सेकंड वाले timeout पर poll करता है, reCAPTCHA वाले लंबे timeout पर नहीं: defaultTimeout 5 और recaptchaTimeout 300 के साथ, जो mock कभी जवाब नहीं देता था वह 7.8 सेकंड बाद TimeoutException पर खत्म हुआ। timeout विकल्प हर call के लिए है, सेकंड में, और मैंने 60 रखा। SDK deadline तभी जाँचता है जब अगला poll होना हो, इसलिए कभी जवाब न देने वाले mock में क्लिक से reply तक 63.0 सेकंड लगे। ipcRenderer.invoke का अपना कोई timeout नहीं है: जो handler कभी लौटा ही नहीं, उसकी call 20 सेकंड देखने के बाद भी रुकी रही। SDK का timeout ही आपकी एकमात्र सीमा है।
SDK को रद्द नहीं किया जा सकता। जब मैंने 4 सेकंड के mock solve के 1.5 सेकंड बाद page window बंद की, तो SDK poll करता रहा और reply 7.9 सेकंड पर आया। isDestroyed जाँच के बिना setUserAgent ने TypeError: Object has been destroyed फेंका, और createSite के बिना हर बाद का क्लिक उसी तरह फेल हुआ; दोनों के साथ अगले क्लिक ने नई page window खोली और सफल रहा। solve के दौरान दूसरे क्लिक को busy reply मिला, क्योंकि एक page window दो काम नहीं संभाल सकती।
handler के अंदर फेंकी गई Error renderer तक सिर्फ़ message बनकर पहुँचती है: मेरे probe ने code property वाली MyErr फेंकी, और renderer को एक सादी Error दिखी। इसलिए handler सब कुछ पकड़ता है और ऐसा object लौटाता है जिसमें SDK exception का class name और message बना रहता है।
Step 3: page की Content-Security-Policy क्या ब्लॉक करती है
executeJavaScript के Electron docs में Content-Security-Policy का ज़िक्र नहीं है, इसलिए मैंने उसे टेस्ट किया। मैंने mock page को बिना policy के और script-src self policy के साथ लोड किया, और main world में वही probes चलाए।
| जाँच | कोई policy नहीं | script-src self policy |
|---|---|---|
| page के अपने HTML में लिखी inline script | चली | ब्लॉक |
| page के अपने origin की script फ़ाइल | चली | चली |
| executeJavaScript से छिपा input सेट करना | काम किया | काम किया |
| चलाए गए कोड के अंदर eval() या new Function() को बुलाना | काम किया | EvalError |
| inline text वाला script element जिसे चलाया गया कोड जोड़ता है | चली | ब्लॉक |
| executeJavaScriptInIsolatedWorld में eval() | काम किया | काम किया |
जो कोड आप executeJavaScript को देते हैं वह चलता है, पर policy अब भी उस हर चीज़ पर लागू रहती है जिसे वह strings से बनाता है। properties सेट करें और मौजूद functions को बुलाएँ, तो policy का कोई दखल नहीं। Step 2 का पूरा flow script-src वाले page के सामने पास हुआ, और default-src none policy, जिसने page की अपनी script फ़ाइल भी ब्लॉक की, तब भी छिपा input सेट होने देती रही।
Step 4: वह User-Agent जिससे page लोड होता है
Electron window खुद को Electron token के साथ पहचानवाती है: मेरे mock ने Chrome/156.0.8078.96 Electron/45.3.0 देखा। CapSkip API docs कहते हैं कि Turnstile token सबमिट करते समय solver का User-Agent भेजें, और Node SDK उसे चुनने नहीं देता: userAgent और useragent दोनों ने Unsupported parameters for Turnstile के साथ ValidationException उठाई। handler page लोड होने के बाद webContents.setUserAgent बुलाता है; मेरे mock ने इसे सेट करने के पाँच तरीकों के ये नतीजे दर्ज किए।
| सेट करने का तरीका | navigator.userAgent | Request header |
|---|---|---|
| page लोड होने के बाद webContents.setUserAgent | तुरंत बदला, reload नहीं | अगले form submission पर solver वाला |
| loadURL से पहले webContents.setUserAgent | solver वाला | page लोड और submission दोनों पर solver वाला |
| custom session पर session.setUserAgent, या loadURL का userAgent विकल्प | solver वाला | दोनों पर solver वाला |
| webRequest onBeforeSendHeaders hook | फिर भी Electron वाली string | दोनों पर solver वाला |
hook अपवाद है: जो page script navigator.userAgent पढ़ती है उसे अब भी Electron दिखता है जबकि server को कुछ और दिखता है। ऐप को User-Agent तभी पता चलता है जब page खुल चुका हो, इसलिए लोड के बाद वाली call ठीक बैठती है। मेरी किसी भी request में sec-ch-ua header नहीं था, और setUserAgent के बाद भी navigator.userAgentData.brands सूची में Chromium 156 लिखा रहा, यानी दोनों में मेल नहीं है। Chromium ने form submission में खुद Referer और Origin जोड़े। User-Agent की जाँच मेरे mock का नियम है: मैंने किसी असली साइट को टेस्ट नहीं किया, इसलिए कोई साइट दोनों की तुलना करती है या नहीं, यह बिना टेस्ट है।
इसे चलाएँ, और शिप किए गए ऐप के लिए Server mode
page का पता सेट करें, फिर ऐप शुरू करें। कमेंट की गई दो लाइनें सिर्फ़ Server mode के लिए हैं; जब तक CapSkip उसी PC पर चल रहा है, उन्हें छुएँ नहीं।
# Run from the project folder in PowerShell $env:SITE_URL = "https://example.com/contact" # Server mode only: another PC runs CapSkip # $env:CAPSKIP_HOST = "192.168.1.50" # $env:CAPSKIP_API_KEY = "YOUR_API_KEY" npx electron .
आपका शिप किया हुआ ऐप इस भरोसे नहीं रह सकता कि 127.0.0.1 पर CapSkip होगा। या तो हर उपयोगकर्ता अपने PC पर CapSkip को Local mode में चलाए और कोड जैसा है वैसा रहे, या आप अपने नियंत्रण वाली किसी Windows मशीन पर CapSkip को Server mode में चलाएँ, जहाँ वह आपके नेटवर्क या public IP पर सुनता है, और CAPSKIP_HOST उसी मशीन का नाम बताता है। 8080 से अलग port के लिए CAPSKIP_PORT यही काम करता है। CapSkip की कनेक्शन सेटिंग्स में यह स्विच है, setup guide के अनुसार Server mode के लिए CapSkip को administrator के रूप में चलाना ज़रूरी है, और एक static address ऐप को हमेशा उसी जगह की ओर रखता है।
तीन सावधानियाँ। Server mode शुरू होते ही CapSkip अपना port हर पते के लिए खोल देता है, इसलिए उसे सिर्फ़ अपेक्षित मशीनों तक रखने के लिए बाकी के लिए Windows Firewall का block rule जोड़ें, और API Key Validation चालू करें। SDK बिना TLS विकल्प के http पता बनाता है, इसलिए LAN या VPN के बाहर key सादे text में जाती है। और जिस ऐप को आप बाँटते हैं उसके अंदर की key को हर चलाने वाला पढ़ सकता है, इसलिए उसे सार्वजनिक मानें। आख़िरी दो बातें SDK source पढ़कर मेरा निष्कर्ष हैं, टेस्ट नहीं।
आम errors
mock चिह्नित पंक्तियाँ वही हैं जो मेरे mock ने असली SDK के ज़रिए लौटाया; बाकी CapSkip docs के अनुसार हैं।
| handler का reply | कारण | फिक्स |
|---|---|---|
| ERROR_KEY_DOES_NOT_EXIST के साथ ApiException (mock) | API Key Validation चालू है और भेजी गई key गलत है। CAPSKIP_API_KEY न हो तो SDK capskip भेजता है | CAPSKIP_API_KEY सेट करें |
| connect ECONNREFUSED के साथ NetworkException (mock port) | उस host और port पर कुछ नहीं सुन रहा | CapSkip शुरू करें, या CAPSKIP_HOST और port ठीक करें |
| timeout 60 exceeded के साथ TimeoutException (mock) | call के timeout के भीतर कोई token नहीं मिला; reply 63.0 सेकंड पर आया | CapSkip Monitor खोलें, फिर दोबारा कोशिश करें |
| ApiException जिसके message में ERROR_CAPTCHA_UNSOLVABLE है | चुनौती पास नहीं हुई। SDK कच्चा reply text फेंकता है; मैंने असली poll error body नहीं जाँची | नए task के साथ दोबारा कोशिश करें |
| ok true, पर page कहता है कि जाँच विफल रही | form चला गया; साइट ने token ठुकरा दिया, अक्सर User-Agent या उम्र का मेल न होने से | page का text पढ़ें, और नया token माँगें |
| error busy, window closed, no widget on the page | इस handler की अपनी जाँचें | रुकें, फिर क्लिक करें (नई page window खुलती है), या page का पता जाँचें |
FAQ
CapSkip को renderer से क्यों न बुलाएँ?
sandbox वाले renderer में require नहीं होता, इसलिए Node SDK वहाँ लोड ही नहीं हो सकता, और जिस renderer के पास आपकी key हो वह उसे अपने लोड किए हर script को दिखा देगा। main process में key एक ही module में रहती है।
क्या CapSkip वाला हिस्सा उपयोगकर्ता के PC की जगह किसी server पर चल सकता है?
हाँ, Server mode से, जैसा ऊपर बताया गया। सिर्फ़ CAPSKIP_HOST बदलता है, और ऐप का कोड वही रहता है।
जिस Electron ऐप को CAPTCHA पार करना है, उसे बस सही process से पूछना है: main process CapSkip को बुलाता है, renderer नतीजा दिखाता है, और form जाने से पहले User-Agent बदल दिया जाता है। browser shell के बिना सादे Node.js संस्करण के लिए यह देखें: Node.js में Turnstile गाइड। चूँकि CapSkip आपके अपने PC पर चलने वाला कैप्चा बायपास टूल है, इसलिए ठुकराए गए token को दोबारा आज़माने पर कोई अतिरिक्त खर्च नहीं आता।
