https://github.com/ocassio/go-socks5-proxy

A lightweight Go SOCKS5 proxy-server
https://github.com/ocassio/go-socks5-proxy

docker docker-image golang socks5-proxy socks5-server

Last synced: 5 months ago
JSON representation

A lightweight Go SOCKS5 proxy-server

• Host: GitHub
• URL: https://github.com/ocassio/go-socks5-proxy
• Owner: ocassio
• License: mit
• Created: 2018-04-12T19:51:39.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2018-04-14T12:37:22.000Z (over 7 years ago)
• Last Synced: 2025-05-21T12:18:14.417Z (8 months ago)
• Topics: docker, docker-image, golang, socks5-proxy, socks5-server
• Language: Go
• Homepage: https://hub.docker.com/r/ocassio/go-socks5-proxy/
• Size: 5.86 KB
• Stars: 21
• Watchers: 1
• Forks: 9
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          

[![Docker Pulls](https://img.shields.io/docker/pulls/ocassio/go-socks5-proxy.svg)](https://hub.docker.com/r/ocassio/go-socks5-proxy/)

# Docker image usage

You can start Docker container with the following command (make sure to replace `` and `` placeholders with your own credentials).

```bash

docker run -d --name socks5-proxy -p 1080:1080 -e USER= -e PASSWORD= ocassio/go-socks5-proxy

```

# Build

The following command will perform a build of a static binary for Linux.

The result of this build can be used by a scratch Docker image. This reduces container size drastically.

```bash

CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -o server .

```

# Special thanks

- The original idea. Actually, this project is just a very lightweight variation of the serj's one:

   https://github.com/serjs/socks5-server

- SOCKS5 server implementation for Go:

   https://github.com/armon/go-socks5

- Article about building minimal Go containers with Docker by Nick Gauthier:

   https://blog.codeship.com/building-minimal-docker-containers-for-go-applications/