SOCKS5 Proxy

Lightweight, secure, and configurable SOCKS5 proxy server written in Go

---

🧭 Overview

This project provides a production-ready SOCKS5 proxy server with support for authentication, access control, and UDP forwarding. Built with Go and optimized for container deployment.

---

🚀 Features

• SOCKS5 CONNECT command
• SOCKS5 UDP ASSOCIATE command
• IPv4, IPv6, and FQDN support
• Username/Password Authentication (RFC 1929)
• IP Whitelisting (ACL)
• Environment-based configuration
• Docker & Docker Compose ready

---

Proxy SOCKS5 Docker Container

This Docker image allows you to quickly run a SOCKS5 Proxy server.

---

Quick Start

Run the following command to start the socks5 container in detached mode. It will always restart automatically if it stops:

docker run -d \
  --name socks5 \
  --restart=always \
  --dns=1.1.1.1 \
  --dns=8.8.8.8 \
  -p 1080:1080 \
  -e SOCKS5_USER=imzami \
  -e SOCKS5_PASSWORD=11221099 \
  imzami/socks5

---

Username: imzami Password: 11221099 Please customise your own.

Requirements

• Docker must be installed on the host machine.

---

Stopping and Removing the Container

To stop the container:

docker stop socks5

To restart the container:

docker restart socks5

To remove the container:

docker rm socks5