[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"blog-strapi-article:zh:cursor-claude-code-openai-sdk-proxy-settings":3,"blog-article:\u002Fblog\u002Fcursor-claude-code-openai-sdk-proxy-settings":73,"blog-related:\u002Fblog\u002Fcursor-claude-code-openai-sdk-proxy-settings":721,"blog-translations:\u002Fblog\u002Fcursor-claude-code-openai-sdk-proxy-settings":722},{"available":4,"article":5,"relatedArticles":283,"translations":591},true,{"source":6,"id":7,"documentId":8,"translationKey":8,"locale":9,"slug":10,"path":11,"_path":11,"title":12,"description":13,"excerpt":13,"image":14,"publishedAt":15,"updatedAt":16,"author":17,"tags":18,"featured":19,"sortOrder":20,"readingTime":21,"bodyType":22,"bodyBlocks":23,"bodyHtml":111},"strapi",1197,"i0p72io16ptcau2yymxyhaib","zh","cursor-claude-code-openai-sdk-proxy-settings","\u002Fblog\u002Fcursor-claude-code-openai-sdk-proxy-settings","Cursor、Claude Code、OpenAI SDK 怎么配置代理？","Cursor、Claude Code、OpenAI SDK 配置代理时，先判断请求来自系统、终端、IDE 还是 SDK。CLI、IDE 和 SDK 都能复现出口后，再比较代理 IP 类型和长期使用方案。","https:\u002F\u002Fcms.quanqiudaili.com\u002Fuploads\u002Flarge_cursor_claude_code_openai_sdk_proxy_settings_cover_1944c8e251.webp","2026-07-16T06:21:07.178Z","2026-07-16T06:21:07.152Z","Global Proxies Team",[],false,0,5,"blocks",[24,30,35,41,45,49,53,57,61,112,116,120,124,128,132,137,141,145,149,153,188,192,196,200,235,239,243,247,251,255,259,263,267,271,275,279],{"type":25,"children":26},"paragraph",[27],{"text":28,"type":29},"Cursor、Claude Code、OpenAI SDK 做本地开发环境代理配置时，第一步先确认请求到底走哪一层：系统代理、环境变量、IDE 设置，还是 SDK 参数。排查阶段只保留一层代理配置；多层同时开，常见结果是浏览器能通、CLI 或 SDK 仍然走本地出口。","text",{"type":31,"children":32},"code",[33],{"text":34,"type":29},"| 请求来源 | 优先检查 | 常见差异 |\n| --- | --- | --- |\n| 浏览器、桌面软件一起访问 | 系统代理 | 覆盖面广，但 CLI\u002FSDK 不一定继承 |\n| Claude Code、curl、npm 或本地脚本在终端里运行 | `HTTP_PROXY` \u002F `HTTPS_PROXY` 环境变量 | 只影响当前终端和它启动的子进程，变量残留最常见 |\n| Cursor 内置请求、插件或扩展访问接口 | IDE 代理设置 | IDE 设置和终端环境变量可能互不继承 |\n| OpenAI SDK 或项目代码发起请求 | SDK 参数或代码运行环境 | 最适合单个服务固定出口，但密钥和代理密码不要写进仓库 |",{"type":36,"level":37,"children":38},"heading",2,[39],{"text":40,"type":29},"OpenAI SDK 配置代理前，先分清 Cursor、Claude Code 的请求出口",{"type":25,"children":42},[43],{"text":44,"type":29},"`CLI` 是在终端里运行的命令行工具，通常会读取当前终端的环境变量。`IDE` 是 Cursor 这类开发工具，可能有自己的代理设置和插件请求。`SDK` 是代码里调用模型或接口的客户端，很多时候需要在程序参数或运行环境里单独配置代理。",{"type":25,"children":46},[47],{"text":48,"type":29},"排查时先把 CLI、IDE 和 SDK 分开测：CLI 看当前终端变量，IDE 看内置代理设置，SDK 看代码运行环境和客户端参数。",{"type":36,"level":37,"children":50},[51],{"text":52,"type":29},"本地开发环境代理配置，先确认请求从系统、终端、IDE 还是 SDK 发出",{"type":25,"children":54},[55],{"text":56,"type":29},"单人本地调试，通常先定 CLI 或 SDK 层；团队共享出口、还要长期保持同地区时，再考虑静态住宅代理 IP。\n采购前把 IDE、终端、环境变量、SDK 自身代理的优先级写清楚，再确认是否多人共用同一出口。",{"type":25,"children":58},[59],{"text":60,"type":29},"下面这张图用于把本地开发代理配置按系统、环境变量、IDE 和 SDK 四层拆开，先定位请求到底从哪一层发出。",{"type":62,"image":63,"children":109},"image",{"id":64,"ext":65,"url":66,"hash":67,"mime":68,"name":69,"size":70,"width":71,"height":72,"caption":73,"formats":74,"provider":106,"createdAt":107,"updatedAt":107,"documentId":108,"focalPoint":73,"previewUrl":73,"publishedAt":107,"alternativeText":73,"provider_metadata":73},1043,".webp","https:\u002F\u002Fcms.quanqiudaili.com\u002Fuploads\u002Flarge_cursor_claude_code_openai_sdk_proxy_settings_1_b9f2b7b85f47_9a6f907683.webp","cursor_claude_code_openai_sdk_proxy_settings_1_b9f2b7b85f47_9a6f907683","image\u002Fwebp","cursor-claude-code-openai-sdk-proxy-settings-1-b9f2b7b85f47.webp",47.62,1280,720,null,{"large":75,"small":82,"medium":90,"thumbnail":98},{"ext":65,"url":66,"hash":76,"mime":68,"name":77,"path":73,"size":78,"width":79,"height":80,"sizeInBytes":81},"large_cursor_claude_code_openai_sdk_proxy_settings_1_b9f2b7b85f47_9a6f907683","large_cursor-claude-code-openai-sdk-proxy-settings-1-b9f2b7b85f47.webp",32.08,1000,562,32078,{"ext":65,"url":83,"hash":84,"mime":68,"name":85,"path":73,"size":86,"width":87,"height":88,"sizeInBytes":89},"https:\u002F\u002Fcms.quanqiudaili.com\u002Fuploads\u002Fsmall_cursor_claude_code_openai_sdk_proxy_settings_1_b9f2b7b85f47_9a6f907683.webp","small_cursor_claude_code_openai_sdk_proxy_settings_1_b9f2b7b85f47_9a6f907683","small_cursor-claude-code-openai-sdk-proxy-settings-1-b9f2b7b85f47.webp",13.55,500,281,13552,{"ext":65,"url":91,"hash":92,"mime":68,"name":93,"path":73,"size":94,"width":95,"height":96,"sizeInBytes":97},"https:\u002F\u002Fcms.quanqiudaili.com\u002Fuploads\u002Fmedium_cursor_claude_code_openai_sdk_proxy_settings_1_b9f2b7b85f47_9a6f907683.webp","medium_cursor_claude_code_openai_sdk_proxy_settings_1_b9f2b7b85f47_9a6f907683","medium_cursor-claude-code-openai-sdk-proxy-settings-1-b9f2b7b85f47.webp",22.86,750,422,22864,{"ext":65,"url":99,"hash":100,"mime":68,"name":101,"path":73,"size":102,"width":103,"height":104,"sizeInBytes":105},"https:\u002F\u002Fcms.quanqiudaili.com\u002Fuploads\u002Fthumbnail_cursor_claude_code_openai_sdk_proxy_settings_1_b9f2b7b85f47_9a6f907683.webp","thumbnail_cursor_claude_code_openai_sdk_proxy_settings_1_b9f2b7b85f47_9a6f907683","thumbnail_cursor-claude-code-openai-sdk-proxy-settings-1-b9f2b7b85f47.webp",5.09,245,138,5088,"local","2026-07-14T04:16:08.448Z","dtw0r9yl98wyj33uvrkqi56z",[110],{"text":111,"type":29},"",{"type":36,"level":37,"children":113},[114],{"text":115,"type":29},"系统代理、环境变量和 SDK 参数同时开，为什么容易排错？",{"type":25,"children":117},[118],{"text":119,"type":29},"本地偶发测试，先看程序代理；很多 CLI、SDK、IDE 会优先读自身设置，系统代理开着也可能不走同一出口。\n需要让终端里一批命令共用同一出口时，再用环境变量。它比系统代理更可控，适合联调和复现；但变量残留最常见，昨天能用、今天异常，可能是不同进程吃到了不同配置。\n只有浏览器、桌面工具都要一起走代理时，系统代理才有价值。它覆盖面广，但最容易和程序代理叠加。",{"type":36,"level":37,"children":121},[122],{"text":123,"type":29},"Cursor、Claude Code、OpenAI SDK 代理配置最小示例",{"type":25,"children":125},[126],{"text":127,"type":29},"下面示例里的 `proxy.example.com`、`10000`、`user`、`pass` 需要替换成实际代理 IP 接入信息。表格重点看每一层的适用边界和容易漏掉的地方。",{"type":31,"children":129},[130],{"text":131,"type":29},"| 配置层级 | 最小示例 | 适合场景 | 注意点 |\n| --- | --- | --- | --- |\n| 系统代理 | Windows 设置里填写 `http:\u002F\u002Fuser:pass@proxy.example.com:10000` | 浏览器和桌面工具一起走代理 | 很多 CLI\u002FSDK 不一定继承系统代理，仍要单独验证 |\n| `HTTP_PROXY` \u002F `HTTPS_PROXY` | PowerShell：`$env:HTTP_PROXY=\"http:\u002F\u002Fuser:pass@proxy.example.com:10000\"`；`$env:HTTPS_PROXY=$env:HTTP_PROXY` | 终端、CLI、部分 SDK 联调 | 变量只对当前终端和子进程生效；换窗口后要重新设置 |\n| SDK 参数 | 在请求客户端里显式传入 `http:\u002F\u002Fuser:pass@proxy.example.com:10000` | 单个脚本或服务需要固定出口 | 不要把代理账号密码提交到代码仓库，优先读环境变量 |\n| IDE 设置 | 在 Cursor 或 IDE 的代理设置里填写同一个代理地址 | IDE 内置请求、插件或扩展需要走代理 | IDE 设置和终端环境变量可能互不继承，要分别测试 |",{"type":36,"level":133,"children":134},3,[135],{"text":136,"type":29},"配置后先验证出口 IP 是否变化",{"type":25,"children":138},[139],{"text":140,"type":29},"验证代理出口是否生效时，可以先在同一个终端里直接访问出口 IP 查询接口，记录本机公网 IP；再用 `curl -x http:\u002F\u002Fuser:pass@proxy.example.com:10000 https:\u002F\u002Fip.quanqiudaili.com` 带代理访问同一个接口。如果返回的出口 IP 与本机公网 IP 不同，说明代理出口已经生效；如果仍然显示本地 IP，优先检查账号密码、协议、端口，以及当前工具是否真的读取了这层代理配置。测试 OpenAI SDK、Claude Code 或 Cursor 时，也建议使用同一个代理账号和同一段最小请求复测错误码，避免把网络出口问题和 API 参数问题混在一起判断。",{"type":36,"level":37,"children":142},[143],{"text":144,"type":29},"HTTP\u002FHTTPS 和 SOCKS5 代理该先测哪一种？",{"type":25,"children":146},[147],{"text":148,"type":29},"只做网页访问、接口调试和大多数 AI 工具联调，先选 HTTP\u002FHTTPS；兼容性更高，排查也更直接。限制是遇到部分客户端或长连接任务，表现未必稳定；协议差异拿不准时，可以对照 [HTTP\u002FHTTPS\u002FSOCKS5 协议选型](https:\u002F\u002Fwww.quanqiudaili.com\u002Fblog\u002Fhttp-https-socks5-proxy-selection)。\n如果同一套代理 IP 还要给终端工具、下载器或更多非网页流量共用，再试 SOCKS5。它覆盖面更广，但要额外确认程序是否认协议、认证是否接上。\n采购前别只问支不支持 HTTP\u002FSOCKS5，要测目标工具是否原生兼容、认证方式是否一致、环境变量是否被 CLI\u002FSDK 读取、切换协议后请求出口是否真的变化。",{"type":25,"children":150},[151],{"text":152,"type":29},"下面这张图用于对比 HTTP、HTTPS 和 SOCKS5 在 CLI、IDE、SDK 里的适配差异，帮助你先选兼容性最高的接入方式。",{"type":62,"image":154,"children":186},{"id":155,"ext":65,"url":156,"hash":157,"mime":68,"name":158,"size":159,"width":71,"height":72,"caption":73,"formats":160,"provider":106,"createdAt":184,"updatedAt":184,"documentId":185,"focalPoint":73,"previewUrl":73,"publishedAt":184,"alternativeText":73,"provider_metadata":73},1044,"https:\u002F\u002Fcms.quanqiudaili.com\u002Fuploads\u002Flarge_cursor_claude_code_openai_sdk_proxy_settings_2_53b03452e68c_9f088ff1bf.webp","cursor_claude_code_openai_sdk_proxy_settings_2_53b03452e68c_9f088ff1bf","cursor-claude-code-openai-sdk-proxy-settings-2-53b03452e68c.webp",44.12,{"large":161,"small":166,"medium":172,"thumbnail":178},{"ext":65,"url":156,"hash":162,"mime":68,"name":163,"path":73,"size":164,"width":79,"height":80,"sizeInBytes":165},"large_cursor_claude_code_openai_sdk_proxy_settings_2_53b03452e68c_9f088ff1bf","large_cursor-claude-code-openai-sdk-proxy-settings-2-53b03452e68c.webp",29.7,29700,{"ext":65,"url":167,"hash":168,"mime":68,"name":169,"path":73,"size":170,"width":87,"height":88,"sizeInBytes":171},"https:\u002F\u002Fcms.quanqiudaili.com\u002Fuploads\u002Fsmall_cursor_claude_code_openai_sdk_proxy_settings_2_53b03452e68c_9f088ff1bf.webp","small_cursor_claude_code_openai_sdk_proxy_settings_2_53b03452e68c_9f088ff1bf","small_cursor-claude-code-openai-sdk-proxy-settings-2-53b03452e68c.webp",12.85,12852,{"ext":65,"url":173,"hash":174,"mime":68,"name":175,"path":73,"size":176,"width":95,"height":96,"sizeInBytes":177},"https:\u002F\u002Fcms.quanqiudaili.com\u002Fuploads\u002Fmedium_cursor_claude_code_openai_sdk_proxy_settings_2_53b03452e68c_9f088ff1bf.webp","medium_cursor_claude_code_openai_sdk_proxy_settings_2_53b03452e68c_9f088ff1bf","medium_cursor-claude-code-openai-sdk-proxy-settings-2-53b03452e68c.webp",21.02,21016,{"ext":65,"url":179,"hash":180,"mime":68,"name":181,"path":73,"size":182,"width":103,"height":104,"sizeInBytes":183},"https:\u002F\u002Fcms.quanqiudaili.com\u002Fuploads\u002Fthumbnail_cursor_claude_code_openai_sdk_proxy_settings_2_53b03452e68c_9f088ff1bf.webp","thumbnail_cursor_claude_code_openai_sdk_proxy_settings_2_53b03452e68c_9f088ff1bf","thumbnail_cursor-claude-code-openai-sdk-proxy-settings-2-53b03452e68c.webp",5.21,5210,"2026-07-14T04:16:09.008Z","jjpg9v9yriucupp5cb14p072",[187],{"text":111,"type":29},{"type":25,"children":189},[190],{"text":191,"type":29},"看完之后，先用目标工具实际请求验证协议是否生效，再记录超时、407 或出口不变发生在哪一层。",{"type":36,"level":37,"children":193},[194],{"text":195,"type":29},"407、超时和地区不对，先查代理配置层级",{"type":25,"children":197},[198],{"text":199,"type":29},"连不上、407 认证失败、超时或地区不对时，按现象定位：407 多半先查账号密码、认证格式和端口；超时先查协议是否被目标工具支持；出口 IP 没变，先查当前工具到底读取系统代理、环境变量还是 SDK 参数。报错集中在登录、验证码变多或会话频繁失效时，再看出口稳定性和使用方式；如果已经能连通但 API 返回 403 或地区不可用，再分别对照 [OpenAI API 403 排查](https:\u002F\u002Fwww.quanqiudaili.com\u002Fblog\u002Fopenai-api-403-unsupported-country-proxy) 和 [Claude\u002FGemini 地区不可用](https:\u002F\u002Fwww.quanqiudaili.com\u002Fblog\u002Fclaude-gemini-google-ai-studio-region-proxy)。\n临时测试可先试机房代理 IP 或 [动态住宅代理 IP](https:\u002F\u002Fwww.quanqiudaili.com\u002Fproduct\u002Fdynamic-residential)；长期登录、固定地区、多人协作更该看 [静态住宅代理 IP](https:\u002F\u002Fwww.quanqiudaili.com\u002Fproduct\u002Fstatic-residential-standard)。\n下面这张图用于把 Cursor、Claude Code 和 OpenAI SDK 的代理层级关系放在一起看，适合排查“浏览器能用但 SDK 不走代理”的情况。",{"type":62,"image":201,"children":233},{"id":202,"ext":65,"url":203,"hash":204,"mime":68,"name":205,"size":206,"width":71,"height":72,"caption":73,"formats":207,"provider":106,"createdAt":231,"updatedAt":231,"documentId":232,"focalPoint":73,"previewUrl":73,"publishedAt":231,"alternativeText":73,"provider_metadata":73},1045,"https:\u002F\u002Fcms.quanqiudaili.com\u002Fuploads\u002Flarge_cursor_claude_code_openai_sdk_proxy_settings_3_7a8d1107c83b_bfae19cd48.webp","cursor_claude_code_openai_sdk_proxy_settings_3_7a8d1107c83b_bfae19cd48","cursor-claude-code-openai-sdk-proxy-settings-3-7a8d1107c83b.webp",34.04,{"large":208,"small":213,"medium":219,"thumbnail":225},{"ext":65,"url":203,"hash":209,"mime":68,"name":210,"path":73,"size":211,"width":79,"height":80,"sizeInBytes":212},"large_cursor_claude_code_openai_sdk_proxy_settings_3_7a8d1107c83b_bfae19cd48","large_cursor-claude-code-openai-sdk-proxy-settings-3-7a8d1107c83b.webp",23.11,23114,{"ext":65,"url":214,"hash":215,"mime":68,"name":216,"path":73,"size":217,"width":87,"height":88,"sizeInBytes":218},"https:\u002F\u002Fcms.quanqiudaili.com\u002Fuploads\u002Fsmall_cursor_claude_code_openai_sdk_proxy_settings_3_7a8d1107c83b_bfae19cd48.webp","small_cursor_claude_code_openai_sdk_proxy_settings_3_7a8d1107c83b_bfae19cd48","small_cursor-claude-code-openai-sdk-proxy-settings-3-7a8d1107c83b.webp",9.6,9602,{"ext":65,"url":220,"hash":221,"mime":68,"name":222,"path":73,"size":223,"width":95,"height":96,"sizeInBytes":224},"https:\u002F\u002Fcms.quanqiudaili.com\u002Fuploads\u002Fmedium_cursor_claude_code_openai_sdk_proxy_settings_3_7a8d1107c83b_bfae19cd48.webp","medium_cursor_claude_code_openai_sdk_proxy_settings_3_7a8d1107c83b_bfae19cd48","medium_cursor-claude-code-openai-sdk-proxy-settings-3-7a8d1107c83b.webp",16.37,16366,{"ext":65,"url":226,"hash":227,"mime":68,"name":228,"path":73,"size":229,"width":103,"height":104,"sizeInBytes":230},"https:\u002F\u002Fcms.quanqiudaili.com\u002Fuploads\u002Fthumbnail_cursor_claude_code_openai_sdk_proxy_settings_3_7a8d1107c83b_bfae19cd48.webp","thumbnail_cursor_claude_code_openai_sdk_proxy_settings_3_7a8d1107c83b_bfae19cd48","thumbnail_cursor-claude-code-openai-sdk-proxy-settings-3-7a8d1107c83b.webp",3.82,3818,"2026-07-14T04:16:09.412Z","vser8lah6nz6hzsz552xlaaj",[234],{"text":111,"type":29},{"type":25,"children":236},[237],{"text":238,"type":29},"看完之后，如果浏览器能用但 SDK 仍走本地出口，优先查 SDK 参数和启动它的终端环境变量；如果 Cursor 内置请求异常，优先查 IDE 自身代理设置。",{"type":36,"level":37,"children":240},[241],{"text":242,"type":29},"FAQ",{"type":36,"level":133,"children":244},[245],{"text":246,"type":29},"长期登录该选哪类代理 IP",{"type":25,"children":248},[249],{"text":250,"type":29},"做店铺后台、广告账户或社媒账号，优先测静态住宅代理 IP。",{"type":36,"level":133,"children":252},[253],{"text":254,"type":29},"只做短时访问，有必要上住宅代理 IP 吗",{"type":25,"children":256},[257],{"text":258,"type":29},"查页面、做公开访问测试，先比较机房代理 IP 和动态住宅代理 IP。",{"type":36,"level":133,"children":260},[261],{"text":262,"type":29},"代理 IP 稳定，为什么还是被封或验证增多",{"type":25,"children":264},[265],{"text":266,"type":29},"同步记录账号行为、浏览器指纹、登录频率、多人协作方式和工具层级。",{"type":36,"level":133,"children":268},[269],{"text":270,"type":29},"浏览器已经能用代理了，OpenAI SDK 还需要单独配置吗？",{"type":25,"children":272},[273],{"text":274,"type":29},"多数情况下还需要，SDK 往往走终端、系统环境变量或程序自身的代理设置。",{"type":25,"children":276},[277],{"text":278,"type":29},"---",{"type":25,"children":280},[281],{"text":282,"type":29},"上线前先用同一段脚本分别测试 CLI、IDE 和 SDK，确认请求出口、错误码、协议和端口都能复现。\n若你还在比对不同本地开发环境代理配置的适配边界，可以先看[了解全球代理服务](https:\u002F\u002Fwww.quanqiudaili.com\u002F)，再结合官网购买页、后台展示或客户经理确认具体方案；已经进入接入设置阶段，可以继续看 [全球代理 FAQ](https:\u002F\u002Fhelp.quanqiudaili.com\u002Fdocs\u002FFaq\u002F) 和 [代理设置帮助](https:\u002F\u002Fhelp.quanqiudaili.com\u002Fdocs\u002Fproxy-Settings)。",[284,371,485],{"source":6,"id":285,"documentId":286,"translationKey":286,"locale":9,"slug":287,"path":288,"_path":288,"title":289,"description":290,"excerpt":290,"image":291,"publishedAt":292,"updatedAt":293,"author":17,"tags":294,"featured":19,"sortOrder":20,"readingTime":295,"bodyType":22,"bodyBlocks":296,"bodyHtml":111},2175,"hioeqohoh99p55q3dp4molr2","proxy-check-failed-troubleshooting","\u002Fblog\u002Fproxy-check-failed-troubleshooting","指纹浏览器代理 IP 检测失败的通用排查清单","指纹浏览器代理 IP 检测失败时，先核对协议、主机、端口、账号密码和配置启用状态，再用 curl 或其他客户端对照，区分字段错误、网络不可达和浏览器规则冲突。","https:\u002F\u002Fcms.quanqiudaili.com\u002Fuploads\u002Flarge_ip_cover_1_3ab32dc39c.webp","2026-08-24T08:20:59.237Z","2026-08-24T08:20:59.221Z",[],1,[297,301,305,309,313,317,321,325,329,333,337,340,344,348,352,356,359,363,367],{"type":25,"children":298},[299],{"text":300,"type":29},"指纹浏览器显示代理检测失败，不等于代理资源必然不可用。应先核对配置文件中的协议、主机、端口和认证，再用外部工具复测，区分字段错误、网络不可达和检测规则差异。",{"type":36,"level":37,"children":302},[303],{"text":304,"type":29},"配置文件中的协议、主机、端口和认证是否正确？",{"type":25,"children":306},[307],{"text":308,"type":29},"打开出现问题的浏览器配置文件，重新填写 HTTP、HTTPS 或 SOCKS5 协议、主机、端口、用户名和密码。不要把 API 链接或 `IP:端口` 整段粘贴到单独字段中。保存后完全关闭并重新打开该配置文件。",{"type":25,"children":310},[311],{"text":312,"type":29},"指纹浏览器通常按配置文件单独保存代理，不一定跟随系统代理。只有一个配置文件失败时，应先对比另一配置文件，而不是直接判断整组代理资源失效。",{"type":36,"level":37,"children":314},[315],{"text":316,"type":29},"外部工具成功但指纹浏览器失败说明什么？",{"type":25,"children":318},[319],{"text":320,"type":29},"在 curl、系统网络工具或另一客户端中使用同一组主机、端口、协议和凭据测试。外部工具成功而指纹浏览器失败，重点查配置文件是否启用代理、扩展冲突和客户端字段映射。",{"type":31,"children":322},[323],{"text":324,"type":29},"| 现象 | 优先检查 | 结论 |\n|---|---|---|\n| 配置保存后仍显示本地 IP | 配置文件是否启用代理 | 请求可能没有经过代理 |\n| 返回 407 | 用户名、密码和认证方式 | 连接已到达入口但认证失败 |\n| 外部工具成功、浏览器失败 | 配置文件、扩展、规则 | 指纹浏览器接管范围异常 |\n| 出口 IP 正确但目标站异常 | 时区、语言、WebRTC 和站点规则 | 不一定是代理检测失败 |",{"type":36,"level":37,"children":326},[327],{"text":328,"type":29},"出口 IP 通过后还要检查哪些浏览器环境？",{"type":25,"children":330},[331],{"text":332,"type":29},"代理检测通过后，再检查浏览器时区、语言、DNS 和 WebRTC 是否与出口地区明显冲突。不要为了“检测通过”同时更换账号、设备和代理，否则无法判断是哪一项导致结果变化。",{"type":25,"children":334},[335],{"text":336,"type":29},"检测失败与目标平台验证码是两个问题：前者先查配置和代理连通，后者再查账号历史、设备环境和行为风险。长期登录可评估[静态住宅代理 IP](https:\u002F\u002Fwww.quanqiudaili.com\u002Fproduct\u002Fstatic-residential-standard)，多地区短时访问可了解[动态住宅代理 IP](https:\u002F\u002Fwww.quanqiudaili.com\u002Fproduct\u002Fdynamic-residential)。",{"type":36,"level":37,"children":338},[339],{"text":242,"type":29},{"type":36,"level":133,"children":341},[342],{"text":343,"type":29},"为什么出口 IP 正确，平台仍提示异常？",{"type":25,"children":345},[346],{"text":347,"type":29},"平台还会检查时区、语言、设备指纹、Cookie、账号历史和行为节奏。检测页通过只代表基础出口可见。",{"type":36,"level":133,"children":349},[350],{"text":351,"type":29},"提交给服务商前准备什么？",{"type":25,"children":353},[354],{"text":355,"type":29},"准备配置文件名称、目标站、协议、主机和端口、错误码、测试时间及截图；密码不要公开发送。",{"type":25,"children":357},[358],{"text":278,"type":29},{"type":36,"level":37,"children":360},[361],{"text":362,"type":29},"指纹浏览器代理 IP 检测失败时应该按什么顺序排查？",{"type":25,"children":364},[365],{"text":366,"type":29},"按“配置字段 → 认证方式 → 外部对照 → 浏览器环境 → 目标站规则”的顺序排查，能区分代理资源问题和指纹浏览器配置问题。",{"type":25,"children":368},[369],{"text":370,"type":29},"配置后仍失败时，可按上方清单整理脱敏信息，再通过[全球代理 FAQ](https:\u002F\u002Fhelp.quanqiudaili.com\u002Fdocs\u002FFaq\u002F)继续排查。",{"source":6,"id":372,"documentId":373,"translationKey":373,"locale":9,"slug":374,"path":375,"_path":375,"title":376,"description":377,"excerpt":377,"image":378,"publishedAt":379,"updatedAt":380,"author":17,"tags":381,"featured":19,"sortOrder":20,"readingTime":295,"bodyType":22,"bodyBlocks":382,"bodyHtml":111},2133,"mxzjklqnw9bjlkwm3k4xwspl","ping-proxy-proxy-ip-guide","\u002Fblog\u002Fping-proxy-proxy-ip-guide","端口能 ping 通但代理不能用，是不是协议填错了？","主机能 ping 通不代表代理 IP 可用。通过 TCP 端口测试、HTTP\u002FHTTPS\u002FSOCKS5 协议核对、认证结果和目标网站对照，逐层定位连接失败原因。","https:\u002F\u002Fcms.quanqiudaili.com\u002Fuploads\u002Flarge_ping_cover_1_bbcb1574f4.webp","2026-08-20T09:26:43.967Z","2026-08-20T09:26:43.947Z",[],[383,387,391,395,399,403,407,411,415,419,423,427,431,435,438,442,446,450,454,458,462,466,470,473,477,481],{"type":25,"children":384},[385],{"text":386,"type":29},"协议填错是常见原因，但 ping 通并不能证明代理可用。ping 使用 ICMP，只能说明主机可能响应；代理还要通过指定 TCP 端口完成协议握手和认证。",{"type":25,"children":388},[389],{"text":390,"type":29},"严格来说，ping 通的是主机，不是端口。TCP 端口可达也只说明连接能够建立，仍需继续验证协议、认证和实际代理请求。",{"type":36,"level":37,"children":392},[393],{"text":394,"type":29},"主机能 ping 通后，怎么测试 TCP 端口？",{"type":25,"children":396},[397],{"text":398,"type":29},"使用系统或客户端的 TCP 连接测试确认主机和端口可达。端口不通时，先查本地网络、防火墙、主机和端口；不要直接修改账号密码或判断代理 IP 已失效。",{"type":36,"level":37,"children":400},[401],{"text":402,"type":29},"HTTP、HTTPS、SOCKS5 协议和字段怎么核对？",{"type":25,"children":404},[405],{"text":406,"type":29},"确认产品提供的是 HTTP、HTTPS 还是 SOCKS5，并在客户端选择对应协议。主机、端口、用户名和密码分别填写，不能把 `IP:端口`、API 链接或完整 URL 当成同一个字段。具体以产品和客户端字段说明为准。",{"type":25,"children":408},[409],{"text":410,"type":29},"代理协议与目标网址协议不是同一概念。访问 HTTPS 网站并不代表代理入口一定要选择 HTTPS；客户端仍要按产品提供的 HTTP、HTTPS 或 SOCKS5 接入方式完成握手，再处理目标网站的 HTTPS 连接。",{"type":36,"level":37,"children":412},[413],{"text":414,"type":29},"从 TCP 端口到目标网站怎么逐层复测？",{"type":25,"children":416},[417],{"text":418,"type":29},"1. 用正确协议建立代理连接。\n2. 填写用户名和密码，观察是否返回 407。\n3. 请求出口检测页，确认出口 IP 是否变化。\n4. 再访问目标网站，记录状态码、超时和页面结果。",{"type":25,"children":420},[421],{"text":422,"type":29},"如果客户端支持，可用同一组参数在 curl 或另一代理工具中复测。第二个工具成功时，优先检查原客户端的协议选择、字段映射和接管范围。",{"type":31,"children":424},[425],{"text":426,"type":29},"| 现象 | 优先检查 | 说明 |\n|---|---|---|\n| TCP 端口拒绝连接或超时 | 网络、主机、端口 | 尚未进入协议握手和认证 |\n| TCP 端口通但返回 407 | 用户名、密码和认证方式 | 连接已建立，认证失败 |\n| TCP 端口通但出现 TLS 错误 | 协议、CONNECT、客户端实现 | 端口可达但握手未完成 |\n| 出口 IP 未变化 | 客户端代理入口 | 请求可能绕过了代理 |\n| 出口已变化但返回 403\u002F429 | 请求特征、频率、目标站规则 | 不一定是协议错误 |",{"type":36,"level":37,"children":428},[429],{"text":430,"type":29},"什么时候更换代理 IP",{"type":25,"children":432},[433],{"text":434,"type":29},"只有主机、端口、协议、认证和出口都确认无误，且多个目标网址持续失败时，才考虑更换同地区代理 IP。单一网站或单一账号异常，应先查目标站规则和账号环境。",{"type":36,"level":37,"children":436},[437],{"text":242,"type":29},{"type":36,"level":133,"children":439},[440],{"text":441,"type":29},"ping 不通时，代理一定不能用吗？",{"type":25,"children":443},[444],{"text":445,"type":29},"不一定。服务器或网络可能禁止 ICMP 响应，但代理 TCP 端口仍可连接；应以端口测试和实际代理请求结果为准。",{"type":36,"level":133,"children":447},[448],{"text":449,"type":29},"HTTP、HTTPS 和 SOCKS5 可以随便选吗？",{"type":25,"children":451},[452],{"text":453,"type":29},"不可以。应按产品提供的接入协议和客户端字段选择，协议与端口不能凭名称猜测。",{"type":36,"level":133,"children":455},[456],{"text":457,"type":29},"返回 407 需要换 IP 吗？",{"type":25,"children":459},[460],{"text":461,"type":29},"通常不需要。407 优先指向认证失败，应先核对用户名、密码和认证方式。",{"type":36,"level":133,"children":463},[464],{"text":465,"type":29},"如何确认不是目标网站的问题？",{"type":25,"children":467},[468],{"text":469,"type":29},"用同一代理访问出口检测页和至少一个普通网站。只有某个目标站失败时，继续查该站的地区规则或账号状态。",{"type":25,"children":471},[472],{"text":278,"type":29},{"type":36,"level":37,"children":474},[475],{"text":476,"type":29},"ping 通但代理不能用时，应该按什么顺序排查？",{"type":25,"children":478},[479],{"text":480,"type":29},"速查顺序：TCP 端口 → 协议 → 认证 → 出口 IP → 目标网站。",{"type":25,"children":482},[483],{"text":484,"type":29},"仍无法定位时，带上主机、端口、协议、完整错误码和测试截图，通过[全球代理首页](https:\u002F\u002Fwww.quanqiudaili.com\u002F)咨询；不要公开发送完整密码。",{"source":6,"id":486,"documentId":487,"translationKey":487,"locale":9,"slug":488,"path":489,"_path":489,"title":490,"description":491,"excerpt":491,"image":492,"publishedAt":493,"updatedAt":494,"author":17,"tags":495,"featured":19,"sortOrder":20,"readingTime":295,"bodyType":22,"bodyBlocks":496,"bodyHtml":111},2132,"n4e0v2bagwqgcxp1on7axb1m","proxy-account-failed","\u002Fblog\u002Fproxy-account-failed","代理账号密码认证失败：大小写、过期和权限怎么查？","代理账号密码认证失败时，先区分 407 与端口超时，再检查大小写、空格、特殊字符、套餐有效期、流量余额、权限和客户端字段映射，减少无效更换代理 IP。","https:\u002F\u002Fcms.quanqiudaili.com\u002Fuploads\u002Flarge_cover_1_bbbf896121.webp","2026-08-20T09:26:24.470Z","2026-08-20T09:26:24.456Z",[],[497,501,505,509,513,517,521,525,529,533,537,541,544,548,552,556,560,564,568,572,576,580,583,587],{"type":25,"children":498},[499],{"text":500,"type":29},"代理账号密码认证失败时，先判断是否已经连接到代理入口。能连接但返回 407，优先检查用户名、密码和认证方式；连主机和端口都失败，则先查网络、主机和端口，不要反复修改密码。",{"type":36,"level":37,"children":502},[503],{"text":504,"type":29},"账号密码是否存在空格、大小写或特殊字符错误？",{"type":25,"children":506},[507],{"text":508,"type":29},"手动重新复制用户名和密码，去掉首尾空格，确认大小写、连字符和特殊字符没有变化。不要把带引号、带空格或整段代理链接直接粘贴到只接受用户名和密码的字段中。",{"type":36,"level":37,"children":510},[511],{"text":512,"type":29},"账号是否过期、流量用完或填错产品入口？",{"type":25,"children":514},[515],{"text":516,"type":29},"确认凭据属于当前代理产品、国家或地区和代理入口，并检查套餐有效期、流量余额、并发限制及子账号状态。不同产品的账号不能混用。",{"type":36,"level":37,"children":518},[519],{"text":520,"type":29},"407、端口超时和认证弹窗分别说明什么？",{"type":31,"children":522},[523],{"text":524,"type":29},"| 现象 | 优先检查 | 结论 |\n|---|---|---|\n| 返回 407 | 用户名、密码、认证方式 | 已到达代理入口，但认证未通过 |\n| 端口连接超时 | 网络、主机、端口 | 认证尚未开始，先查连接 |\n| 反复出现认证弹窗 | 凭据保存、字段映射、旧缓存 | 删除旧凭据后手动重填 |\n| 只有某个客户端失败 | 字段映射、协议和编码 | 代理资源未必失效 |\n| 账号突然失效 | 有效期、余额、权限和子账号 | 需核对资源状态 |",{"type":36,"level":37,"children":526},[527],{"text":528,"type":29},"代理认证失败应该按什么顺序复测？",{"type":25,"children":530},[531],{"text":532,"type":29},"1. 用同一主机、端口和协议手动填写用户名与密码。\n2. 在最小客户端中请求出口检测页，记录完整错误码。\n3. 用第二个客户端复测，但不要同时更换网络和代理参数。\n4. 仍返回 407 时，保存时间、产品、入口和截图，联系服务商核对账号状态。",{"type":25,"children":534},[535],{"text":536,"type":29},"脱敏复测记录示例：`2026-08-19 10:30`，入口 `proxy.example.com:PORT`，协议 `HTTP`，用户名 `user_***`，密码不记录；结果为 `407 Proxy Authentication Required`。随后按上表核对凭据、认证方式和账号状态。",{"type":25,"children":538},[539],{"text":540,"type":29},"能看到出口 IP 变化，只能证明代理接入成功，不代表目标网站一定放行；验证码、账号审核和站点权限仍需单独判断。",{"type":36,"level":37,"children":542},[543],{"text":242,"type":29},{"type":36,"level":133,"children":545},[546],{"text":547,"type":29},"大小写真的会导致认证失败吗？",{"type":25,"children":549},[550],{"text":551,"type":29},"会。用户名和密码应按服务端记录原样填写，尤其要注意大写字母、数字和特殊字符。",{"type":36,"level":133,"children":553},[554],{"text":555,"type":29},"返回 407 是端口问题吗？",{"type":25,"children":557},[558],{"text":559,"type":29},"通常不是。407 表示代理入口要求认证或认证未通过；端口完全不通时一般表现为超时或连接拒绝。",{"type":36,"level":133,"children":561},[562],{"text":563,"type":29},"什么时候需要更换代理 IP？",{"type":25,"children":565},[566],{"text":567,"type":29},"先确认账号、网络、主机、端口和协议都正确。只有同一目标站持续异常，才考虑更换同地区代理 IP。",{"type":36,"level":133,"children":569},[570],{"text":571,"type":29},"复测需要准备哪些信息？",{"type":25,"children":573},[574],{"text":575,"type":29},"准备目标站、代理主机和端口、协议、错误码、测试时间、客户端名称及截图，不要在公开渠道发送完整密码。",{"type":25,"children":577},[578],{"text":579,"type":29},"可通过[全球代理 FAQ](https:\u002F\u002Fhelp.quanqiudaili.com\u002Fdocs\u002FFaq\u002F)核对认证问题；提交截图前应遮盖完整用户名、密码和其他敏感字段。",{"type":25,"children":581},[582],{"text":278,"type":29},{"type":36,"level":37,"children":584},[585],{"text":586,"type":29},"代理账号密码认证失败时应该先查什么？",{"type":25,"children":588},[589],{"text":590,"type":29},"认证失败的排查顺序是：连接是否建立 → 用户名密码格式 → 有效期和权限 → 产品入口 → 客户端差异。按层验证，比连续更换代理 IP 更容易定位原因。",[592],{"source":6,"id":7,"documentId":8,"translationKey":8,"locale":9,"slug":10,"path":11,"_path":11,"title":12,"description":13,"excerpt":13,"image":14,"publishedAt":15,"updatedAt":16,"author":17,"tags":593,"featured":19,"sortOrder":20,"readingTime":21,"bodyType":22,"bodyBlocks":594,"bodyHtml":111},[],[595,598,601,604,607,610,613,616,619,628,631,634,637,640,643,646,649,652,655,658,667,670,673,676,685,688,691,694,697,700,703,706,709,712,715,718],{"type":25,"children":596},[597],{"text":28,"type":29},{"type":31,"children":599},[600],{"text":34,"type":29},{"type":36,"level":37,"children":602},[603],{"text":40,"type":29},{"type":25,"children":605},[606],{"text":44,"type":29},{"type":25,"children":608},[609],{"text":48,"type":29},{"type":36,"level":37,"children":611},[612],{"text":52,"type":29},{"type":25,"children":614},[615],{"text":56,"type":29},{"type":25,"children":617},[618],{"text":60,"type":29},{"type":62,"image":620,"children":626},{"id":64,"ext":65,"url":66,"hash":67,"mime":68,"name":69,"size":70,"width":71,"height":72,"caption":73,"formats":621,"provider":106,"createdAt":107,"updatedAt":107,"documentId":108,"focalPoint":73,"previewUrl":73,"publishedAt":107,"alternativeText":73,"provider_metadata":73},{"large":622,"small":623,"medium":624,"thumbnail":625},{"ext":65,"url":66,"hash":76,"mime":68,"name":77,"path":73,"size":78,"width":79,"height":80,"sizeInBytes":81},{"ext":65,"url":83,"hash":84,"mime":68,"name":85,"path":73,"size":86,"width":87,"height":88,"sizeInBytes":89},{"ext":65,"url":91,"hash":92,"mime":68,"name":93,"path":73,"size":94,"width":95,"height":96,"sizeInBytes":97},{"ext":65,"url":99,"hash":100,"mime":68,"name":101,"path":73,"size":102,"width":103,"height":104,"sizeInBytes":105},[627],{"text":111,"type":29},{"type":36,"level":37,"children":629},[630],{"text":115,"type":29},{"type":25,"children":632},[633],{"text":119,"type":29},{"type":36,"level":37,"children":635},[636],{"text":123,"type":29},{"type":25,"children":638},[639],{"text":127,"type":29},{"type":31,"children":641},[642],{"text":131,"type":29},{"type":36,"level":133,"children":644},[645],{"text":136,"type":29},{"type":25,"children":647},[648],{"text":140,"type":29},{"type":36,"level":37,"children":650},[651],{"text":144,"type":29},{"type":25,"children":653},[654],{"text":148,"type":29},{"type":25,"children":656},[657],{"text":152,"type":29},{"type":62,"image":659,"children":665},{"id":155,"ext":65,"url":156,"hash":157,"mime":68,"name":158,"size":159,"width":71,"height":72,"caption":73,"formats":660,"provider":106,"createdAt":184,"updatedAt":184,"documentId":185,"focalPoint":73,"previewUrl":73,"publishedAt":184,"alternativeText":73,"provider_metadata":73},{"large":661,"small":662,"medium":663,"thumbnail":664},{"ext":65,"url":156,"hash":162,"mime":68,"name":163,"path":73,"size":164,"width":79,"height":80,"sizeInBytes":165},{"ext":65,"url":167,"hash":168,"mime":68,"name":169,"path":73,"size":170,"width":87,"height":88,"sizeInBytes":171},{"ext":65,"url":173,"hash":174,"mime":68,"name":175,"path":73,"size":176,"width":95,"height":96,"sizeInBytes":177},{"ext":65,"url":179,"hash":180,"mime":68,"name":181,"path":73,"size":182,"width":103,"height":104,"sizeInBytes":183},[666],{"text":111,"type":29},{"type":25,"children":668},[669],{"text":191,"type":29},{"type":36,"level":37,"children":671},[672],{"text":195,"type":29},{"type":25,"children":674},[675],{"text":199,"type":29},{"type":62,"image":677,"children":683},{"id":202,"ext":65,"url":203,"hash":204,"mime":68,"name":205,"size":206,"width":71,"height":72,"caption":73,"formats":678,"provider":106,"createdAt":231,"updatedAt":231,"documentId":232,"focalPoint":73,"previewUrl":73,"publishedAt":231,"alternativeText":73,"provider_metadata":73},{"large":679,"small":680,"medium":681,"thumbnail":682},{"ext":65,"url":203,"hash":209,"mime":68,"name":210,"path":73,"size":211,"width":79,"height":80,"sizeInBytes":212},{"ext":65,"url":214,"hash":215,"mime":68,"name":216,"path":73,"size":217,"width":87,"height":88,"sizeInBytes":218},{"ext":65,"url":220,"hash":221,"mime":68,"name":222,"path":73,"size":223,"width":95,"height":96,"sizeInBytes":224},{"ext":65,"url":226,"hash":227,"mime":68,"name":228,"path":73,"size":229,"width":103,"height":104,"sizeInBytes":230},[684],{"text":111,"type":29},{"type":25,"children":686},[687],{"text":238,"type":29},{"type":36,"level":37,"children":689},[690],{"text":242,"type":29},{"type":36,"level":133,"children":692},[693],{"text":246,"type":29},{"type":25,"children":695},[696],{"text":250,"type":29},{"type":36,"level":133,"children":698},[699],{"text":254,"type":29},{"type":25,"children":701},[702],{"text":258,"type":29},{"type":36,"level":133,"children":704},[705],{"text":262,"type":29},{"type":25,"children":707},[708],{"text":266,"type":29},{"type":36,"level":133,"children":710},[711],{"text":270,"type":29},{"type":25,"children":713},[714],{"text":274,"type":29},{"type":25,"children":716},[717],{"text":278,"type":29},{"type":25,"children":719},[720],{"text":282,"type":29},[],[]]