Set up SOCKS5 Configurator with ProxyField
- With no proxy on, open
https://api.ipify.organd add that IP to the allowlist in your ProxyField account. - Install SOCKS5 Configurator from the Chrome Web Store (publisher: txthinking).
- Check that Socks5 Proxy is on and enter
gate.proxyfield.io:<port>, with the port you set up in the dashboard. - Select Save and reload
https://api.ipify.org: it shows a proxy IP, not yours. - For a login or a city per entry, use HTTP on
gate.proxyfield.io:7000in a switcher with login fields instead.
What goes into the extension's server field, with your IP on the allowlist and <port> the port you set up in the dashboard.
gate.proxyfield.io:<port>The extension's own source and settings: socks5-configurator (txthinking, GitHub).
The short answer, by where you use SOCKS5:
| Where | SOCKS5 with a username and password? | How it logs in to ProxyField |
|---|---|---|
| SOCKS5 Configurator and any Chrome extension | no | your IP on the allowlist, on the port you set up in the dashboard |
| Desktop apps: Firefox with FoxyProxy, curl, Python, Proxifier, proxychains, antidetect browsers | yes | <login>:<password> on gate.proxyfield.io:7000 |
| Chrome with a login and a location per entry | over HTTP, not SOCKS5 | HTTP in a switcher: ZeroOmega, Proxy Switcher |
Need a SOCKS5 login anyway? Use Firefox with FoxyProxy, curl, Python or Proxifier: they send the username and password that Chrome cannot (configs below).
A provider works in extensions and desktop apps alike when it runs SOCKS5 on residential IPs, serves both on one host, and accepts both a login and an IP allowlist, because a Chrome extension cannot send a SOCKS5 login. ProxyField does all three on gate.proxyfield.io, for residential and mobile IPs: port 7000 with a username and password, and the port you set up in the dashboard with the allowlist.
On this page 10 sections
Does SOCKS5 Configurator work with a username and password?
No. The extension stores a host and a port only, and Chrome's own SOCKS5 client offers no login method, so a proxy that asks for one refuses the connection. The Chromium documentation says: "No authentication methods are supported for SOCKSv5 in Chrome (although some do exist for the protocol)" (Chromium proxy docs).
Read moreShow less
What happens on the wire. A SOCKS5 client opens with a greeting that lists the login methods it can use (RFC 1928, section 3): X'00' is "no authentication required", X'02' is username/password (defined in RFC 1929). A proxy that requires a login answers X'FF', "no acceptable methods", and closes. Since Chrome supports no SOCKS5 login method, its greeting cannot offer X'02', so a ProxyField SOCKS5 entry in Chrome needs your IP on the allowlist and the port you set up in the dashboard.
Log Chrome's greetings yourself. This 17-line Python script listens on 127.0.0.1:18080, prints the methods in every greeting and refuses it:
# socks5_greetings.py: print the login methods a SOCKS5 client offers (RFC 1928, section 3)
import socket, sys, threading
def handle(c):
ver, n = c.recv(2)
methods = " ".join("X'%02X'" % m for m in c.recv(n))
sys.stdout.write(f"greeting: methods {methods}\n"); sys.stdout.flush()
c.sendall(b"\x05\xff") # "no acceptable methods": log the greeting, then close
c.close()
s = socket.socket()
s.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
s.bind(("127.0.0.1", 18080))
s.listen()
print("listening on 127.0.0.1:18080", flush=True)
while True:
threading.Thread(target=handle, args=(s.accept()[0],), daemon=True).start()Run it with python3 socks5_greetings.py, then start a fresh Chrome against it: google-chrome --user-data-dir=/tmp/socks-test --proxy-server="socks5://127.0.0.1:18080" http://example.com. A client that can log in also lists X'02'.
Check the allowlist route against the gateway (the separate --user-data-dir starts a fresh Chrome, so the flag applies even with Chrome open). Put your IP on the allowlist first, and use the port you set up in the dashboard as <port>:
google-chrome --user-data-dir=/tmp/socks-test --proxy-server="socks5://gate.proxyfield.io:<port>" https://api.ipify.orgipify then shows a ProxyField IP. Leave the login out of the address: Chrome supports no SOCKS5 login.
Two ways that work:
| You have | Do this |
|---|---|
| A fixed network (home or office) | Keep SOCKS5: add your public IP to the ProxyField allowlist and enter gate.proxyfield.io with the port you set up in the dashboard in the extension |
| A changing network, or you want a login and a location per entry | Use HTTP with a login in a switcher: ZeroOmega or Proxy Switcher in Chrome, FoxyProxy in Firefox |
What SOCKS5 Configurator is
SOCKS5 Configurator is a small, open-source extension by txthinking, under the MIT License, for Chrome and Edge (source on GitHub). Its source declares "manifest_version": 3, so it is built on Manifest V3, the extension format current Chrome runs.
Read moreShow less
What it can access. The manifest asks for the permissions storage and proxy, and host access to http://*/*, https://*/* and <all_urls>. Chrome's permission list gives proxy the install warning "Read and change all your data on all websites" (Chrome permissions list). So yes: like any proxy extension, it can see where every page you open goes. Install it only from the official store and only if you trust the publisher.
It points the browser at one SOCKS5 proxy and switches it on or off. The settings page:
| Setting | Default | On | Off |
|---|---|---|---|
| Socks5 Proxy switch | on | Chrome's traffic goes through the server in the field | Chrome goes back to the system proxy settings |
| Server field | empty | takes host:port, such as 127.0.0.1:1080 or [::1]:1080; no login fields | — |
| Bypass List switch and box | on, with cn and apple.com | the listed domains, their subdomains and private and local addresses skip the proxy | only private and local addresses skip it |
| Save | — | applies the settings | — |
Labels can differ slightly between versions; the defaults above are from the extension's source code (options.js).
What the extension cannot do:
- No username or password: use the allowlist, or HTTP with a login.
- One proxy at a time: no profiles, no per-site rules, no rotation list.
- Chrome traffic only: other apps keep their own connection.
- No location or session settings: on ProxyField these live in the username, or, with the allowlist, on the port you set up in the dashboard.
- No encryption: a SOCKS5 proxy relays traffic, and HTTPS sites stay encrypted by HTTPS.
- One proxy extension in control: if another one is enabled, only one of them sets Chrome's proxy.
- No Firefox or phone version.
Always bypassed. The extension's code always sends private and local addresses direct: 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16, 127.0.0.0/8, 169.254.0.0/16, localhost and *.local. Each domain in the Bypass List is skipped together with its subdomains.
Set up SOCKS5 Configurator with a residential proxy, step by step
- Find your public IP. With no proxy on, open
https://api.ipify.org. You see your own network's IP; note it. - Allowlist it. In your ProxyField account, add that IP to the allowlist. You see it in the allowlist. The extension sends no username, so it cannot pick a country or city: with allowlist access, the product, location and session are set per port in the dashboard. For a city per entry, use HTTP with a login.
- Test the gateway from a terminal first. Run
curl -x socks5h://gate.proxyfield.io:<port> https://api.ipify.org, where<port>is the port you set up in the dashboard for your allowlisted IP. You see one IP that is not the one from step 1. If this works, any later failure is in the extension, not the proxy. - Install SOCKS5 Configurator from the Chrome Web Store (publisher: txthinking) and pin its icon. You see Chrome's warning "Read and change all your data on all websites" before you confirm; the icon then opens the settings page.
Screenshot SOCKS5 Configurator in the Chrome Web Store with the Add to Chrome button - Enter the server. Check that Socks5 Proxy is on and type
gate.proxyfield.io:<port>in the server field, host and port together, with the port you set up in the dashboard. You see the value stay in the field; a missing port shows "Invalid socks5 proxy address" and nothing is saved.Screenshot SOCKS5 Configurator settings with gate.proxyfield.io and a port in the server field Check the Bypass List, then save. You see the switch on, with
cnandapple.comin the box. Delete them if you want those sites through the proxy as well. Then select Save.Confirm. Reload
https://api.ipify.org: you see a proxy IP, not the one from step 1 (it may differ from step 3, since without a session in a username the gateway gives a new IP on every request).https://ipinfo.io/jsonshows the proxy's city and country. What you see (example values):198.51.100.73 {"ip": "198.51.100.73", "city": "…", "region": "…", "country": "US", …}Turn it off when you are done. Switch Socks5 Proxy off and save. Chrome goes back to the system proxy settings, and ipify shows your own IP again. You can also disable the extension in chrome://extensions.
The allowlist holds only on that network. On another Wi-Fi network your public IP changes, the gateway refuses it, and pages fail until you add the new IP or turn the proxy off.
When to use HTTP instead
Use HTTP when you need a login or a location per entry, such as a US city for a residential IP. Chrome sends HTTP proxy credentials, and for web pages an HTTP proxy carries the same traffic as SOCKS5.
The working HTTP entry, in any switcher with login fields:
| Field | Value |
|---|---|
| Protocol | HTTP |
| Server | gate.proxyfield.io |
| Port | 7000 |
| Username | <login>-country-us-city-new_ |
| Password | your ProxyField password |
Test the same entry from a terminal first:
curl -x gate.proxyfield.io:7000 -U "<login>-country-us-city-new_york:<password>" https://api.ipify.orgRegion, session and session time go in the same username; every part after the login is optional, names are lowercase with underscores for spaces, and the country is its two-letter code:
<login>-country-us a US IP, new on every request
<login>-country-us-region-new_york New York State
<login>-country-us-city-new_york New York City
<login>-country-us-city-new_york-session-he9f2qga one IP for 20 minutes (the default)
<login>-country-au-region-australian_capital_territory-city-canberra-session-he9f2qga-ttl-60
one Canberra IP for 60 secondsResidential is the default; add -mobile after the login for mobile IPs: <login>-mobile-country-us.
| Session | How to set it | What happens |
|---|---|---|
| Rotating | no -session- part | a new IP on every request |
| Sticky | -session-<id> | one IP for 20 minutes |
| Sticky, your length | -session-<id>-ttl-<seconds>, 30 to 129,600 | one IP for 30 s to 36 h; presets 1, 5, 10, 30 min, 1, 3, 6 h |
| Idle | — | an IP idle for 120 s gets a new IP |
| Exit node drops | — | the gateway retries once with a new session, so the IP may change; the app reconnects |
The extension itself sends no username, so these settings work in the HTTP entry above and in the desktop apps below, not in SOCKS5 Configurator.
SOCKS5 in browser extensions and desktop apps
The same gateway, gate.proxyfield.io, works in a browser extension and in desktop apps, on residential and mobile IPs. What changes is how you log in, and with it the port: Chrome extensions need the allowlist and the port you set up in the dashboard, and most desktop tools take a username and password on port 7000. Plans and protocols are on SOCKS5 proxies.
Read moreShow less
| Where | Example | SOCKS5 login supported | How it logs in to ProxyField |
|---|---|---|---|
| Chrome extension | SOCKS5 Configurator | no | allowlist |
| Chrome, no extension | --proxy-server="socks5:// | no | allowlist, on the port you set up in the dashboard |
| Chrome switchers with login | ZeroOmega, Proxy Switcher | HTTP login | username and password over HTTP |
| Firefox | Settings → Network Settings → Manual proxy configuration → SOCKS Host, SOCKS v5, tick Proxy DNS when using SOCKS v5 (Firefox, FoxyProxy) | yes, in FoxyProxy | username and password, or allowlist |
| curl | curl -x "socks5h://<login>:<password>@gate. (cURL) | yes | username and password |
| Python requests | pip install requests[socks], then socks5h:// in proxies (Python) | yes | username and password |
| Linux tools | all_proxy, or proxychains (Linux) | yes | username and password |
| Windows apps without a proxy setting | Proxifier (Windows) | yes | username and password |
| Antidetect browsers | the profile's proxy type set to SOCKS5 (antidetect browsers) | yes | username and password |
| Playwright | proxy option with server, username, password | login fields for HTTP(S) proxies only, per its docs | HTTP with a login, or SOCKS5 with the allowlist |
| Puppeteer, Selenium with Chrome | Chrome's --proxy-server flag | no: Chrome's own limit | HTTP with a login, or SOCKS5 with the allowlist |
| Scrapy | the proxy meta key, http://<login>:<password>@gate. | SOCKS only with a download handler that supports it, per its docs | username and password over HTTP |
Playwright: "You can optionally specify username and password for HTTP(S) proxy" (Playwright network docs). Scrapy: "HttpxDownloadHandler supports SOCKS proxies while other built-in handlers don't" (Scrapy downloader middleware docs).
Desktop configs to copy:
# Any tool that reads a URL
socks5h://<login>:<password>@gate.proxyfield.io:7000
# proxychains: last line of /etc/proxychains.conf, with the gateway's IP (dig +short gate.proxyfield.io)
socks5 <gateway IP> 7000 <login> <password>In Proxifier: Profile → Proxy Servers → Add, address gate.proxyfield.io, port 7000, protocol SOCKS Version 5, authentication on with your username and password; then send the apps you choose to it under Profile → Proxification Rules.
Use socks5h where a tool offers it: the proxy then resolves hostnames, so DNS lookups happen at the proxy's location. In Firefox, tick Proxy DNS when using SOCKS v5 for the same effect.
UDP. On residential IPs, ProxyField carries UDP over SOCKS5 (HTTP/3, QUIC) on the same gate.proxyfield.io:7000. UDP matters in desktop apps that use it; a desktop client needs SOCKS5 UDP support of its own to send it.
Check any provider in 4 questions before you buy SOCKS5 for both browser and desktop use:
- Is SOCKS5 offered on residential IPs, not only on datacenter? ProxyField: yes, on residential and mobile, from $1.95/GB and $2.45/GB.
- Which host and port? ProxyField:
gate.proxyfield.io:7000with a username and password, the same as HTTP and HTTPS; with the IP allowlist, the port you set up in the dashboard. - Login or allowlist? ProxyField: both, username:password or an IP allowlist. Chrome extensions need the allowlist.
- Which apps take it? See the table above. Ask about your own app in the 24/7 live chat.
Check the proxy
- Turn the extension on and load
https://api.ipify.org: the exit IP, not yours. - Turn it off and reload: your own IP again.
- To test a SOCKS5 line before you use it, run it through the proxy checker: up to 100 proxies per check, and your list and results are not stored.
Fix SOCKS5 Configurator errors
| Symptom | Likely cause | Fix |
|---|---|---|
| "Invalid socks5 proxy address" when you save | The port is missing | Enter host and port together: gate.proxyfield.io and the port you set up in the dashboard |
ERR_ | Chromium: "Failed establishing a connection to the SOCKS proxy server for a target host"; a wrong host or port is one cause, an IP that is not on the allowlist may be another | Check gate.proxyfield.io and the port you set up in the dashboard; add the IP api.ipify.org shows with the proxy off |
ERR_NO_SUPPORTED_PROXIES | Chromium: "There are no supported proxies in the provided list"; here it may be a login in a SOCKS5 address (socks5://, for example in the --proxy-server flag), since Chrome supports no SOCKS5 login | Remove the login and use the allowlist, or switch to HTTP with a login |
| Worked yesterday, fails today | Your network's public IP changed | Update the allowlist |
apple.com or a .cn site shows your own IP | They are on the default Bypass List | Delete them from the list and save |
| "Your proxy settings are controlled by an extension" | The extension is in control of Chrome's proxy | Expected; switch Socks5 Proxy off to release it |
| Another proxy extension stops working | Only one extension can control the proxy | Keep one enabled |
| Some sites won't load | The site blocks the IP, or a restricted category | Some site categories are restricted to protect the network, including financial and government services |
Chromium's error texts: net_error_list.h. Gateway error messages: 407 Proxy Authentication Required for a wrong login or password, an IP not on the allowlist or a malformed location, 402 Payment Required when no traffic is left and 502 Bad Gateway when no exit could be connected; a restricted site gets no separate response, and a 403 comes from the site itself. Status codes are explained in proxy errors, and an extension controlling the proxy has its own guide. Our 24/7 live chat helps with setup and integration.
Which proxies to use over SOCKS5
| What you do | Proxy | Price |
|---|---|---|
| Browse and check sites by country or city | Residential | from $1.95/GB ($2.95 for 1 GB) |
| See what phone users see | Mobile 5G/4G | from $2.45/GB ($3.45 for 1 GB) |
| One fixed IP for daily logins | Dedicated ISP | from $2.29 per IP per 30 days |
Residential and mobile share one balance and run over HTTP, HTTPS and SOCKS5. A SOCKS5 proxy changes the IP and location that sites see; it is not a VPN and does not encrypt traffic by itself (proxy vs VPN). Use ProxyField for lawful work within our acceptable use policy.
Get started
Start with the Easy Trial: 1 GB for $2.95, with no minimum purchase and no subscription. The traffic never expires and all purchases are final. See pricing per GB.
SOCKS5 Configurator FAQ
How do I set up the SOCKS5 Configurator extension in Chrome with a residential proxy?
ProxyField's residential gateway works in SOCKS5 Configurator from $1.95/GB ($2.95 for 1 GB). Add your public IP to the allowlist in your account, check that Socks5 Proxy is on, enter gate.proxyfield.io with the port you set up in the dashboard and select Save. Load https://api.ipify.org to confirm the proxy's IP.
Does the SOCKS5 Configurator Chrome extension work with proxies that need a username and password?
No. The extension has no login fields at all, and Chrome sends SOCKS5 without authentication: Chromium's documentation says no authentication methods are supported for SOCKSv5 in Chrome. With ProxyField, allowlist your public IP and enter gate.proxyfield.io with the port you set up in the dashboard, or use HTTP with a login (<login>-country-us-city-new_york and your password) in a switcher such as ZeroOmega.
Which proxy providers offer SOCKS5 residential proxies that work with browser extensions and desktop apps alike?
A provider works for both when it runs SOCKS5 on residential IPs, serves extensions and desktop apps on one host, and takes both a login and an IP allowlist, because Chrome extensions cannot send a SOCKS5 login. ProxyField does all three on gate.proxyfield.io, on port 7000 with a username and password or on the port you set up in the dashboard for an allowlisted IP: residential proxies cost $2.95/GB for 1 GB down to $1.95/GB from 1,000 GB, and mobile $3.45 down to $2.45/GB. SOCKS5 Configurator takes it with the allowlist; Firefox with FoxyProxy, curl, Python, Proxifier, proxychains and antidetect browsers take the login.
What is the SOCKS5 Configurator extension?
An open-source extension by txthinking (MIT License) for Chrome and Edge, built on Manifest V3. It sends the browser's traffic to one SOCKS5 proxy and switches it on or off. It stores a host and port and a bypass list, with no login fields.
Can SOCKS5 Configurator use a ProxyField proxy?
Yes, with your IP on the allowlist in your ProxyField account: enter gate.proxyfield.io with the port you set up in the dashboard and save. Chrome's traffic then leaves from a ProxyField IP.
Where do I download SOCKS5 Configurator?
From the Chrome Web Store or the Edge Add-ons store: search for "SOCKS5 Configurator", check that the publisher is txthinking, and select Add to Chrome. Avoid copies from other download sites.
Is it safe to download SOCKS5 Configurator?
Install it only from the official store, where you can check the publisher; its source code is public on GitHub. Its manifest asks for proxy and storage plus host access to all sites, and Chrome warns that it can "Read and change all your data on all websites", as it does for every proxy extension. Give that only to an extension you trust.
What does a SOCKS configurator do?
It sets a SOCKS proxy for an app, usually a browser, without opening system settings, and switches it on or off. The proxy itself comes from a provider.
What settings does a SOCKS5 configuration need?
A host, a port, and either a username and password or an allowlisted IP. With ProxyField: gate.proxyfield.io, port 7000 with your account's login, or the port you set up in the dashboard with the allowlist.
What does a SOCKS5 config line look like?
Most tools take a URL such as socks5h://<login>:<password>@gate.proxyfield.io:7000; tools that read colon-separated lines use gate.proxyfield.io:7000:<login>:<password>. With your IP on the allowlist, drop the login part and use the port you set up in the dashboard.
Show 11 more questionsShow fewer questions
Should SOCKS configuration resolve DNS through the proxy?
Yes, in most cases: socks5h://, or ticking "Proxy DNS when using SOCKS v5" in Firefox, makes the proxy look up hostnames, so the lookup happens at the proxy's location. Without it, your own network looks up each hostname before the connection goes to the proxy.
Which apps take a SOCKS5 configuration?
Firefox, curl, Python, Linux tools through all_proxy or proxychains, most antidetect browsers, and Proxifier for Windows apps without a proxy setting. Chrome takes SOCKS5 through an extension or a command-line flag, without a login.
How do I set up a SOCKS proxy in Chrome without an extension?
Start Chrome with --proxy-server="socks5://gate.proxyfield.io:<port>", with your IP on the allowlist and <port> the port you set up in the dashboard. The flag applies until Chrome restarts without it.
What SOCKS5 proxy software do I need?
Usually none beyond the app you already use, if it speaks SOCKS5. For apps without a proxy setting, a client such as Proxifier on Windows or proxychains on Linux routes them through the proxy.
Do I need SOCKS proxy software to use ProxyField?
No. ProxyField is a gateway, not a program: you point any app that speaks HTTP, HTTPS or SOCKS5 at gate.proxyfield.io:7000. Nothing is installed on your side.
Why does SOCKS5 Configurator fail to connect?
Check the server first: it must be gate.proxyfield.io and the port you set up in the dashboard, host and port together. Then check that your current public IP is on the allowlist, for example after changing networks: add the IP api.ipify.org shows with the proxy off.
Why does SOCKS5 Configurator say "Invalid socks5 proxy address"?
The server field needs a host and a port together, and the port is missing. Enter gate.proxyfield.io with the port you set up in the dashboard and select Save again.
Why do apple.com and .cn sites skip the proxy in SOCKS5 Configurator?
The Bypass List is on by default with cn and apple.com, and each entry covers its subdomains too. Delete them from the list and save if those sites should use the proxy.
Should I use SOCKS5 or HTTP in a Chrome extension?
HTTP when you want a username and password, and a location in each entry's username. SOCKS5 in Chrome works only with the allowlist; for web pages, both carry the same traffic.
Does SOCKS5 Configurator change the IP for all apps?
No, only for Chrome. For other apps, set SOCKS5 in each app, or use client software such as Proxifier or proxychains.
How do I turn off SOCKS5 Configurator?
Switch Socks5 Proxy off and save, or disable the extension in chrome://extensions. Chrome then goes back to the system's proxy settings.