HTTP debugging proxy for developers and QA engineers. Route Charles Proxy through KnoxProxy as an upstream proxy to inspect and debug traffic while using real residential IPs from any target country.
Launch Charles Proxy. It starts recording traffic automatically.
Go to Proxy > External Proxy Settings from the menu bar.
Check "Use external proxy servers" and check "Web Proxy (HTTP)".
Fill in the upstream proxy fields for HTTP.
Web Proxy Server: gw.knoxproxy.com
Port: 7000
Proxy Authentication: checked
Username: your_username-country-us
Password: your_passwordCheck "Secure Web Proxy (HTTPS)" and enter the same KnoxProxy details.
Secure Proxy Server: gw.knoxproxy.com
Port: 7000
Username: your_username-country-us
Password: your_passwordOpen a browser configured to use Charles (localhost:8888) and visit httpbin.org/ip. Verify the IP matches your KnoxProxy target country in Charles traffic view.
{
"externalProxy": {
"http": {
"host": "gw.knoxproxy.com",
"port": 7000,
"username": "your_username-country-us",
"password": "your_password"
},
"https": {
"host": "gw.knoxproxy.com",
"port": 7000,
"username": "your_username-country-us",
"password": "your_password"
},
"bypassDomains": [
"localhost",
"127.0.0.1"
]
}
}Add -session-{debugSession} to the username for a consistent IP during a debugging session. Remove the session flag to rotate IPs between requests.
| Problem | Fix |
|---|---|
| HTTPS sites show certificate errors | Go to Help > SSL Proxying > Install Charles Root Certificate and trust it in your OS certificate store. |
| No traffic appears in Charles | Set your browser proxy to localhost:8888 or enable macOS/Windows proxy in Charles (Proxy > macOS Proxy / Windows Proxy). |
| External proxy connection fails | Verify gw.knoxproxy.com:7000 with correct username and password in Proxy > External Proxy Settings. |
USER-country-de-city-berlin-session-profile07Order matters -- geo flags before the session flag. The session name is free text; use the profile ID so the mapping is self-documenting. Password stays as issued; no flags belong there. HTTP on :7000, SOCKS5 on :7001, same credentials.
Yes. Install the Charles SSL certificate, enable SSL Proxying for target domains, and set KnoxProxy as the external proxy. You get full request/response inspection.
Minimal. Charles intercepts locally, and KnoxProxy handles the upstream connection. Total overhead is typically under 20ms.
Yes. Point your mobile device proxy to your machine running Charles. Traffic flows: device > Charles > KnoxProxy > internet.
Yes. Update the username in External Proxy Settings with a different -country-{cc} and restart the proxy.
Free trial on rotating residential -- 5 minutes setup, no credit card.