Baike.dev
All toolsOnline toolsAI codingTrendingOpen sourceNewsSubmit
Log in
< Back to tools
S

socks5-server

> 编程语言
Open source

go-socks5-proxy Simple socks5 server using go-socks5 with authentication, allowed ips list and destination FQDNs filtering Examples - Run d…

1.1K stars0 likes1 views
WebsiteGitHub

About

go-socks5-proxy Simple socks5 server using go-socks5 with authentication, allowed ips list and destination FQDNs filtering Examples - Run d…

go-socks5-proxy

Simple socks5 server using go-socks5 with authentication, allowed ips list and destination FQDNs filtering

Examples

  • Run docker container using default container port 1080 and expose it to world using host port 1080, with auth creds

    docker run -d --name socks5 -p 1080:1080 -e PROXY_USER= -e PROXY_PASSWORD= serjs/go-socks5-proxy

  • Run docker container using specific container port and expose it to host port 1090

    docker run -d --name socks5 -p 1090:9090 -e PROXY_USER= -e PROXY_PASSWORD= -e PROXY_PORT=9090 serjs/go-socks5-proxy

List of supported config parameters

ENV variable Type Default Description
REQUIRE_AUTH String true Allow accepting socks5 connections without auth creds. Not recommended untill you use other protections mechanisms like Whitelists Subnets using Firewall or Proxy itself
PROXY_USER String EMPTY Set proxy user (also required existed PROXY_PASS)
PROXY_PASSWORD String EMPTY Set proxy password for auth, used with PROXY_USER
PROXY_PORT String 1080 Set listen port for application inside docker container
ALLOWED_DEST_FQDN String EMPTY Allowed destination address regular expression pattern. Default allows all.
ALLOWED_IPS String Empty Set allowed IP's that can connect to proxy, separator ,

Build your own image:

docker-compose -f docker-compose.build.yml up -d
Just don't forget to set parameters in the .env file (cp .env.example .env) and edit it with your config parameters

Test running service

Assuming that you are using container on 1080 host docker port

Without authentication

curl --socks5 :1080 https://ipinfo.io - result must show docker host ip (for bridged network)

or

docker run --rm curlimages/curl:7.65.3 -s --socks5 :1080 https://ipinfo.io

With authentication

curl --socks5 :1080 -U : https://ipinfo.io

or

docker run --rm curlimages/curl:7.65.3 -s --socks5 :@:1080 https://ipinfo.io

Authors

  • Sergey Bogayrets

See also the list of contributors who participated in this project.

Issues· 0 open

View all issuesOpen on GitHub

No open issues yet, or sync has not completed.

> Tags

Go

No comments yet. Be the first to share.

> Details

PublishedAug 1, 2026
UpdatedSep 17, 2026
Category编程语言
PricingOpen source

> Related tools

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言