Pick one of two modes: no tool — change the computer's system proxy or delegate to your AI; or with a tool — from the official extension to common market tools. Same host and credentials for both.
A Proxy302 account and one proxy asset in a usable state (any type). Sign in at proxy302.com and open the workbench; the resource card showing "Generated and ready to copy" means you are set. No asset yet? Buy residential traffic or a static ISP line first.
Then pick a mode: without a connection tool (system proxy, terminal, code — or hand it to your AI), or with a connection tool (our extension and helper tool, plus common tools like SwitchyOmega, Proxifier and antidetect browsers). Both modes use the same credentials and you can switch anytime.
With one set of credentials (host, username and password from the workbench resource card) you can connect without installing anything: set the system proxy for the whole machine, hit the gateway with curl, or pass proxy options in code. In a hurry? Send the instruction below, together with your credentials, to your AI assistant and let it do the work.
Scroll horizontally with the arrow keys to read all content.
Please switch this computer's proxy to Proxy302:
1. On Windows open "Settings → Network & Internet → Proxy → Manual proxy setup",
set the address to proxy.proxy302.com and the port to 2222.
On macOS open "System Settings → Network → Details → Proxies → Web Proxy",
fill the same values and enter the credentials in the authentication fields.
2. Proxy username "your-username", password "your-password"
(from the proxy302.com workbench resource card — "Copy all").
3. Visit https://ipinfo.io/json afterwards and read me the exit IP and country.
4. If my line is SOCKS5, use port 3333 instead.
Send this plus your credentials to any AI assistant and it can do the setup and verification for you; on Windows the browser shows a proxy sign-in dialog on the first request, once.
Windows: "Settings → Network & Internet → Proxy", turn on "Use a proxy server", address proxy.proxy302.com, port 2222. macOS: "System Settings → Network → Details → Proxies → Web Proxy", same address and port; username and password go straight into the authentication fields.
Expected result The system proxy switch is on.
Handle the sign-in dialog
The Windows system proxy has no credential fields: on the first page request the browser shows a proxy sign-in dialog — enter the username and password from the resource card once. macOS will not ask again after you filled them in Settings.
Expected result Asked once, then never again.
Verify the exit
Open ipinfo.io; the IP and country shown are the proxy exit. They match the line you bought, the proxy is working.
Expected result Exit country matches your line.
Before continuing The system proxy applies to the whole machine — turn it off when you stop using it, or every app waits on a dead proxy when the network drops.
Command line: curl in two minutes
Put the credentials in a local config file
Create an empty proxy302.conf and restrict it to your own user before writing credentials (POSIX: touch proxy302.conf && chmod 600 proxy302.conf; Windows: restrict file permissions first). Then copy the block below and replace the placeholders. Keep passwords out of shell history and process arguments.
Expected result proxy302.conf is in place and readable via --config.
Request ipinfo.io through the proxy
In the same directory run curl -q --noproxy "" --config proxy302.conf https://ipinfo.io/json. -q ignores curlrc and --noproxy "" overrides target bypass variables. Check the returned exit IP and country against the line you selected.
Expected result JSON returns; country matches the line you bought.
Compare with a direct request
Run curl -q --proxy "" https://ipinfo.io/json as the direct control; it ignores curlrc and proxy environment variables. Compare both results and check the client configuration and recorded usage. An IP difference is useful evidence, but alone does not prove the route.
Expected result Record both exits; investigate identical or unexpected results.
proxy302.conf contents
Scroll horizontally with the arrow keys to read all content.
For SOCKS5 replace the whole proxy value with socks5h://proxy.proxy302.com:3333, including the scheme. Use the exact username and password from your resource card, separated by a colon.
The first command selects the configured proxy; the second explicitly disables proxies. Compare ip and country. On Windows run these commands in Command Prompt (cmd.exe); older Windows PowerShell drops empty quoted arguments, so naming curl.exe alone is not enough.
Scroll horizontally with the arrow keys to read all content.
What each request should show
Item
Response
Notes
Proxied request
ip, city and country are the proxy exit
country should match the region of the line you bought.
Direct control
ip, city and country are your local exit
A difference is a useful signal; also verify client settings and usage.
Both identical
Check for bypass or a shared exit; equality alone is inconclusive.
Follow the "exit IP never changes" row in the table below.
Read from the ipinfo.io response; different IP databases may locate the same exit slightly differently, so compare before and after within the same service.
Host, username and password belong to the asset itself: they change when you switch lines, regenerate or expire, so always trust what the workbench resource card shows now.
Give the credentials only to tools that need the proxy; never commit them to repositories, chats or script comments. When you keep proxy302.conf by hand, restrict the file to your own user (chmod 600 on POSIX, remove other users in the file properties on Windows) and delete it when done.
Expired or disabled assets cannot connect. Prepaid traffic uses the selected line quota; wallet PAYG uses the wallet balance and the supported billing mode. If credentials may have leaked, review usage and asset status before changing the line.
Tools solve three things: one-click switching, per-site or per-app routing, and multi-account isolation. Our own tools are the browser extension (simplest) and the helper tool (restricted networks); common market tools such as SwitchyOmega, Proxifier and antidetect browsers like AdsPower all take the same credentials.
Grab the package from "Downloads and setup" at the bottom of this page. Chrome users unzip it, open chrome://extensions, enable "Developer mode", click "Load unpacked" and select the unzipped folder; 360 browser users install the .crx directly. The Proxy302 icon appears in the toolbar when done.
Expected result The Proxy302 icon is in your toolbar.
Click the icon to open the popup, click "Log in to your account" and finish signing in on the page that opens. Back in the extension your assets appear automatically — no host, username or password to type.
Expected result The popup shows your account and assets.
Dynamic lines pick country/state in the popup and click connect; static lines select the asset. The popup shows the live exit IP — when the region matches your choice, the proxy is already working.
Expected result The exit IP shows the selected region.
Real screenshot of the official v1.5 extension (signed-out state). After signing in, the same popup picks a country, connects and shows the exit IP at the top.Open full-size figure
Can't connect from a non-overseas network? Run the helper tool
On some networks the extension cannot connect directly. Download the helper tool for your system from the bottom of this page, keep it running in the background, then open the extension settings and tick "Use helper tool" — the local IP is filled in automatically. The help center has illustrated steps per browser.
If you write code, continue with the Playwright and Selenium scene pages; compare lines before buying if you are still deciding; the extension and desktop helper tools are under "Downloads and setup" at the bottom of this page, with per-browser illustrated steps in the help center.
The extension cannot connect or fails to set the proxy
Check Whether you are on a non-overseas network (the helper tool is required) and whether another proxy extension is running (they can conflict).
Fix Run the helper tool and tick "Use helper tool" in the extension settings; disable other proxy extensions and retry.
System proxy is on but some apps bypass it
Check Some apps ignore system proxy settings or carry their own network configuration.
Fix Fill the proxy in that app's own network settings, or take it over per-app with Proxifier.
HTTP 407 (proxy authentication failed)
Check Whether the credentials were copied whole (missing characters or stray spaces cause 407) and whether the asset expired or ran out of traffic.
Fix Copy again with "Copy all" on the resource card and re-check asset status and remaining traffic.
Stop when Do not hammer retries on 407; confirm credentials and asset state first.
Connection timeout or refused
Check Match the protocol and port: HTTP 2222, SOCKS5 3333. no_proxy / NO_PROXY matches the target (here ipinfo.io), not the gateway.
Fix Use the correct full proxy URL and the explicit bypass-control options shown above, then retry.
Responses come back but the exit IP never changes
Check Whether requests actually go through the proxy: an extension rule that misses, or code that never passes the proxy option to the real client, silently goes direct.
Fix Locate it with the step-4 comparison and confirm the client really uses the proxy.
Generating a proxy says there is no traffic
Check For prepaid traffic check the selected line quota; for wallet PAYG check wallet balance and whether that product supports PAYG. These are separate funding sources.
Fix Confirm the selected billing mode and its available funds before purchasing more traffic or topping up.
FAQ
Do I have to use the command line?
No. Browser users are done after the three extension steps; the command line is only how developers verify the gateway and write scripts.
Can the system proxy and the extension (or a tool) be on at the same time?
Keep one active at a time. Two stacked proxy layers easily detour or fight over traffic; use Proxifier for per-app routing or SwitchyOmega for per-site routing.
How do I choose between ports 2222 and 3333?
Follow the line's protocol: HTTP proxy uses 2222, SOCKS5 uses 3333. When a tool supports both, prefer SOCKS5; see the curl manual on socks5 versus socks5h for where DNS is resolved.
Sign in at proxy302.com and open the workbench: the resource card shows host and username in plain text, masks the password, and "Copy all" grabs everything at once.
The credential belongs to the asset itself; concurrency and reuse limits follow the purchase page and line notes. For multi-account operations plan one IP per account.
Step-by-step proxy setup for each browser and platform, with the partner offer where the browser partners with Proxy302, and a side-by-side comparison of eight antidetect browsers.
302.AI is a pay-as-you-go platform for AI models and apps built by the same team as Proxy302. See how to pair the two for geo-testing, scripted API calls and AI-agent networking.
Step-by-step guide to using Proxy302 proxies in AdsPower: where to paste host, port, username and password, which proxy to buy, partner offers and FAQ.
Step-by-step guide to using Proxy302 proxies in BitBrowser: where to paste host, port, username and password, which proxy to buy, partner offers and FAQ.
Import a Proxy302 static IP or rotating residential into Huayang with one pasted line. Includes the Hong Kong access point for users in mainland China and help-center screenshots.
Step-by-step guide to using Proxy302 proxies in Undetectable: New Proxy on the General tab, where to enter host, port, login and password, with screenshots and FAQ.
What CheBrowser, IXBrowser, MBBrowser, OmniLogin and EasyBR are, and how a Proxy302 proxy goes into each, with the general steps and pointers to their own guides.
Device and tool guides: Helper, extension, iPhone, Android
Step-by-step setup for the Proxy302 Helper, the browser extension, Shadowrocket on iPhone and v2rayNG on Android.
Install the Proxy302 browser extension in Chrome, Edge or 360 Browser, send a proxy from My assets with one click and check your exit IP. HTTP proxies only.
Add a Proxy302 HTTP or SOCKS5 proxy to Shadowrocket on iPhone: which boxes to fill, how to switch it on, how to check your exit IP and what to do in mainland China.
Add a Proxy302 SOCKS5 proxy to v2rayNG on Android, test the connection and check your exit IP. HTTP-only datacenter IPs: use Postern, or get a SOCKS5 one.
Explainers and how-tos for common questions
ISP proxies, native IPs, pay per GB, rental terms, city targeting, checking prices from another country, which IP to use for Instagram and TikTok, and proxy settings for Claude Code and Cursor.
What is a native IP address? An IP whose registered country, ASN, and actual location are consistent. Explains the difference from broadcast IP (registered in one country, used in another) and walks through a four-step self-check using ipinfo and whois.
What country, state and city targeting really mean for residential proxies, why a lookup can show another city, and how to verify an exit before you rely on it.
A new IP or a proxy does not lift an Instagram ban. What an IP can and cannot change, what to do when an account is disabled, and how to keep one steady connection per account.
Static or rotating IP for TikTok accounts: how to choose, how to pick the exit country, how to check the exit before you log in, and what an IP cannot fix.
Set a proxy in Cursor with http.proxy, handle special characters in the password, switch to HTTP/1.1 when streaming hangs, and verify with Run Diagnostics.
Paying for ads, tools and subscriptions when the team holds USDT: how AllScale business crypto cards assign an owner, budget and record to every charge, and where Proxy302 fits.
Proxy setup, errors and account IPs
Gemini and Codex CLI through a proxy, proxy address, port, username and password, fixing ERR_PROXY_CONNECTION_FAILED and 407, and which IP to use for Facebook, YouTube, LinkedIn, WhatsApp and Amazon seller accounts.
How to set up a proxy for the Gemini web app, Google AI Studio and the Gemini API, and how to diagnose common errors. A proxy does not change Google's terms.
Facebook reads your IP at every login; this guide explains what it can see, why location jumps trigger checks, and why a long-lived account suits a static IP.
Learn what Amazon Seller Central sees at sign-in, how to choose a static ISP or rotating residential proxy, and where platform rules set the limits.
Proxy setup in browsers, apps and code, and how to choose
FoxyProxy, Clash, Node.js and Python requests with a proxy, proxy settings on Windows, macOS, iPhone and Android, and checklists for choosing residential and SOCKS5 proxies.
How the three Proxy302 lines differ inside Clash: rotating residential per GB, static ISP and datacenter per IP per term; protocol and port pairing, DNS resolution side, traffic scope and the browser-extension split.
Connect Chrome or Firefox to Proxy302 through the FoxyProxy extension: gateway proxy.proxy302.com, HTTP port 2222, SOCKS5 port 3333, username-password sign-in, per-site patterns and common errors.
Point Puppeteer at proxy.proxy302.com with --proxy-server, authenticate with page.authenticate() on HTTP port 2222, rotate the exit IP on every request or hold a sticky session; SOCKS5 on 3333 serves tools outside the browser.
Proxy setup in curl, Puppeteer and Scrapy, region and network guides, and proxies for scraping and marketplaces
curl, Puppeteer and Scrapy with a proxy, what a home-broadband IP is, static versus dynamic IPs, and network guides for Grok, NotebookLM, Wildberries, Ozon and data collection.
Where Grok is available is set by xAI's terms, and a proxy does not change them. How to set and verify a proxy for the browser, the app and the API in a supported region.
NotebookLM availability follows Google's official help; a proxy does not change the terms; how to check your exit and set a proxy in a supported region.
Set a proxy in IntelliJ IDEA, PyCharm, WebStorm: the HTTP Proxy page, manual HTTP or SOCKS, a login and password, Check connection and an AI Assistant note.
Set a proxy in Windsurf with the Http: Proxy field, choose how to give the username and password, set the separate remote-development fields and verify the connection.
Run GitHub Copilot through an HTTP proxy in VS Code and JetBrains IDEs: the proxy field, basic authentication, certificates and a curl check against GitHub's ping address.
Set a proxy for Git with http.proxy, use a different proxy for one host, switch to SOCKS5 with socks5h, handle SSH remotes with ProxyCommand and check it.
Set a proxy on Linux: http_proxy, https_proxy and no_proxy variables, making them permanent, the GNOME Network proxy panel, and proxy settings for apt and dnf.
Proxy setup for ChatGPT, the OpenAI API, Telegram and Key Collector
Where the proxy goes in ChatGPT, OpenAI API code, Telegram and the Key Collector keyword tool, and how to check it.
Add a proxy to Key Collector: Settings, Network, the proxy table, a username and password, threads per IP, a manual check and the official Wordstat API.
Proxy setup in Edge, Firefox and wget
Set a proxy in Microsoft Edge, Mozilla Firefox and GNU Wget, with a check for each.
Set a proxy in Microsoft Edge: system settings, the --proxy-server flag, why SOCKS5 with a login does not work, managed computers, extensions and a check.
What to check when AdsPower says "Connection test failed" or a profile reports a proxy failure: type, fields, validity, network, VPN, then confirm the exit IP.
What to check when BitBrowser proxy detection fails, or passes but pages will not open: type, fields, lookup channel, network, validity, then the exit IP.
Check proxy does not pass in GeeLark: six checks in order, from the type and bulk-add format to expiry, location and the profile's proxy, then confirm the exit IP.
What Amazon's official pages say about holding more than one seller account, why one fixed IP per approved account keeps the login environment stable, and what an IP cannot change.
Claude account stability: ban causes, IP risk, environment checks and a checklist
Why Claude accounts get banned, how IP types and shared addresses matter, time zone, language and payment consistency, how to read IP checkers, and how to choose an AI-subscription ISP.
Test your IP as soon as the page opens: network type, native or broadcast, Spamhaus and SpamCop, time zone, language and WebRTC, plus how to read each result.
The Claude, GPT / Grok and Gemini tiers compared: subscriptions, networks, regions, price per IP for 30 days and the first-IP half price.
Before you buy: availability, checks and proxy types
What a proxy is, where ChatGPT, Claude and Gemini are offered, which of 38 platforms answer from which countries, how to check a proxy, which type fits which job, and how to set up an antidetect browser.
A proxy forwards your requests so sites see its IP, not yours. How HTTP and SOCKS5 proxies work, proxy vs VPN, whether it is safe, and which proxy fits which job.
The four official availability lists compared country by country — China, Hong Kong, Russia and more — plus hourly checks of the OpenAI and Anthropic APIs from 7 countries.
Which countries block Discord, YouTube, Instagram, Telegram and more — and hourly checks showing all 38 platforms reachable through residential IPs in 7 countries.
Check the exit IP, country and ISP your proxy really gives you in 30 seconds — and why IP databases disagree on the city. With our own test of three lookup services.
What separates rotating residential, static ISP and datacenter proxies — who owns the IP, whether it changes, how you pay — and which one Proxy302's own presets pick for each job.
Set up a proxy in AdsPower, BitBrowser, GoLogin, Kameleo, Hidemium or GenLogin: one IP per profile, where each field goes, and what a failed proxy check really means.
Pick a proxy provider by task first, then check billing, minimum order, protocols and authentication against a verifiable list; competitor numbers come from their own pricing pages, dated.
Get a Canadian IP on Proxy302: dynamic residential traffic with province- and city-level targeting from US$1.50/GB, static ISP and datacenter IPs by the day, gateway, ports and checked prices.
Downloads and setup
Get the browser extension and connection tools
These links share the console’s connection-tool catalogue. Choose the tool for your system, then follow the setup guide for your purchased proxy.
Proxy302 workbench and product configuration pages
Product observation · Confirmed on:
Port rules from the public frontend source proxyEndpoint.ts (HTTP 2222 / SOCKS5 3333), consistent with the production facts file customer_proxy_entry; the resource-card host/username/password and Copy-all behaviour from the workbench rendering source. Behind-login screens were not re-tested in this pass.
Proxy302 official browser extension v1.5 (public distribution package)
Product observation · Confirmed on:
Unpacked the Chrome extension v1.5 distributed 2026-05-29 and loaded it in a clean browser: the popup has a sign-in entry (web login, no manual credentials), country/state selection, one-click connect and a live exit IP display; the background works with the account session over the API. The extension UI ships Chinese and English.