Docker image with 3proxy

3proxy is a powerful and lightweight proxy server. This image includes the stable version and can be easily configured using environment variables. By default, it operates with anonymous proxy settings to hide client information and logs activity in JSON format.

Page on hub.docker.com can be found here.

TCP ports:

Port number	Description
3128	HTTP proxy
1080	SOCKS proxy

Supported tags

Registry	Image
GitHub Container Registry	ghcr.io/tarampampam/3proxy
Docker Hub (mirror)	tarampampam/3proxy

Note

It’s recommended to avoid using the latest tag, as major upgrades may include breaking changes. Instead, use specific tags in X.Y.Z format for version consistency.

All supported image tags can be found here.

Starting with version 1.8.2, the arm64 architecture is supported (in addition to amd64):

docker run --rm mplatform/mquery ghcr.io/tarampampam/3proxy:1.8.2

Image: ghcr.io/tarampampam/3proxy:1.8.2
 * Manifest List: Yes (Image type: application/vnd.docker.distribution.manifest.list.v2+json)
 * Supported platforms:
   - linux/amd64
   - linux/arm64

Supported Environment Variables

Variable Name	Description	Example
PROXY_LOGIN	Authorization login (empty by default)	username
PROXY_PASSWORD	Authorization password (empty by default)	password
EXTRA_ACCOUNTS	Additional proxy users (JSON object format)	{"evil":"live", "guest":"pass"}
PRIMARY_RESOLVER	Primary DNS resolver (1.0.0.1 by default)	8.8.8.8:5353/tcp
SECONDARY_RESOLVER	Secondary DNS resolver (8.8.4.4 by default)	2001:4860:4860::8844
MAX_CONNECTIONS	Maximum number of connections (1024 by default)	2056
PROXY_PORT	HTTP proxy port (3128 by default)	8080
SOCKS_PORT	SOCKS proxy port (1080 by default)	8888
EXTRA_CONFIG	Additional 3proxy configuration (appended to the end of the config file, but before proxy and flush)	# line 1\n# line 2
LOG_OUTPUT	Path for log output (/dev/stdout by default; set to /dev/null to disable logging)	/tmp/3proxy.log

How to Use This Image

Example usage:

docker run --rm -d \
  -p "3128:3128/tcp" \
  -p "1080:1080/tcp" \
  ghcr.io/tarampampam/3proxy:latest

With authentication and custom resolver settings:

docker run --rm -d \
  -p "3128:3128/tcp" \
  -p "1080:1080/tcp" \
  -e "PROXY_LOGIN=evil" \
  -e "PROXY_PASSWORD=live" \
  -e "PRIMARY_RESOLVER=2001:4860:4860::8888" \
  ghcr.io/tarampampam/3proxy:latest

Docker compose example:

services:
  3proxy:
    image: ghcr.io/tarampampam/3proxy:latest
    environment:
      PROXY_LOGIN: evil
      PROXY_PASSWORD: live
      MAX_CONNECTIONS: 10000
      PROXY_PORT: 8000
      SOCKS_PORT: 8001
      PRIMARY_RESOLVER: 77.88.8.8
      SECONDARY_RESOLVER: 8.8.8.8
    ports:
      - '8000:8000/tcp'
      - '8001:8001/tcp'

Releasing

Publishing a new version is straightforward:

1. Make the necessary changes in this repository.
2. "Publish" a new release on the repository's releases page.

Docker images will be automatically built and published.

Note: The latest tag will be overwritten in both registries when a new release is published.

Support

If you encounter any issues, please open an issue in this repository.

License

This project is licensed under the WTFPL. Use it freely and enjoy!