Protocols & examples

socks.cat auto-detects the inbound protocol from the first bytes of the connection, so one host/port accepts SOCKS5, SOCKS4/4a, HTTP and HTTPS. It also translates between them: you can come in as SOCKS5 and exit through an HTTP upstream, and every other combination.

Throughout, replace COLLAR with your collar tag (plus optional routing tags), PAWPRINT with your pawprint, and socks.cat:1337 with the gateway host.

curl

# HTTP / HTTPS proxy
curl -x http://COLLAR:PAWPRINT@socks.cat:1337 https://example.com

# SOCKS5 (remote DNS via socks5h)
curl -x socks5h://COLLAR:PAWPRINT@socks.cat:1337 https://example.com

# SOCKS4 — userid carries the username; no password field in the URL
curl -x socks4a://COLLAR@socks.cat:1337 https://example.com

With geo targeting:

curl -x socks5h://COLLAR-country-us-type-residential:PAWPRINT@socks.cat:1337 https://api.ipify.org

Browser (no extension)

Set a system/SOCKS proxy of socks.cat:1337. For Chromium:

chromium --proxy-server="socks5://socks.cat:1337"

Enter your collar:pawprint when prompted. For per-profile use, configure the proxy in the OS network settings.

Python (requests)

import requests

proxies = {
    "http":  "socks5h://COLLAR:PAWPRINT@socks.cat:1337",
    "https": "socks5h://COLLAR:PAWPRINT@socks.cat:1337",
}
print(requests.get("https://api.ipify.org", proxies=proxies, timeout=30).text)

Requires pip install requests[socks].

Node.js

import { HttpsProxyAgent } from "https-proxy-agent";

const agent = new HttpsProxyAgent(
  "http://COLLAR:PAWPRINT@socks.cat:1337"
);
const res = await fetch("https://api.ipify.org", { agent });
console.log(await res.text());

Protocol translation matrix

All sixteen inbound→upstream combinations are supported. The gateway terminates your inbound protocol, applies the configured upstream/chain, and translates as needed — including multi-hop chains for every inbound protocol.