{"id":24977,"date":"2026-08-06T10:17:34","date_gmt":"2026-08-06T10:17:34","guid":{"rendered":"https:\/\/capskip.com\/?p=24977"},"modified":"2026-08-06T10:17:34","modified_gmt":"2026-08-06T10:17:34","slug":"turnstile-nodejs","status":"publish","type":"post","link":"https:\/\/capskip.com\/zh\/turnstile-nodejs\/","title":{"rendered":"\u5982\u4f55\u7528 Node.js \u548c TypeScript \u8bc6\u522b Cloudflare Turnstile"},"content":{"rendered":"<p>Cloudflare Turnstile \u4ee5\u4e24\u79cd\u5f62\u6001\u51fa\u73b0\uff0c\u5b83\u4eec\u9700\u8981\u4e0d\u540c\u7684\u4ee3\u7801\u3002\u8868\u5355\u4e2d\u7684\u5c0f\u7ec4\u4ef6\u53ea\u662f\u4e00\u4e2a\u4e24\u53c2\u6570\u8c03\u7528\u3002\u800c\u6574\u9875\u63d2\u9875\u5f0f\u6311\u6218\u5219\u9700\u8981\u4ece\u9875\u9762\u6293\u53d6\u4e24\u4e2a\u989d\u5916\u7684\u503c\uff0c\u5e76\u4e14\u53ea\u6709\u5f53\u4f60\u56de\u4f20\u8bc6\u522b\u5de5\u5177\u6240\u4f7f\u7528\u7684 user agent \u65f6\uff0ctoken \u624d\u4f1a\u88ab\u63a5\u53d7\u3002\u6b63\u662f\u6700\u540e\u8fd9\u4e00\u6761\u8981\u6c42\uff0c\u5bfc\u81f4\u4eba\u4eec\u5f97\u5230\u90a3\u4e9b\u770b\u8d77\u6765\u5b8c\u7f8e\u65e0\u7f3a\u3001\u5374\u6bcf\u6b21\u90fd\u5931\u8d25\u7684 token\u3002<\/p>\n<h2 style=\"font-size:1.6rem;line-height:1.35;\">\u5982\u4f55\u533a\u5206\u4e24\u8005<\/h2>\n<table>\n<thead>\n<tr>\n<th><\/th>\n<th>\u5c0f\u7ec4\u4ef6<\/th>\n<th>\u6311\u6218\u9875\u9762<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>\u5916\u89c2<\/td>\n<td>\u53ef\u7528\u8868\u5355\u4e2d\u7684\u4e00\u4e2a\u590d\u9009\u6846<\/td>\n<td>\u6574\u9875\u63d2\u9875\u5f0f\u62e6\u622a\uff0c\u9875\u9762\u88ab\u963b\u6b62<\/td>\n<\/tr>\n<tr>\n<td>\u9700\u8981 cData \u548c chlPageData<\/td>\n<td>\u5426<\/td>\n<td>\u662f<\/td>\n<\/tr>\n<tr>\n<td>\u9700\u8981\u56de\u4f20\u7684 user agent<\/td>\n<td>\u5426<\/td>\n<td>\u662f<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>\u6211\u4eec\u7684 <a href=\"https:\/\/capskip.com\/zh\/captcha-demo\/cloudflare-turnstile\/\">Turnstile \u5728\u7ebf\u6f14\u793a<\/a> \u8fd0\u884c\u7684\u662f\u5c0f\u7ec4\u4ef6\u7248\u672c\uff0c\u5f53\u4f60\u5728\u5224\u65ad\u81ea\u5df1\u9762\u5bf9\u7684\u662f\u54ea\u4e00\u79cd\u65f6\uff0c\u5b83\u662f\u4e00\u4e2a\u6709\u7528\u7684\u53c2\u8003\u3002<\/p>\n<h2 style=\"font-size:1.6rem;line-height:1.35;\">\u8bbe\u7f6e<\/h2>\n<pre data-enlighter-language=\"bash\" class=\"EnlighterJSRAW\">npm install capskip<\/pre>\n<pre data-enlighter-language=\"js\" class=\"EnlighterJSRAW\">const { CapSkip } = require('capskip');\n\nconst solver = new CapSkip({\n  host: '127.0.0.1',\n  port: 8080,\n  recaptchaTimeout: 300,   \/\/ seconds, also covers Turnstile\n});<\/pre>\n<p>CapSkip \u5728\u672c\u5730\u8bc6\u522b\uff0c\u56e0\u6b64\u5728\u4efb\u4f55\u8c03\u7528\u6210\u529f\u4e4b\u524d\uff0c\u684c\u9762\u5e94\u7528\u5fc5\u987b\u5904\u4e8e\u8fd0\u884c\u72b6\u6001\u3002<\/p>\n<h2 style=\"font-size:1.6rem;line-height:1.35;\">\u5c0f\u7ec4\u4ef6\u6a21\u5f0f<\/h2>\n<pre data-enlighter-language=\"js\" class=\"EnlighterJSRAW\">const result = await solver.turnstile(\n  '0x4AAAAAAA...',                  \/\/ the data-sitekey attribute\n  'https:\/\/example.com\/login',\n);\n\nconsole.log(result.code);           \/\/ cf-turnstile-response token<\/pre>\n<p>\u5c06 <code>result.code<\/code> \u653e\u5165 <code>cf-turnstile-response<\/code> \u5b57\u6bb5\u5e76\u63d0\u4ea4\uff0c\u65e0\u9700\u5176\u4ed6\u4efb\u4f55\u64cd\u4f5c\u3002<\/p>\n<h2 style=\"font-size:1.6rem;line-height:1.35;\">\u6311\u6218\u9875\u9762\u9700\u8981\u53e6\u5916\u4e24\u4e2a\u503c<\/h2>\n<p>\u63d2\u9875\u5f0f\u6311\u6218\u643a\u5e26\u4e0e token \u7ed1\u5b9a\u7684\u6bcf\u6b21\u8bf7\u6c42\u72b6\u6001\u3002\u5176\u4e2d\u6709\u4e24\u90e8\u5206\u5fc5\u987b\u968f\u8bc6\u522b\u8bf7\u6c42\u4e00\u8d77\u4f20\u9012\uff1a<\/p>\n<ul>\n<li><strong>cData<\/strong>\uff0c\u4f5c\u4e3a <code>data<\/code><\/li>\n<li><strong>chlPageData<\/strong>\uff0c\u4f5c\u4e3a <code>pagedata<\/code><\/li>\n<\/ul>\n<p>\u8fd9\u4e24\u4e2a\u503c\u90fd\u5b58\u5728\u4e8e\u6311\u6218\u9875\u9762\u672c\u8eab\uff0c\u800c\u4e0d\u662f\u67d0\u4e2a\u8868\u5355\u5c5e\u6027\u4e2d\uff0c\u56e0\u6b64\u5fc5\u987b\u5148\u83b7\u53d6\u9875\u9762\u624d\u80fd\u8fdb\u884c\u8bc6\u522b\u3002\u5728\u6807\u51c6\u7684 Cloudflare \u63d2\u9875\u5f0f\u62e6\u622a\u4e2d\uff0c\u5b83\u4eec\u4e0e sitekey \u4e00\u8d77\u4f4d\u4e8e\u9875\u9762\u81ea\u8eab\u7684\u6311\u6218\u9009\u9879\u5bf9\u8c61\u4e0a\u3002\u5b83\u4eec\u662f\u4e00\u6b21\u6027\u7684\uff0c\u4e14\u4e0e\u8be5\u6b21\u9875\u9762\u52a0\u8f7d\u7ed1\u5b9a\uff0c\u6240\u4ee5\u5e94\u5f53\u83b7\u53d6\u4e0e\u8bc6\u522b\u4e00\u5e76\u5b8c\u6210\uff0c\u800c\u4e0d\u8981\u7f13\u5b58\u3002<\/p>\n<pre data-enlighter-language=\"js\" class=\"EnlighterJSRAW\">const result = await solver.turnstile(sitekey, pageUrl, {\n  data: cData,             \/\/ the cData value\n  pagedata: chlPageData,   \/\/ the chlPageData value\n  action: 'managed',       \/\/ optional, when the page declares one\n});\n\nconsole.log(result.code);\nconsole.log(result.userAgent);   \/\/ required for the next step<\/pre>\n<h2 style=\"font-size:1.6rem;line-height:1.35;\">user agent \u4e0d\u662f\u53ef\u9009\u9879<\/h2>\n<p>Turnstile \u5c06 token \u4e0e\u751f\u6210\u5b83\u7684\u6d4f\u89c8\u5668\u6307\u7eb9\u7ed1\u5b9a\uff0c\u800c user agent \u662f\u8be5\u6307\u7eb9\u7684\u4e00\u90e8\u5206\u3002CapSkip \u4f1a\u8fd4\u56de\u5b83\u6240\u4f7f\u7528\u7684\u90a3\u4e2a\uff0c\u4f4d\u4e8e <code>result.userAgent<\/code>\u3002\u5982\u679c\u6539\u7528 Node \u9ed8\u8ba4\u7684 fetch user agent \u63d0\u4ea4 token\uff0cCloudflare \u5c31\u4f1a\u62d2\u7edd\u4e00\u4e2a\u672c\u6765\u5b8c\u5168\u6709\u6548\u7684 token\u3002<\/p>\n<p><code>userAgent<\/code> \u4ec5\u5728 Turnstile \u65f6\u624d\u4f1a\u88ab\u586b\u5145\u3002\u5bf9\u4e8e\u5176\u4ed6\u6240\u6709\u9a8c\u8bc1\u7801\u7c7b\u578b\u5b83\u90fd\u4e3a undefined\uff0c\u8fd9\u6b63\u662f\u590d\u7528\u73b0\u6210 reCAPTCHA \u8f85\u52a9\u4ee3\u7801\u7684\u4eba\u4f1a\u4e2d\u62db\u7684\u539f\u56e0\u3002<\/p>\n<pre data-enlighter-language=\"js\" class=\"EnlighterJSRAW\">const response = await fetch(pageUrl, {\n  method: 'POST',\n  headers: {\n    \/\/ Send back the exact user agent the solve was performed with.\n    'User-Agent': result.userAgent,\n    'Content-Type': 'application\/x-www-form-urlencoded',\n  },\n  body: new URLSearchParams({\n    'cf-turnstile-response': result.code,\n  }),\n});<\/pre>\n<p>\u5982\u679c token \u88ab\u62d2\u7edd\u800c cData \u662f\u65b0\u9c9c\u7684\uff0c\u90a3\u51e0\u4e4e\u80af\u5b9a\u5c31\u662f\u539f\u56e0\u6240\u5728\u3002<\/p>\n<h2 style=\"font-size:1.6rem;line-height:1.35;\">TypeScript<\/h2>\n<pre data-enlighter-language=\"js\" class=\"EnlighterJSRAW\">import { CapSkip, SolveResult } from 'capskip';\n\nconst solver = new CapSkip({ host: '127.0.0.1', port: 8080 });\nconst result: SolveResult = await solver.turnstile(sitekey, pageUrl);\n\n\/\/ userAgent is optional on the type, because only Turnstile populates it.\nif (result.userAgent) {\n  \/\/ safe to forward\n}<\/pre>\n<p>\u7c7b\u578b\u5b9a\u4e49\u968f\u5305\u4e00\u8d77\u63d0\u4f9b\uff0c\u56e0\u6b64\u65e0\u9700\u989d\u5916 <code>@types<\/code> \u5b89\u88c5\u3002\u4ee5\u4e0b\u9879\u4e0a\u7684\u53ef\u9009\u7c7b\u578b\u6807\u6ce8 <code>userAgent<\/code> \u662f\u4e00\u4e2a\u6709\u7528\u7684\u63d0\u9192\uff1a\u7f16\u8bd1\u5668\u4e0d\u4f1a\u8ba9\u4f60\u5fd8\u8bb0\u5176\u4ed6\u9a8c\u8bc1\u7801\u7c7b\u578b\u4f1a\u5c06\u5176\u7559\u7a7a\u3002<\/p>\n<h2 style=\"font-size:1.6rem;line-height:1.35;\">\u4ee3\u7406\u4e0e\u5e76\u53d1<\/h2>\n<pre data-enlighter-language=\"js\" class=\"EnlighterJSRAW\">\/\/ Solve through the same egress you will submit from.\nawait solver.turnstile(sitekey, pageUrl, {\n  data: cData,\n  pagedata: chlPageData,\n  proxy: { type: 'HTTPS', uri: 'user:pass@1.2.3.4:3128' },\n});\n\n\/\/ Several at once.\nconst results = await Promise.all(targets.map((t) =&gt;\n  solver.turnstile(t.sitekey, t.url)));<\/pre>\n<p>\u4ee3\u7406\u9002\u7528\u4e8e Turnstile\u3001reCAPTCHA \u548c\u6781\u9a8c\uff0c\u4f46\u4e0d\u9002\u7528\u4e8e\u56fe\u7247\u9a8c\u8bc1\u7801\uff0c\u56e0\u4e3a\u56fe\u7247\u9a8c\u8bc1\u7801\u4ece\u4e0d\u4e0e\u76ee\u6807\u7ad9\u70b9\u4ea4\u4e92\u3002\u5bf9\u4e8e\u6311\u6218\u9875\u9762\uff0c\u6bcf\u6b21\u8bc6\u522b\u90fd\u9700\u8981\u5404\u81ea\u65b0\u83b7\u53d6\u7684 cData\uff0c\u56e0\u6b64\u5e94\u5728\u6620\u5c04\u51fd\u6570\u5185\u90e8\u83b7\u53d6\uff0c\u800c\u4e0d\u662f\u4e8b\u5148\u6279\u91cf\u83b7\u53d6\u3002<\/p>\n<h2 style=\"font-size:1.6rem;line-height:1.35;\">\u5e38\u89c1\u95ee\u9898<\/h2>\n<details style=\"border:1px solid #e2e5ee;border-radius:10px;padding:14px 18px;margin:0 0 12px;\">\n<summary style=\"cursor:pointer;\">\n<h3 style=\"font-size:1.15rem;line-height:1.4;display:inline;margin:0;\">\u5c0f\u7ec4\u4ef6\u9700\u8981 cData \u5417\uff1f<\/h3>\n<\/summary>\n<p style=\"margin:12px 0 0;\">\u4e0d\u9700\u8981\uff0c\u800c\u4e14\u4f20\u5165\u7a7a\u503c\u53ea\u4f1a\u5bfc\u81f4\u8bc6\u522b\u5931\u8d25\uff0c\u800c\u4e0d\u4f1a\u6709\u4efb\u4f55\u5e2e\u52a9\u3002\u53ea\u6709\u6574\u9875\u63d2\u9875\u5f0f\u6311\u6218\u624d\u4f1a\u7528\u5230\u5b83\u4eec\u3002<\/p>\n<\/details>\n<details style=\"border:1px solid #e2e5ee;border-radius:10px;padding:14px 18px;margin:0 0 12px;\">\n<summary style=\"cursor:pointer;\">\n<h3 style=\"font-size:1.15rem;line-height:1.4;display:inline;margin:0;\">token \u770b\u8d77\u6765\u6ca1\u95ee\u9898\uff0c\u4f46\u7f51\u7ad9\u5374\u62d2\u7edd\u5b83\u3002<\/h3>\n<\/summary>\n<p style=\"margin:12px 0 0;\">\u51e0\u4e4e\u603b\u662f user agent \u7684\u95ee\u9898\u3002\u8bf7\u4f7f\u7528 <code>result.userAgent<\/code> \u63d0\u4ea4\uff0c\u800c\u4e0d\u662f\u4f7f\u7528\u4f60\u7684 HTTP \u5ba2\u6237\u7aef\u9ed8\u8ba4\u53d1\u9001\u7684\u90a3\u4e2a\u3002\u7b2c\u4e8c\u53ef\u80fd\u7684\u539f\u56e0\u662f\u8fc7\u671f\u7684 cData\uff0c\u5b83\u4e0e\u5355\u6b21\u9875\u9762\u52a0\u8f7d\u7ed1\u5b9a\u3002<\/p>\n<\/details>\n<details style=\"border:1px solid #e2e5ee;border-radius:10px;padding:14px 18px;margin:0 0 12px;\">\n<summary style=\"cursor:pointer;\">\n<h3 style=\"font-size:1.15rem;line-height:1.4;display:inline;margin:0;\">\u6211\u53ef\u4ee5\u5c06\u5b83\u4e0e Puppeteer \u4e00\u8d77\u4f7f\u7528\u5417\uff1f<\/h3>\n<\/summary>\n<p style=\"margin:12px 0 0;\">\u53ef\u4ee5\uff0c\u800c\u4e14\u914d\u5408\u5f97\u5f88\u597d\uff1a\u7528\u4ee5\u4e0b\u65b9\u5f0f\u4ece\u5df2\u52a0\u8f7d\u7684\u9875\u9762\u8bfb\u53d6 cData <code>page.evaluate<\/code>\uff0c\u7528\u672c SDK \u8fdb\u884c\u8bc6\u522b\uff0c\u7136\u540e\u5728\u7ee7\u7eed\u4e4b\u524d\u5c06\u76f8\u540c\u7684 user agent \u8bbe\u7f6e\u5230\u9875\u9762\u4e0a\u3002\u6211\u4eec\u7684 <a href=\"https:\/\/capskip.com\/zh\/nodejs-captcha-solver\/\">Node.js \u9a8c\u8bc1\u7801\u8bc6\u522b<\/a> \u9875\u9762\u4ecb\u7ecd\u4e86\u81ea\u52a8\u5316\u65b9\u9762\u7684\u5185\u5bb9\u3002<\/p>\n<\/details>\n<h2 style=\"font-size:1.6rem;line-height:1.35;\">\u5c0f\u7ed3<\/h2>\n<p>\u5c0f\u7ec4\u4ef6\u9700\u8981\u4e00\u4e2a sitekey \u548c\u4e00\u4e2a URL\u3002\u6311\u6218\u9875\u9762\u9700\u8981 <code>data<\/code> \u548c <code>pagedata<\/code> \u4ece\u9875\u9762\u5b9e\u65f6\u8bfb\u53d6\uff0c\u5e76\u4e14 token \u5fc5\u987b\u8fde\u540c\u4ee5\u4e0b\u5185\u5bb9\u4e00\u8d77\u63d0\u4ea4\uff1a <code>result.userAgent<\/code>\u3002\u5176\u4f59\u90fd\u662f\u666e\u901a\u7684 Promise \u5904\u7406\u3002<\/p>\n<p>\u5176\u4ed6\u8bed\u8a00\u89c1 <a href=\"https:\/\/capskip.com\/zh\/cloudflare-turnstile-solver\/\">Cloudflare Turnstile \u8bc6\u522b<\/a> \u9875\u9762\uff0c\u53c2\u6570\u7ec6\u8282\u89c1 <a href=\"https:\/\/capskip.com\/zh\/api-docs\/\">API \u6587\u6863<\/a>\uff0c\u66f4\u5168\u9762\u7684 Node \u63a5\u53e3\u89c1 <a href=\"https:\/\/capskip.com\/zh\/nodejs-captcha-solver\/\">Node.js \u9a8c\u8bc1\u7801\u8bc6\u522b<\/a> \u9875\u9762\u3002CapSkip \u662f\u4e00\u6b3e <a href=\"https:\/\/capskip.com\/zh\/\">\u65e0\u9650\u91cf\u9a8c\u8bc1\u7801\u8bc6\u522b\u5de5\u5177<\/a> \uff0c\u5b83\u8fd0\u884c\u5728\u4f60\u81ea\u5df1\u7684\u786c\u4ef6\u4e0a\u3002<\/p>","protected":false},"excerpt":{"rendered":"<p>Turnstile \u5c0f\u7ec4\u4ef6\u5728 Node.js \u4e2d\u662f\u4e00\u4e2a\u53cc\u53c2\u6570\u8c03\u7528\u3002\u5b8c\u6574\u7684\u6311\u6218\u9875\u9762\u9700\u8981\u53e6\u5916\u4e24\u4e2a\u503c\u4ee5\u53ca\u968f token \u8fd4\u56de\u7684 user agent\u3002<\/p>","protected":false},"author":1,"featured_media":24976,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"rank_math_title":"Solve Cloudflare Turnstile in Node.js | CapSkip","rank_math_description":"Turnstile widgets take a sitekey. Challenge pages also need cData, chlPageData and the returned user agent. Here is the Node.js code for both cases.","rank_math_focus_keyword":"solve cloudflare turnstile in node.js","footnotes":""},"categories":[70],"tags":[],"class_list":["post-24977","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-captcha"],"_links":{"self":[{"href":"https:\/\/capskip.com\/zh\/wp-json\/wp\/v2\/posts\/24977","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/capskip.com\/zh\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/capskip.com\/zh\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/capskip.com\/zh\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/capskip.com\/zh\/wp-json\/wp\/v2\/comments?post=24977"}],"version-history":[{"count":1,"href":"https:\/\/capskip.com\/zh\/wp-json\/wp\/v2\/posts\/24977\/revisions"}],"predecessor-version":[{"id":24994,"href":"https:\/\/capskip.com\/zh\/wp-json\/wp\/v2\/posts\/24977\/revisions\/24994"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/capskip.com\/zh\/wp-json\/wp\/v2\/media\/24976"}],"wp:attachment":[{"href":"https:\/\/capskip.com\/zh\/wp-json\/wp\/v2\/media?parent=24977"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/capskip.com\/zh\/wp-json\/wp\/v2\/categories?post=24977"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/capskip.com\/zh\/wp-json\/wp\/v2\/tags?post=24977"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}