Skip to content

About

Free HTTP proxy that routes your traffic through hide.me servers. Works with sites blocked in Russia — YouTube, Instagram, Facebook, Twitter, Discord and more. No registration or payment required.

Resources

Stars

3 stars

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

Repository files navigation

hideme-proxy-cli

Русская версия

Free HTTP proxy that routes your traffic through hide.me servers. Works with sites blocked in Russia — YouTube, Instagram, Facebook, Twitter, Discord and more. No registration or payment required.

Building

make build          # build for current OS
make build-all      # build for all platforms
make clean          # remove binaries

Usage

./hideme-proxy-cli
# or with flags
./hideme-proxy-cli -bind-address 127.0.0.1:18080 -verbosity 2

Flags

Flag Default Description
-bind-address 127.0.0.1:18080 Local proxy listen address
-verbosity 20 Log level (10=debug, 20=info, 30=warning, 40=error)
-country NL Proxy country (NL, US, CH)
-timeout 10s Network operation timeout
-refresh 10m Server list refresh interval
-version - Show version and exit
-list-countries - Show available countries
-list-proxies - Show proxy server list

What works

The proxy works as an HTTP proxy with CONNECT tunnel support (HTTPS). Tests show accessibility of sites blocked in Russia:

Site Status
YouTube 200 OK
Instagram 200 OK
Facebook 200 OK
Twitter/X 200 OK
Discord 200 OK
Twitch 200 OK
Rutracker 301 Redirect (works)
Wikipedia 301 Redirect (works)
api.telegram.org 302 (API accessible)
web.telegram.org 200 OK

What doesn't work

Telegram Desktop (client)

Telegram Desktop does not connect through this proxy. Reasons:

  1. Telegram Desktop uses DC IPs directly (149.154.x.x, 91.108.x.x) instead of domains
  2. CONNECT tunnels to DC IPs through hide.me establish, but Telegram sends MTProto protocol after the tunnel, which hide.me does not understand
  3. The IP 155.133.216.53 (Russia DC) is blocked by hide.me — added to blacklist
  4. Telegram Desktop sends hundreds of requests per second, causing hide.me server rotation every 8-10 seconds

Telegram works via the web version (web.telegram.org) in a browser.

Setup

Windows — enable proxy

netsh winhttp set proxy proxy-server="127.0.0.1:18080"
reg add "HKCU\Software\Microsoft\Windows\CurrentVersion\Internet Settings" /v ProxyEnable /t REG_DWORD /d 1 /f
reg add "HKCU\Software\Microsoft\Windows\CurrentVersion\Internet Settings" /v ProxyServer /t REG_SZ /d "127.0.0.1:18080" /f

Windows — disable proxy

netsh winhttp reset proxy
reg add "HKCU\Software\Microsoft\Windows\CurrentVersion\Internet Settings" /v ProxyEnable /t REG_DWORD /d 0 /f
reg delete "HKCU\Software\Microsoft\Windows\CurrentVersion\Internet Settings" /v ProxyServer /f

Linux/macOS

export http_proxy=http://127.0.0.1:18080
export https_proxy=http://127.0.0.1:18080

Browser

FoxyProxy extension or browser proxy settings → HTTP proxy → 127.0.0.1:18080

Architecture

Client → [HTTP CONNECT] → hideme-proxy-cli → [SOCKS5] → hide.me server → Target

hide.me SOCKS5 servers are fetched from API 188.166.142.39/servers/list with TTL rotation. Servers with errors are automatically excluded (backpressure + blacklist).

License

MIT

About

Free HTTP proxy that routes your traffic through hide.me servers. Works with sites blocked in Russia — YouTube, Instagram, Facebook, Twitter, Discord and more. No registration or payment required.

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages