Skip to content


Folders and files

Last commit message
Last commit date

Latest commit



16 Commits

Repository files navigation

Docker SOCKS Tunnel Pull from GitHub Container Registry Pull from Docker Hub Docker Image Size Build Status

Part of HTTP Toolkit: powerful tools for building, testing & debugging HTTP(S)

This is a minimal Docker container for MicroSocks, a multithreaded, small, efficient SOCKS5 server.

This is intended to be used internally by HTTP Toolkit, to tunnel traffic into Docker networks, especially in environments (Windows & Mac) where host to container connectivity is not usually available.

The container itself uses Microsocks to provide a small & lightweight SOCKS5 proxy, and is designed to be as small as reasonably possible on top of that base: currently 1.8MB on disk, or <1MB when compressed for download.

To run this:

docker run -d --name=httptoolkit-docker-tunnel -p

(Available from both Docker Hub and the GitHub Container Registry)

This will connect port 1080 on the host to the SOCKS5 proxy in the container. Traffic can be proxied through this port to reach any container on the same network as the tunnel container.

SOCKS5H must be used, resolving domain names within the tunnel, not beforehand, unless you have a DNS configuration that can resolve Docker container names externally.

This repo is a fork of the now-archived & officially abandoned docker-microsocks repo, modified & distributed under the MIT license.