elephant-socks5-client-py

python client of Elephant(L4) tunnel for SOCKS5 empowered by py-netty.

Elephant Server should be deployed first, which is a L4 tunnel server designed to provide a secure and high-performance tunneling solution for TCP traffic.

Installation

pip install elephant-socks5 -U

Usage

$ elephant -h
Usage: elephant [OPTIONS]

Options:
  -p, --port INTEGER             Local port to bind  [default: 1080]
  -g, --global                   Listen on all interfaces
  -s, --server TEXT              Elephant tunnel server URLs (like: ws[s]://localhost:4443/elephant/ws)  [required]
  -a, --alias TEXT               Alias for the client
  -q, --quiet                    Quiet mode
  -esp, --enable-shell-proxy     Enable Shell proxy
  -erp, --enable-reverse-proxy   Enable reverse proxy
  -rpo, --reverse-proxy-only     No SOCKS5 server, only for reverse proxy
  --reverse-ip TEXT              Reverse proxy IP
  --reverse-port INTEGER         Reverse proxy port  [default: -1]
  --no-reverse-global            Reverse proxy listen on localhost
  -l, --log-record               Save log to file (elephant-client.log)
  -t, --request-timeout INTEGER  Session request timeout (seconds)  [default: 3]
  --no-color                     Disable color output
  -v, --verbose                  Verbose mode
  -n, --tunnels INTEGER RANGE    Number of tunnels to achieve load balance  [default: 1; x>=1]
  --proxy-ip TEXT                Proxy IP
  --proxy-port INTEGER           Proxy port  [default: -1]
  --version                      Show the version and exit.
  -h, --help                     Show this message and exit.

User Cases

forwoard proxy reverse proxy shell proxy socks5 proxy

Release files for elephant-socks5 0.0.30

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for elephant-socks5 0.0.30
File	Size	Uploaded
elephant-socks5-0.0.30.tar.gz	15.3 kB	Apr 3, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for elephant-socks5 0.0.30
File	Interpreter	ABI	Platform	Reset
elephant_socks5-0.0.30-py3-none-any.whl 16.2 kB Apr 3, 2025	Python 3	none	any	Details

Total release size: 31.5 kB

Release files / elephant-socks5-0.0.30.tar.gz

Download URL	elephant-socks5-0.0.30.tar.gz
Size	15.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`9ebd95f6c41f4c053a4680f2e1eb713f0122db96bd56e7e63c7cbd4b01926094`
BLAKE2b-256 checksum How to use checksums	`2c38ab03357cd6641727124f684fb2ffe28f506c1f70c8792ac99646ad532028`
Upload date	Apr 3, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.10.13`

Release files / elephant_socks5-0.0.30-py3-none-any.whl

Download URL	elephant_socks5-0.0.30-py3-none-any.whl
Size	16.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`8872472c4c4b4f4ae10a23e15f4c3faf48c4b848f15cf5a201990b2ffcb5c571`
BLAKE2b-256 checksum How to use checksums	`b92e1fd4c5bed8aa9cee61239b0dc803c67f9d408dd0947ab439bd3058b011ba`
Upload date	Apr 3, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.10.13`