Home Pricing Web App Setup Guides Is the proxy not working? FAQ Blog Contact Partners

macOS Limitations (Introduction)

⚠️ Important Warning

The macOS operating system does not have built-in password fields in the system SOCKS5 proxy settings (System Settings → Network → Details → Proxies). If you try to enter login:password@address in the Server field, macOS will fail to parse it. To use a SOCKS5 proxy that requires authentication, you must use third-party applications or configure individual software directly.

Proxy Setup in Browsers

1. Firefox for macOS (Best Native Option)

Firefox is the only major browser with full native support for SOCKS5+Auth, requiring no additional extensions.

  • Step 1: Open Firefox SettingsGeneral → scroll down to Network Settings and click Settings...
  • Step 2: Select Manual proxy configuration.
  • Step 3: In the SOCKS Host field, enter the IP, and in the Port field — your port. Make sure to select SOCKS v5.
  • Step 4: The first time you open any website, a standard authorization window will appear—enter your proxy username and password there, checking the "Remember password" box.
DNS Leak Protection: Go to the about:config page, find the network.proxy.socks_remote_dns preference, and set its value to true.

2. Chrome / Edge / Safari / Brave

These browsers rely on the macOS system network stack, meaning they cannot work directly with password-protected SOCKS5 proxies without an extension.

  • Step 1: In Chromium-based browsers, install the Proxy SwitchyOmega extension (or a similar alternative).
  • Step 2: In the extension settings, create a New profile.
  • Step 3: Select the SOCKS5 protocol and enter the Server and Port.
  • Step 4: Click the "Lock" icon or "Authentication" label, enable the checkbox, and enter your username and password.
  • Step 5: Click Apply changes, click on the extension icon in the browser toolbar, and select your created profile to activate it.

System-Wide Proxy Applications

If you need to proxy your entire Mac or applications that lack built-in proxy settings (like Spotify, Discord, or games) — use proxy managers.

1. Proxifier for Mac Most Powerful (Paid)

Proxies any application traffic at the kernel level, perfectly supporting authentication.

  • Download it from the official homepage.
  • Go to ProfileProxy ServersAdd.
  • Enter the Address, Port, and select Protocol: SOCKS Version 5.
  • Check the Authentication box, and input your username and password. Click 'Check' to test the connection.
  • In ProfileProxification Rules, specify a Default rule routing to your proxy for the entire Mac, or link just the specific `.app` packages you want to proxy.

2. ProxyCap

Similar functionality and works excellently with SOCKS5. Rules are created just as easily (Specify Server → Enter SOCKS5 Auth → Apply rule per `.app` file).

Terminal, Scripts, and Development

Usage in cURL, Git, Wget

cURL: It's recommended to use the --socks5-hostname flag to prevent DNS requests from leaking outside the proxy tunnel.

curl --socks5-hostname login:pass@ip:port https://api.ipify.org

Git: Proxies can be configured globally or per-repository.

git config --global http.proxy "socks5://login:pass@ip:port"
git config --global https.proxy "socks5://login:pass@ip:port"

ENV Environment Variables (For Terminal Sessions)

Many system utilities (including Homebrew) and programming languages automatically read system variable presets. Configure them with the export command:

export ALL_PROXY="socks5://login:pass@ip:port"
export HTTP_PROXY="socks5://login:pass@ip:port"
export HTTPS_PROXY="socks5://login:pass@ip:port"

(For persistent usage, add these lines to your ~/.zshrc, but be aware of the security risks of storing unencrypted passwords in a text file).

Dockerization and Coding Languages

Python (requests): You must install socks support using pip install requests[socks].

import requests
proxies = {"http": "socks5://user:pass@ip:port", "https": "socks5://user:pass@ip:port"}
requests.get("https://api.ipify.org", proxies=proxies)

Node.js (axios): Requires the socks-proxy-agent NPM package.

const { SocksProxyAgent } = require('socks-proxy-agent');
const agent = new SocksProxyAgent('socks5://user:pass@ip:port');
axios.get('https://example.com', { httpsAgent: agent })

Docker (on Mac): Add JSON configuration for the entire Docker Engine daemon.

# File ~/.docker/daemon.json
{ "proxies": { "default": { "httpsProxy": "socks5://login:pass@ip:port" } } }

Standalone Applications

Telegram Desktop for macOS

  • Navigate to SettingsAdvancedConnection type.
  • Select Use custom proxy → Type: SOCKS5.
  • Enter the Host, Port, Username, and Password.
  • Save — the connection should light up with a green checkmark or blue shield icon.

Torrent Clients (qBittorrent)

  • In qBittorrent open SettingsConnection.
  • Set Proxy Type to SOCKS5 and provide all 4 parameters (including authentication).
  • ⚠️ Crucial: Enable the checkboxes for "Use proxy for peer connections" and "Use proxy for hostname lookups", otherwise your real IP address will leak to the peer swarm.

Advanced Methods

proxychains-ng (Routing Specific Commands)

A powerful tool that intercepts system calls and forces any given console program's TCP connections through a proxy.

brew install proxychains-ng
nano /opt/homebrew/etc/proxychains.conf

At the very bottom of the config file, add: socks5 IP PORT username password

Execution: proxychains4 curl https://api.ipify.org

(Note: It may be incompatible with certain binaries due to SIP - System Integrity Protection in newer macOS releases).

Local SSH Tunnel + pf Firewall

Create a passwordless SOCKS5 tunnel directly on your Mac, routing your traffic through a remote SSH server execution.

ssh -D 1080 -N -C [email protected]

You can then configure the built-in macOS pf firewall to transparently redirect all traffic to the local port 1080 (127.0.0.1:1080). This method is strictly for experienced system administrators!

Security and Common Mistakes

❌ What You Should NEVER Do

Proxying Local Traffic (localhost)

If you configure ENV variables, you MUST always include export NO_PROXY="localhost,127.0.0.1,.local". Failure to do so will severely break local services and development servers.

Entering Passwords in Mac System Settings

Do not attempt to paste SOCKS5 Auth data directly into the default Mac Network Wi-Fi proxy menus. macOS will simply drop the connection.

Ignoring DNS Protocols

Always verify that domain resolutions are being routed securely. Check dnsleaktest.com. If the interface logs exhibit DNS servers tied to your home internet provider—you have a data leak!

💡

Summary / Cheat-Sheet Checklist:

Only need a proxy inside a Web Browser? → Your best choice is Firefox.
Need to tunnel the whole computer (or a game skipping proxy menus)? → Grab Proxifier.
Coding in the Terminal daily? → Exporting System ENV variables will suffice.

⚠️
Found an error or the method isn't working?

Technology is constantly evolving. If the guide is outdated, you encounter an issue, or something isn't working — let us know! We will quickly verify the information and help you get set up.

Contact Support

🤖
Need personalized help?

Leverage the power of AI. We've prepared a specific prompt for ChatGPT that will analyze your situation and provide a step-by-step connection guide for your device.

Ask ChatGPT