dblokhin/proxyme repository overview

⁠Proxyme - Lightweight and Simple SOCKS5 Proxy

Proxyme is an efficient and lightweight SOCKS5 Proxy server designed for easy deployment in Docker containers. It supports key features like CONNECT, BIND, and AUTH with both authenticated (username/password) and unauthenticated access, making it ideal for quick setup and secure proxying.

This image is perfect for users looking for a lightweight SOCKS5 proxy solution that is easy to configure.

⁠Getting Started

⁠Environment Variables

The project supports the following environment variables to configure the proxy server:

• PROXY_HOST: The host IP or hostname the proxy will listen on. (Default: 0.0.0.0)
• PROXY_PORT: The port number the proxy will listen on. (Default: 1080)
• PROXY_BIND_IP: The IP address to use for BIND operations in the SOCKS5 protocol. This should be a public IP address that can accept incoming connections. (Default: disabled)
• PROXY_NOAUTH: If set to yes, true, or 1, allows unauthenticated access to the proxy. (Default: disabled)
• PROXY_USERS: A comma-separated list of username and password pairs for authentication (in the format user:pass,user2:pass2). If this is set, the proxy enables SOCKS5 username/password authentication.

At least one SOCKS5 auth method (noauth or username/password) must be specified.

⁠Docker Usage

Anonymous access:

docker run -d \
 -e PROXY_HOST=0.0.0.0 \
 -e PROXY_PORT=1080 \
 -e PROXY_NOAUTH=yes \
 -p 1080:1080 \
 dblokhin/proxyme

curl --socks5 localhost:1080 https://google.com

Username/password access:

docker run -d \
 -e PROXY_HOST=0.0.0.0 \
 -e PROXY_PORT=1080 \
 -e PROXY_USERS="user1:pass1,user2:pass2" \
 -p 1080:1080 \
 dblokhin/proxyme

curl --socks5 localhost:1080 -U user1:pass1 https://google.com

⁠Contributing

We welcome contributions to improve Proxyme! Feel free to open an issue or submit a pull request on GitHub⁠.

This project is intended for both learning and production use, providing a simple and reliable proxy server for your Docker-based infrastructure.