Set up a Mac with ProxyField
- Open the Apple menu → System Settings → Network, select Wi-Fi (or Ethernet), click Details…, then Proxies.
- Turn on Web proxy (HTTP) and enter server
gate.proxyfield.io, port7000. - Turn on Proxy server requires password and enter your username and password.
- Do the same for Secure web proxy (HTTPS), click OK, and repeat for each network service you use.
- Open
https://api.ipify.orgin Safari: it shows an IP that is not yours.
The same Web proxy (HTTP) entry from Terminal with networksetup (section 3 keeps the password out of your shell history):
networksetup -setwebproxy "Wi-Fi" gate.proxyfield.io 7000 on "<login>-country-us-city-new_york" "<password>"Apple's own guide to the Proxies pane: Change proxy settings on Mac (Apple).
| macOS | Where the proxy settings are |
|---|---|
| Ventura 13 and later (System Settings) | Apple menu → System Settings → Network → (your network) → Details… → Proxies |
| Monterey 12 and earlier (System Preferences) | Apple menu → System Preferences → Network → (your network) → Advanced… → Proxies |
The option names follow Apple's guide Change proxy settings on Mac. Apple's guide stops at the option list; section 1 below adds what you should see after each step and a Terminal check.
- SOCKS5 for the whole Mac: turn on SOCKS proxy in the same pane, or in Terminal run
sudo networksetup -setsocksfirewallproxy "Wi-Fi" gate.proxyfield.io 7000 on "<login>-country-us" "$PF_PASS"(section 2 reads the password withread -s, so it stays out of your shell history). - Safari, Chrome and Terminal on one US residential IP: use one sticky username in all three apps. Use the HTTP and HTTPS entries rather than SOCKS, because Chrome cannot send a SOCKS username and password and Safari does not pass a SOCKS5 password (section 2). Residential costs $2.95/GB for 1 GB, down to $1.95/GB from 1,000 GB.
# Proxies pane (Safari, Chrome): username <login>-country-us-session-mac4us01-ttl-3600
export https_proxy="http://<login>-country-us-session-mac4us01-ttl-3600:<password>@gate.proxyfield.io:7000"; curl https://api.ipify.orgThe IP holds for the ttl you set, up to 36 h. If all three apps sit idle for 120 s, or the exit node drops, you get a new IP. For one address that lasts for days, use a dedicated ISP IP from $2.29 per 30 days (section 4).
| You need | Use | Price |
|---|---|---|
| One US IP for Safari, Chrome and Terminal during a session | Residential, sticky session (-session-<id>-ttl-<seconds>) | $2.95/GB for 1 GB down to $1.95/GB from 1,000 GB |
| The same IP for days, such as for an account login | Dedicated static residential (ISP) proxy | from $2.29 per IP for 30 days |
| What phone users see | Mobile 5G/4G, sticky or rotating | $3.45/GB for 1 GB down to $2.45/GB from 1,000 GB |
Labels can differ slightly between versions. New to ProxyField? See the quick start; our 24/7 live chat helps with setup and integration.
On this page 12 sections
1. Set a proxy that needs a login in System Settings (macOS 13 and later)
- Open the Apple menu → System Settings → Network. You see your network services (Wi-Fi, Ethernet, any VPN), with the one in use marked Connected.
Screenshot System Settings with Network selected in the sidebar - Select Wi-Fi (or Ethernet), then click Details… next to the connected network. A dialog opens with a sidebar that includes TCP/IP, DNS and Proxies.
Screenshot Wi-Fi pane with the Details button next to the connected network - Click Proxies. You see a switch for each proxy type, from Auto proxy discovery to SOCKS proxy, then Exclude simple hostnames and the bypass list; you may need to scroll down to see every option.
Screenshot Network details dialog with Proxies selected - Turn on Web proxy (HTTP) and enter Server
gate.proxyfield.io, Port7000. Turn on Proxy server requires password and enter your username and password. The username is your login plus optional parts:<login>-country-usfor any US IP, or<login>-country-us-session-mac4us01-ttl-3600to keep one US IP for an hour. With the switch on, Server and Port fields appear; with Proxy server requires password on, Username and Password fields appear.Screenshot Web proxy (HTTP) turned on with server gate.proxyfield.io, port 7000, Proxy server requires password on and a username - Turn on Secure web proxy (HTTPS) and enter the same server, port, username and password. The password option exists for the web, secure web and SOCKS proxies; fill it for each one you turn on.
Screenshot Secure web proxy (HTTPS) turned on with the same values - Keep the entries in Bypass proxy settings for these hosts & domains and add
localhost.Screenshot Bypass proxy settings field with localhost added - Click OK. The dialog closes and the switches you turned on stay on. In Terminal,
scutil --proxynow showsHTTPEnable : 1,HTTPProxy : gate.proxyfield.io,HTTPPort : 7000and the same threeHTTPSlines;https://api.ipify.orgin Safari shows an IP that is not yours (section 6).Screenshot Proxies pane with the OK button
Read moreShow less
Every option in the Proxies pane (names as in Apple's guide), and what to set for ProxyField:
| Option in Proxies | What it does | For ProxyField |
|---|---|---|
| Auto proxy discovery | Finds proxy settings on the network automatically | Leave off |
| Automatic proxy configuration | Uses a PAC file from a URL | Only for a PAC setup (section 10) |
| Web proxy (HTTP) | Proxy for plain HTTP | On: gate.proxyfield.io, 7000 |
| Secure web proxy (HTTPS) | Proxy for HTTPS | On: gate.proxyfield.io, 7000 |
| SOCKS proxy | Proxy for apps that use SOCKS | On only if you need it (section 2) |
| Proxy server requires password | Sends a username and password to the proxy | On, with your ProxyField credentials; off with the IP allowlist, with the port you set up in the dashboard in place of 7000 |
| Exclude simple hostnames | Skips the proxy for names without a dot, such as printer | On if you use local devices |
| Bypass proxy settings for these hosts & domains | Hosts that go direct, separated by commas | Keep the defaults, add localhost |
With the IP allowlist, leave the password off and enter the port you set up in the dashboard instead of 7000; the product, location and session are then set per port in the dashboard. On macOS 12 and earlier, the same fields are in System Preferences → Network → Advanced… → Proxies. Proxies are set per network service: repeat the steps for Ethernet if you use it.
2. SOCKS5 system-wide on a Mac
Turn on SOCKS proxy in the Proxies pane, enter the server and port, turn on Proxy server requires password, and repeat for each network service (Wi-Fi, Ethernet). Apps that read the macOS network settings follow it; VPNs, command-line tools and apps with their own proxy settings may not, and Chrome cannot send a SOCKS username and password (below).
Read moreShow less
- In Network → Details… → Proxies, turn on SOCKS proxy.
- Enter
gate.proxyfield.ioand port7000, turn on Proxy server requires password and enter your credentials. - Click OK, and repeat for each network service you use (Wi-Fi, Ethernet).
Or from Terminal: list the services, set the proxy, check it, and turn it off when you are done. read -s keeps the password out of your shell history.
networksetup -listallnetworkservices # "Wi-Fi", "Ethernet", ...
read -s "PF_PASS?ProxyField password: "; echo
sudo networksetup -setsocksfirewallproxy "Wi-Fi" gate.proxyfield.io 7000 on "<login>-country-us" "$PF_PASS"
networksetup -getsocksfirewallproxy "Wi-Fi" # Enabled: Yes, Server: gate.proxyfield.io, Port: 7000, Authenticated Proxy Enabled: 1
scutil --proxy # SOCKSEnable : 1, SOCKSProxy : gate.proxyfield.io
sudo networksetup -setsocksfirewallproxystate "Wi-Fi" off # turn it offsudo asks for your Mac's administrator password, not your ProxyField password.
What "system-wide" covers: apps that use macOS networking, such as Safari. It does not cover:
- Terminal tools. curl reads its own variable:
export all_proxy="socks5h://<login>:<password>@gate.proxyfield.io:7000". Withsocks5h://, DNS lookups go through the proxy too. To test SOCKS5 in one command:curl --socks5-hostname gate.proxyfield.io:7000 -U "<login>-country-us:<password>" https://api.ipify.orgprints the proxy's IP. - UDP. The Proxies pane has no UDP option, so calls, games and QUIC traffic from apps usually go direct; Chrome's own documentation says its SOCKS5 support "cannot be used to relay UDP traffic" (Chromium proxy docs). ProxyField residential proxies support UDP over SOCKS5 (HTTP/3, QUIC), so use an app that speaks SOCKS5 UDP itself, or a per-app tool such as Proxifier for TCP apps that ignore the system setting.
- Chrome with a SOCKS password. "No authentication methods are supported for SOCKSv5 in Chrome" (the same Chromium page). For Chrome over SOCKS, use the IP allowlist with the port you set up in the dashboard in the SOCKS proxy field, or the HTTP and HTTPS proxies above.
| Browser | SOCKS proxy with a password | Web proxy (HTTP) and Secure web proxy (HTTPS) with a password |
|---|---|---|
| Safari | Does not pass a SOCKS5 password; use the IP allowlist and the port you set up in the dashboard | Follows the Proxies pane |
| Chrome | Not supported; use the IP allowlist and the port you set up in the dashboard | Works: use these entries for Chrome |
Your own server instead: ssh -D 127.0.0.1:1080 user@your-server makes ssh itself a SOCKS server (SOCKS4 and SOCKS5) on port 1080 that tunnels through that server. Binding it to 127.0.0.1 keeps it to this Mac; without an address, ssh binds the port according to its GatewayPorts setting, which is loopback only by default (see the ssh(1) manual, option -D). Enter 127.0.0.1 and 1080 in the same SOCKS proxy field, with no password. Your traffic then leaves from that server's IP. More on the protocol: SOCKS5 proxies.
3. Set the proxy from Terminal (networksetup)
networksetup changes the same settings as the Proxies pane; read -s keeps the password out of your shell history.
# 1. List your network services ("Wi-Fi", "Ethernet", ...)
networksetup -listallnetworkservices
# 2. Your values (zsh, the default macOS shell)
SERVICE="Wi-Fi"
PF_USER="<login>-country-us"
read -s "PF_PASS?ProxyField password: "; echo
# 3. HTTP, HTTPS and SOCKS proxies
networksetup -setwebproxy "$SERVICE" gate.proxyfield.io 7000 on "$PF_USER" "$PF_PASS"
networksetup -setsecurewebproxy "$SERVICE" gate.proxyfield.io 7000 on "$PF_USER" "$PF_PASS"
networksetup -setsocksfirewallproxy "$SERVICE" gate.proxyfield.io 7000 on "$PF_USER" "$PF_PASS"
# 4. Hosts that skip the proxy (replaces the current list)
networksetup -setproxybypassdomains "$SERVICE" "*.local" "169.254/16" localhost 127.0.0.1
# 5. Show the active proxy settings
scutil --proxyRun it once per network service (Wi-Fi, Ethernet), with sudo if networksetup asks for administrator rights. Then check the username in the Proxies pane; if it is empty, enter it there.
4. One US residential IP for Safari, Chrome and Terminal
Give Safari, Chrome and Terminal one username with a sticky session, and all three leave from the same US residential IP: Safari and Chrome read it from the Proxies pane, Terminal from http_proxy and https_proxy. The IP holds for up to 36 h, and you pay only for the GB you load: 1 GB is $2.95 with the Easy Trial.
Read moreShow less
- Pick a username with a session:
<login>-country-us-session-mac4us01-ttl-3600(one hour). Add-region-<state>or-city-<city>for a place, as in<login>-country-us-region-new_york-city-new_york-session-mac4us01-ttl-3600. - Proxies pane: enter it as the username for Web proxy (HTTP) and Secure web proxy (HTTPS) (section 1). Safari and Chrome use it.
- Terminal: set the same username in your shell:
PF_USER="<login>-country-us-session-mac4us01-ttl-3600"
read -s "PF_PASS?ProxyField password: "; echo
export http_proxy="http://${PF_USER}:${PF_PASS}@gate.proxyfield.io:7000"
export https_proxy="$http_proxy"
curl https://api.ipify.org # the same IP that https://api.ipify.org shows in Safari and ChromeCheck all three in 30 seconds; each should show the same US IP:
| Where | What you do | What you should see |
|---|---|---|
| Safari | open https://api.ipify.org | an IP that is not yours |
| Chrome | open https://api.ipify.org | the same IP as Safari |
| Terminal | curl https:// after the export lines | the same IP again; curl https:// shows "country": "US" |
How long the IP holds:
| Rule | Value |
|---|---|
| Session time | the ttl you set, 30 s to 36 h (ttl-30 to ttl-129600); 20 min without ttl |
| Idle IP | an IP idle for 120 s gets a new IP |
| Exit node drops | the IP is not guaranteed: the gateway retries once with a new session, so the IP may change |
| New IP on demand | change the session id (mac4us02) in all three places |
For a login that must see the same IP for days, use a dedicated static residential (ISP) proxy: from $2.29 per IP for 30 days, renewed by you in the dashboard. ISP proxies are sold in the countries their order form lists, which follow stock.
What the shared US IP costs: ProxyField residential proxies cost $2.95/GB for 1 GB, $2.79 from 10 GB, $2.65 from 50 GB, $2.49 from 100 GB, $2.29 from 250 GB, $2.09 from 500 GB and $1.95 from 1,000 GB; the tier rate applies to the whole purchase, there is no subscription and the traffic never expires. Browsing on one IP uses only the GB you load. More: sticky vs rotating proxies.
5. Which apps use the Mac's proxy
| App | Follows the system proxy? | What to do |
|---|---|---|
| Safari | Yes | Nothing. |
| Chrome | Yes | For a Chrome-only proxy: Chrome proxy settings. |
| Firefox | Only with Use system proxy settings selected | Select it, or see Firefox proxy settings. |
| Terminal tools (curl and others) | No | Set https_proxy and http_proxy (section 4), or see proxy for Terminal commands. |
| Apps with their own proxy setting | Their setting wins | Set the proxy in the app. |
| UDP traffic (voice calls, games, QUIC) | Usually not | The Proxies pane has no UDP option (section 2). |
For an iPhone or iPad, see iPhone and iPad.
6. Check the proxy works
Open https://api.ipify.org in Safari: you should see an IP that is not yours; https://ipinfo.io/json shows its country and city. In Terminal, scutil --proxy lists the active settings, and this tests your credentials:
curl -x gate.proxyfield.io:7000 -U "<login>-country-us-city-new_york:<password>" https://api.ipify.orgOr test your proxy in the ProxyField checker: up to 100 proxies per check, and your list and results are not stored.
A proxy changes your IP, its location and its reputation; it does not solve CAPTCHAs or hide a browser's fingerprint.
7. Country, city and sessions
The username carries the location: <login>-country-us (United States) or <login>-country-us-city-new_york (New York). Change it in the Proxies pane to switch. Targeting covers country, region (state) and city, and in the US all 50 states, at the same price per GB; ASN, ZIP and carrier targeting are not offered.
You get a new IP on every request, or a sticky session that holds one IP from 30 s to 36 h (presets 1, 5, 10, 30 min, 1, 3, 6 h). Region, session and session time go in the same username: -region-<region>, -session-<id> and -ttl-<seconds> (30 to 129,600 seconds, 20 minutes by default); every part after the login is optional. Names are lowercase with underscores (city-new_york). Residential is the default; add -mobile after the login for mobile IPs: <login>-mobile-country-us. All parameters: location targeting.
8. Turn off the proxy on a Mac
In Network → Details… → Proxies, switch off each proxy and click OK. Or in Terminal:
SERVICE="Wi-Fi"
networksetup -setwebproxystate "$SERVICE" off
networksetup -setsecurewebproxystate "$SERVICE" off
networksetup -setsocksfirewallproxystate "$SERVICE" offIn Terminal sessions where you exported variables, run unset http_proxy https_proxy all_proxy.
9. Fix proxy errors on a Mac
Most errors are a typo or the wrong network service.
| Symptom | Likely cause | Fix |
|---|---|---|
| Safari can't open the page after setup | Wrong server, port or protocol | Check gate.proxyfield.io and port 7000. |
| The password prompt keeps coming back | Wrong username format, or an old password in the keychain | Copy the username from the dashboard; delete the old gate.proxyfield.io entry in Keychain Access. |
| Works on Wi-Fi, not on Ethernet | Proxies are set per network service | Set both services. |
| An app ignores the proxy | Its own setting, Terminal, or UDP | Set the proxy in the app, or the variables in section 4. |
| Safari and Terminal show different IPs | Different usernames or session ids, or Terminal has no proxy variables | Use the same username with the same session in both (section 4). |
| Wrong country | A username typo, or a reused connection | Fix the spelling, then restart the app. |
| Your own IP shows | The host is on the bypass list, or Exclude simple hostnames matched it | Remove it from the list. |
| A site category won't load | Some site categories are restricted to protect the network, including financial and government services. | See our Acceptable Use Policy. |
The gateway answers 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. All errors: proxy errors.
10. Automatic proxy configuration (PAC)
Automatic proxy configuration takes a PAC file URL, to proxy only some domains:
function FindProxyForURL(url, host) {
if (dnsDomainIs(host, ".example.com")) {
return "PROXY gate.proxyfield.io:7000";
}
return "DIRECT";
}A PAC file holds no credentials, so either sign in when an app asks, or use the IP allowlist and put the port you set up in the dashboard in place of 7000. Leave out a DIRECT fallback for proxied domains: with it, a failed proxy sends those requests from your own IP.
Get a proxy for your Mac
Start with the Easy Trial: 1 GB for $2.95: no minimum purchase, no subscription. All purchases are final; in return, your traffic never expires.
Mac Proxy Settings FAQ
What's a good proxy service for a MacBook if Safari, Chrome and Terminal all need to share one US residential IP?
ProxyField residential proxies, from $2.95/GB for 1 GB down to $1.95/GB: put one sticky username, such as <login>-country-us-session-mac4us01-ttl-3600, in the Proxies pane for Safari and Chrome and in http_proxy and https_proxy for Terminal, and curl https://api.ipify.org shows the same US IP in all three. The session holds up to 36 h, but an IP idle for 120 s is replaced and an IP is not guaranteed if its exit node drops, so for the same address for days use a dedicated ISP IP from $2.29 per IP for 30 days. Browsing on one IP uses only the GB you load, and the Easy Trial (1 GB for $2.95) covers a first test.
Where are the proxy settings in the new macOS System Settings, and how do I add a proxy that needs a login?
Apple menu → System Settings → Network → (your network) → Details… → Proxies (on macOS 12 and earlier, System Preferences → Network → Advanced… → Proxies). Turn on Web proxy (HTTP) or Secure web proxy (HTTPS), enter the server and port, turn on Proxy server requires password, enter the username and password, and click OK; repeat for each network service. For ProxyField, the server is gate.proxyfield.io and the port 7000, with a username such as <login>-country-us.
How do I set up a SOCKS5 proxy system-wide on a Mac?
Open System Settings → Network → (your network) → Details… → Proxies, turn on SOCKS proxy, enter the server and port (gate.proxyfield.io, 7000 for ProxyField), turn on Proxy server requires password, and repeat for each network service; or run networksetup -setsocksfirewallproxy and turn it off with -setsocksfirewallproxystate "Wi-Fi" off. Apps that read the macOS network settings follow it; VPNs, Terminal tools (they need all_proxy="socks5h://…") and apps with their own proxy setting may not, and UDP usually goes direct.
How do I configure a proxy on macOS?
Turn on Web proxy (HTTP) and Secure web proxy (HTTPS) in the Proxies pane with gate.proxyfield.io, port 7000, your username and password, then click OK. Or set the same values from Terminal with networksetup -setwebproxy and -setsecurewebproxy.
How do I set a proxy on a Mac from Terminal?
Use networksetup: -setwebproxy, -setsecurewebproxy and -setsocksfirewallproxy with the service name, server, port and credentials, then scutil --proxy to show the result (section 3). Run it once per network service, such as Wi-Fi and Ethernet.
How do I check which proxy my Mac is using?
Run scutil --proxy in Terminal: it lists HTTPProxy, HTTPSProxy and SOCKSProxy with their ports. For one service, networksetup -getwebproxy "Wi-Fi" or -getsocksfirewallproxy "Wi-Fi" shows whether it is enabled.
How do I turn off the proxy on a Mac?
Switch each proxy off in the Proxies pane, or run networksetup -setwebproxystate "Wi-Fi" off and the matching HTTPS and SOCKS commands. In Terminal, also run unset http_proxy https_proxy all_proxy.
Which protocol should I use for a Mac proxy: HTTP, HTTPS or SOCKS?
Turn on both Web proxy (HTTP) and Secure web proxy (HTTPS) for browsing: together they cover plain and encrypted sites. Use SOCKS for apps that need it; ProxyField serves all three on port 7000 with the same username and password.
Does macOS route every app through the same proxy?
Only apps that use macOS networking, such as Safari and Chrome. Apps with their own proxy setting, command-line tools and UDP traffic don't follow it; set the proxy in those apps, or the variables in your shell.
Why does UDP traffic skip the macOS SOCKS proxy?
The Proxies pane has no UDP option, so voice calls, games and QUIC from most apps go direct, and Chrome's SOCKS5 support relays TCP only. ProxyField residential proxies do support UDP over SOCKS5 (HTTP/3, QUIC), so use an app that speaks SOCKS5 UDP itself.
Show 13 more questionsShow fewer questions
Does the Mac's proxy apply to Terminal?
No. curl and many other command-line tools ignore it. Set http_proxy and https_proxy (or all_proxy for SOCKS) in your shell; the commands are in section 4 and on the cURL proxy page.
How do I change proxy settings in Safari on Mac?
Safari uses the system settings: Safari → Settings → Advanced → Proxies: Change Settings opens the same Network pane. Change the proxy there, and other apps that follow macOS change with it.
Can I use ssh -D as a SOCKS proxy on a Mac?
Yes: ssh -D 127.0.0.1:1080 user@your-server opens a SOCKS proxy on this Mac at 127.0.0.1:1080; enter that in the SOCKS proxy field without a password. Your traffic then leaves from that one server's IP, not from a residential IP in the country you choose.
How do I fix proxy errors on a Mac?
Check the server, port and username, clear an old keychain password, and set the proxy on every network service (section 9).
Why does my Mac keep asking for the proxy password?
Usually the username in the Proxies pane is missing its parameters or the keychain holds an old password. Copy the username and password from your dashboard, then delete any old gate.proxyfield.io entry in Keychain Access; with the IP allowlist, turn the password off instead and use the port you set up in the dashboard.
Why do my Mac proxy settings keep resetting?
Another app, such as a VPN or a proxy tool, or a configuration profile may manage the proxy. Quit those apps and check the profiles in System Settings; remember that each network service keeps its own settings.
Why does my Mac proxy work on Wi-Fi but not on Ethernet?
Proxies are set per network service. Open Details… → Proxies for Ethernet too, or run the networksetup commands once for each service.
How do I verify that the macOS proxy works?
Open https://api.ipify.org in Safari: it should show an IP that is not yours, and scutil --proxy lists the active settings. Or test your proxy in the ProxyField checker, up to 100 proxies per check.
How do I tell whether a proxy failure is on my Mac or upstream?
Run curl -x gate.proxyfield.io:7000 -U "<login>:<password>" https://api.ipify.org in Terminal. If it returns an IP, the proxy works and the Mac's settings or the app are the problem; if not, check the credentials and the network.
Can I use automatic proxy configuration (PAC) on a Mac?
Yes: turn on Automatic proxy configuration and enter your PAC file's URL (section 10). A PAC file holds no credentials, so sign in when an app asks, or use the IP allowlist with the port you set up in the dashboard in the PAC file.
How do I use a SOCKS5 proxy on Mac, Windows and mobile?
What is the best proxy for Mac?
ProxyField residential proxies cost from $1.95/GB and mobile 5G/4G proxies from $2.45/GB, on one balance, and both work in the Proxies pane, in Terminal and over SOCKS5. Choose residential for browsing and data in a chosen country or city, mobile to see what phone users get, and a static residential (ISP) proxy from $2.29 per IP for 30 days when one address must stay the same for days.
How do I find the proxy server address and port my Windows or Mac computer is using?
On a Mac, open System Settings → Network → (your network) → Details… → Proxies, or run scutil --proxy in Terminal, which lists HTTPProxy, HTTPSProxy and SOCKSProxy with their ports. On Windows, open Settings → Network & internet → Proxy; services that use WinHTTP keep their own setting, which netsh winhttp show proxy shows. For ProxyField, the address is gate.proxyfield.io with port 7000 for a username and password, or the port you set up in the dashboard with the allowlist.