# armon/go-socks5

SOCKS5 server in Golang

Repository: https://github.com/armon/go-socks5
Canonical: https://ross.abutalabs.com/products/go-socks5
Language: Go
License: MIT
License Family: permissive
Last push: 2024-06-14T23:51:57+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 4606, "days_push": 810, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2124, forks 550 (observed 2026-08-28T04:06:16.792240+00:00)

## What it is
A Go library that implements a SOCKS5 proxy server, supporting No-Auth and User/Password authentication and the CONNECT command. It offers granular command filtering rules and custom DNS resolution, and can be embedded into Go applications.

## Use cases
- run a socks5 proxy server in go
- embed a socks5 proxy into my application
- proxy traffic through an intermediate server to bypass firewalls or NAT
- add username/password authentication to a socks5 proxy
- filter which commands clients can use through the proxy
- customize dns resolution for proxied connections

## When to choose
- you need a programmable SOCKS5 server embedded in a Go application
- you need CONNECT support with No-Auth or User/Password auth
- you want granular rules to filter proxy commands or custom DNS resolution

## When to avoid
- you need BIND or UDP ASSOCIATE commands, which are not implemented
- you want a standalone ready-to-run proxy binary rather than a library
- you need SOCKS4 support

## Facets
- artifact type: library
- maturity: maintenance
- function: networking, proxy, http-server, auth, security
- domain: networking, security, privacy, developer-tools, backend
- platform: go, cross-platform, windows
- tags: socks5, proxy-server, golang-library, firewall-bypass, nat-traversal, linux, macos

## Member repositories
- armon/go-socks5 (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:16.792240+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:52:47.763778+00:00, confidence not recorded.
  - readme: https://github.com/armon/go-socks5 (fetched 2026-08-28T04:06:16.792240+00:00, sha 6a0241a41219)
- Data as of 2026-08-30T08:39:29.467469+00:00.