From 28c9830f561c0a85f4a12b84936d624319587110 Mon Sep 17 00:00:00 2001 From: user Date: Tue, 17 Feb 2026 22:06:40 +0100 Subject: [PATCH] docs: reorder listeners -- deepest chain on default port :1080 = Tor + 2 pool hops, :1081 = Tor + 1, :1082 = Tor only. --- README.md | 14 +++++++------- config/example.yaml | 8 ++++---- docs/CHEATSHEET.md | 8 ++++---- docs/USAGE.md | 12 +++++++----- 4 files changed, 22 insertions(+), 20 deletions(-) diff --git a/README.md b/README.md index 094526b..ff989dc 100644 --- a/README.md +++ b/README.md @@ -77,16 +77,16 @@ api_listen: 127.0.0.1:1081 # control API (disabled by default) listeners: - listen: 0.0.0.0:1080 chain: - - socks5://127.0.0.1:9050 # Tor only + - socks5://127.0.0.1:9050 + - pool # Tor + 2 pool proxies + - pool - listen: 0.0.0.0:1081 chain: - socks5://127.0.0.1:9050 - pool # Tor + 1 pool proxy - listen: 0.0.0.0:1082 chain: - - socks5://127.0.0.1:9050 - - pool # Tor + 2 pool proxies - - pool + - socks5://127.0.0.1:9050 # Tor only # Old single-listener format still works: # listen: 127.0.0.1:1080 @@ -134,9 +134,9 @@ Options: ## How Chaining Works ``` -:1080 Client -> s5p -> Tor -> Destination (0 pool hops) -:1081 Client -> s5p -> Tor -> [pool proxy] -> Destination (1 pool hop) -:1082 Client -> s5p -> Tor -> [pool proxy] -> [pool proxy] -> Dest (2 pool hops) +:1080 Client -> s5p -> Tor -> [pool] -> [pool] -> Destination (2 pool hops) +:1081 Client -> s5p -> Tor -> [pool] -> Destination (1 pool hop) +:1082 Client -> s5p -> Tor -> Destination (0 pool hops) ``` s5p connects to Hop1 via TCP, negotiates the hop protocol (SOCKS5/4/HTTP), diff --git a/config/example.yaml b/config/example.yaml index 47caab4..906f547 100644 --- a/config/example.yaml +++ b/config/example.yaml @@ -57,7 +57,9 @@ chain: # listeners: # - listen: 0.0.0.0:1080 # chain: -# - socks5://127.0.0.1:9050 # Tor only (no pool hops) +# - socks5://127.0.0.1:9050 +# - pool # Tor + 2 random pool proxies +# - pool # # - listen: 0.0.0.0:1081 # chain: @@ -66,9 +68,7 @@ chain: # # - listen: 0.0.0.0:1082 # chain: -# - socks5://127.0.0.1:9050 -# - pool # Tor + 2 random pool proxies -# - pool +# - socks5://127.0.0.1:9050 # Tor only (no pool hops) # # When using "listeners:", the top-level "listen" and "chain" keys are ignored. # If "listeners:" is absent, the old format is used (single listener). diff --git a/docs/CHEATSHEET.md b/docs/CHEATSHEET.md index 335facd..727226b 100644 --- a/docs/CHEATSHEET.md +++ b/docs/CHEATSHEET.md @@ -44,16 +44,16 @@ cp config/example.yaml config/s5p.yaml # create live config (gitignored) listeners: - listen: 0.0.0.0:1080 chain: - - socks5://127.0.0.1:9050 # Tor only + - socks5://127.0.0.1:9050 + - pool # Tor + 2 pool hops + - pool - listen: 0.0.0.0:1081 chain: - socks5://127.0.0.1:9050 - pool # Tor + 1 pool hop - listen: 0.0.0.0:1082 chain: - - socks5://127.0.0.1:9050 - - pool # Tor + 2 pool hops - - pool + - socks5://127.0.0.1:9050 # Tor only ``` ## Performance Tuning (config) diff --git a/docs/USAGE.md b/docs/USAGE.md index 8132e5e..77c7dea 100644 --- a/docs/USAGE.md +++ b/docs/USAGE.md @@ -51,7 +51,9 @@ api_listen: "" # control API bind address (empty = disabled) listeners: - listen: 0.0.0.0:1080 chain: - - socks5://127.0.0.1:9050 # Tor only + - socks5://127.0.0.1:9050 + - pool # Tor + 2 pool proxies + - pool - listen: 0.0.0.0:1081 chain: - socks5://127.0.0.1:9050 @@ -89,7 +91,9 @@ of proxy hops after the static chain. Config-file only (not available via CLI). listeners: - listen: 0.0.0.0:1080 chain: - - socks5://10.200.1.13:9050 # Tor only + - socks5://10.200.1.13:9050 + - pool # Tor + 2 pool proxies + - pool - listen: 0.0.0.0:1081 chain: @@ -98,9 +102,7 @@ listeners: - listen: 0.0.0.0:1082 chain: - - socks5://10.200.1.13:9050 - - pool # Tor + 2 pool proxies - - pool + - socks5://10.200.1.13:9050 # Tor only proxy_pool: sources: