Integrations menu
Proxy app setup

SOCKS5 Configurator: Username and Password, Setup and Fixes

No: SOCKS5 Configurator cannot use a proxy that needs a username and password. The extension has no login fields, and Chrome sends SOCKS5 without authentication: Chromium's documentation says "No authentication methods are supported for SOCKSv5 in Chrome". Firefox with FoxyProxy, curl and Proxifier do send a SOCKS5 login. With ProxyField, add your public IP to the allowlist in your account and enter gate.proxyfield.io with the port you set up in the dashboard in the extension; start with the Easy Trial, 1 GB of residential traffic for $2.95 that never expires.

residential IPs
412M+
from, traffic never expires
$1.95/GB
Easy Trial
1 GB for $2.95
gate.proxyfield.io:7000
What SOCKS5 Configurator takes
SOCKS5 Configurator settingProxyField value
Server fieldgate.proxyfield.io and the port you set up in the dashboard, typed together as gate.proxyfield.io:<port>
Username and passwordnone: the extension has no login fields and Chrome sends no SOCKS5 login, so add your public IP to the allowlist (up to 100 IPv4 addresses)
Location and sessionwith the allowlist, the product, location and session are set per port in the dashboard
Gateway for other appsgate.proxyfield.io, port 7000: HTTP, HTTPS and SOCKS5 all run on the same host and port, with a username and password
Username (other apps)<login>-country-us-city-new_york; the optional keys are -country-<cc>, -region-<region>, -city-<city>, -session-<id> and -ttl-<seconds> (30 to 129,600 s, 20 min when ttl is left out); add -mobile or -dc right after the login for mobile or rotating datacenter IPs (-dc takes the country only)
Password (other apps)your ProxyField password
SOCKS5 with a loginFirefox with FoxyProxy, curl, Python and Proxifier send the same username and password; where a tool asks for a proxy URL, write socks5h:// so the gateway resolves the site's name
A login in ChromeHTTP on gate.proxyfield.io:7000 in a switcher with login fields, such as ZeroOmega
IP behavioura new IP on every request, or one IP for 30 s to 36 h with -session-<id>-ttl-<seconds> in the username; with the allowlist, set on the port
UDPUDP over SOCKS5 on residential (HTTP/3, QUIC)
Headersthe gateway adds no Via, X-Forwarded-For or Forwarded header; the headers Chrome sends pass through; your Proxy-Authorization is removed before the request goes to the site

Set up SOCKS5 Configurator with ProxyField

  1. With no proxy on, open https://api.ipify.org and add that IP to the allowlist in your ProxyField account.
  2. Install SOCKS5 Configurator from the Chrome Web Store (publisher: txthinking).
  3. Check that Socks5 Proxy is on and enter gate.proxyfield.io:<port>, with the port you set up in the dashboard.
  4. Select Save and reload https://api.ipify.org: it shows a proxy IP, not yours.
  5. For a login or a city per entry, use HTTP on gate.proxyfield.io:7000 in 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:

WhereSOCKS5 with a username and password?How it logs in to ProxyField
SOCKS5 Configurator and any Chrome extensionnoyour IP on the allowlist, on the port you set up in the dashboard
Desktop apps: Firefox with FoxyProxy, curl, Python, Proxifier, proxychains, antidetect browsersyes<login>:<password> on gate.proxyfield.io:7000
Chrome with a login and a location per entryover HTTP, not SOCKS5HTTP 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:

Python
# 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>:

Shell
google-chrome --user-data-dir=/tmp/socks-test --proxy-server="socks5://gate.proxyfield.io:<port>" https://api.ipify.org

ipify then shows a ProxyField IP. Leave the login out of the address: Chrome supports no SOCKS5 login.

Two ways that work:

You haveDo 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 entryUse 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:

SettingDefaultOnOff
Socks5 Proxy switchonChrome's traffic goes through the server in the fieldChrome goes back to the system proxy settings
Server fieldemptytakes host:port, such as 127.0.0.1:1080 or [::1]:1080; no login fields—
Bypass List switch and boxon, with cn and apple.comthe listed domains, their subdomains and private and local addresses skip the proxyonly 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

  1. Find your public IP. With no proxy on, open https://api.ipify.org. You see your own network's IP; note it.
  2. 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.
  3. 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.
  4. 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
  5. 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
  6. Check the Bypass List, then save. You see the switch on, with cn and apple.com in the box. Delete them if you want those sites through the proxy as well. Then select Save.

  7. 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/json shows the proxy's city and country. What you see (example values):

    198.51.100.73
    {"ip": "198.51.100.73", "city": "…", "region": "…", "country": "US", …}
  8. 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:

FieldValue
ProtocolHTTP
Servergate.proxyfield.io
Port7000
Username<login>-country-us-city-new_york
Passwordyour ProxyField password

Test the same entry from a terminal first:

Shell
curl -x gate.proxyfield.io:7000 -U "<login>-country-us-city-new_york:<password>" https://api.ipify.org

Region, 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 seconds

Residential is the default; add -mobile after the login for mobile IPs: <login>-mobile-country-us.

SessionHow to set itWhat happens
Rotatingno -session- parta new IP on every request
Sticky-session-<id>one IP for 20 minutes
Sticky, your length-session-<id>-ttl-<seconds>, 30 to 129,600one 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
WhereExampleSOCKS5 login supportedHow it logs in to ProxyField
Chrome extensionSOCKS5 Configuratornoallowlist
Chrome, no extension--proxy-server="socks5://gate.proxyfield.io:<port>"noallowlist, on the port you set up in the dashboard
Chrome switchers with loginZeroOmega, Proxy SwitcherHTTP loginusername and password over HTTP
FirefoxSettings → Network Settings → Manual proxy configuration → SOCKS Host, SOCKS v5, tick Proxy DNS when using SOCKS v5 (Firefox, FoxyProxy)yes, in FoxyProxyusername and password, or allowlist
curlcurl -x "socks5h://<login>:<password>@gate.proxyfield.io:7000" https://api.ipify.org (cURL)yesusername and password
Python requestspip install requests[socks], then socks5h:// in proxies (Python)yesusername and password
Linux toolsall_proxy, or proxychains (Linux)yesusername and password
Windows apps without a proxy settingProxifier (Windows)yesusername and password
Antidetect browsersthe profile's proxy type set to SOCKS5 (antidetect browsers)yesusername and password
Playwrightproxy option with server, username, passwordlogin fields for HTTP(S) proxies only, per its docsHTTP with a login, or SOCKS5 with the allowlist
Puppeteer, Selenium with ChromeChrome's --proxy-server flagno: Chrome's own limitHTTP with a login, or SOCKS5 with the allowlist
Scrapythe proxy meta key, http://<login>:<password>@gate.proxyfield.io:7000SOCKS only with a download handler that supports it, per its docsusername 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:

  1. Is SOCKS5 offered on residential IPs, not only on datacenter? ProxyField: yes, on residential and mobile, from $1.95/GB and $2.45/GB.
  2. Which host and port? ProxyField: gate.proxyfield.io:7000 with a username and password, the same as HTTP and HTTPS; with the IP allowlist, the port you set up in the dashboard.
  3. Login or allowlist? ProxyField: both, username:password or an IP allowlist. Chrome extensions need the allowlist.
  4. Which apps take it? See the table above. Ask about your own app in the 24/7 live chat.

Check the proxy

  1. Turn the extension on and load https://api.ipify.org: the exit IP, not yours.
  2. Turn it off and reload: your own IP again.
  3. 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

SymptomLikely causeFix
"Invalid socks5 proxy address" when you saveThe port is missingEnter host and port together: gate.proxyfield.io and the port you set up in the dashboard
ERR_SOCKS_CONNECTION_FAILEDChromium: "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 anotherCheck 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_PROXIESChromium: "There are no supported proxies in the provided list"; here it may be a login in a SOCKS5 address (socks5://user:pass@host:port, for example in the --proxy-server flag), since Chrome supports no SOCKS5 loginRemove the login and use the allowlist, or switch to HTTP with a login
Worked yesterday, fails todayYour network's public IP changedUpdate the allowlist
apple.com or a .cn site shows your own IPThey are on the default Bypass ListDelete them from the list and save
"Your proxy settings are controlled by an extension"The extension is in control of Chrome's proxyExpected; switch Socks5 Proxy off to release it
Another proxy extension stops workingOnly one extension can control the proxyKeep one enabled
Some sites won't loadThe site blocks the IP, or a restricted categorySome 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 doProxyPrice
Browse and check sites by country or cityResidentialfrom $1.95/GB ($2.95 for 1 GB)
See what phone users seeMobile 5G/4Gfrom $2.45/GB ($3.45 for 1 GB)
One fixed IP for daily loginsDedicated ISPfrom $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.

Easy Trial: 1 GB for $2.95.

Try for the price of 1 GB, no subscription, traffic never expires.