Sign inSign up

thedockerimages/hsocks5

By thedockerimages

Updated over 6 years ago

Image
0

1.2K

thedockerimages/hsocks5 repository overview

HSocks5

GitHub Workflow Status CircleCI codecov Quality Gate Status Total alerts

Docker Cloud Build Status Docker Image Size (tag)

Provide HTTP Proxy based on Socks5 Proxy.

This project is the golang version of the tool http-proxy-to-socks, with much faster processing & less memory taking.

Why?

Most operation systems (like windows, android & iOS) only support HTTP Proxy without other tools, if users want to use a socks5 proxy, users must install some app on device, but sometimes there are some limitation on the devices. This project can transform socks5 proxy into http proxy, so that make all devices can connect with the socks5 proxy.

Setup with binary

Download pre-built binaries from here. (you should download the correct binary for your platform)

And run with

./hsocks5 --socks 192.168.3.88:10080 start

Setup with docker

Run this tool with docker

docker run --restart=always -d -p 18080:18080 -e SOCKS=192.168.3.88:10080 --name hsocks5 thedockerimages/hsocks5:latest

The 192.168.3.88:10080 is the socks5 server host and port.

The 18080 is the http proxy default port, you can use docker expose it as another port.

Options

./hsocks5 --help

NAME:
   HSocks5 - provide HTTP Proxy with Socks5

USAGE:
   hsocks5 [global options] command [command options] [arguments...]

VERSION:
   SNAPSHOT

COMMANDS:
   start    program entry
   help, h  Shows a list of commands or help for one command

GLOBAL OPTIONS:
   --addr value, -a value   HTTP proxy listen address (default: ":18080") [%ADDR%]
   --socks value, -s value  Socks5 service url, format: hostname:port, 192.168.1.1:18080 [%SOCKS%]
   --redis value, -r value  Redis cache for proxy check [%REDIS_SERVER%]
   --china-switchy          For mainland china user, 'hsocks' can automatic use 'socks5 proxy' ondemand [%CHINA_SWITCHY%]
   --help, -h               show help
   --version, -v            print the versio

Prometheus metric

HSocks5 exposes prometheus metric endpoint at /hsocks5/__/metric

CHANGELOG

Tag summary

Content type

Image

Digest

Size

10.6 MB

Last updated

over 6 years ago

docker pull thedockerimages/hsocks5