Add changelog and readme files

This commit is contained in:
Sergey Bogatyrets 2018-04-24 21:00:14 +03:00
parent e321695d0c
commit 803767b6f7
2 changed files with 34 additions and 5 deletions

15
Changelog.md Normal file
View File

@ -0,0 +1,15 @@
# Changelog
All notable changes to this project will be documented in this file.
## [Unreleased]
## [v0.0.1] - 2018-04-24
### Added
- Optional auth
### Changed
- Golang vendoring
- Change Dockerfile for multistage builds with final scratch image
### Removed
- IDE files

View File

@ -2,10 +2,24 @@
Simple socks5 server using go-socks5 with or without auth.
# Start container with proxy
```docker run -d --name socks5 -p 1080:1080 -e PROXY_USER=<PROXY_USER> -e PROXY_PASSWORD=<PROXY_PASSWORD> olebedev/socks5```
## Start container with proxy
For auth-less mode just do not pass `PROXY_USER` and `PROXY_PASSWORD`.
```docker run -d --name socks5 -p 1080:1080 -e PROXY_USER=<PROXY_USER> -e PROXY_PASSWORD=<PROXY_PASSWORD> serjs/go-socks5-proxy```
# Test running service
```curl --socks5 <docker machine ip>:1080 https://ya.ru``` - result must show docker host ip (for bridged network)
For auth-less mode just do not pass envrionment variables `PROXY_USER` and `PROXY_PASSWORD`.
## Test running service
Without auth
```curl --socks5 <docker host ip>:1080 http://ifcfg.co``` - result must show docker host ip (for bridged network)
With auth
```curl --socks5 --user <PROXY_USER:<PROXY_PASSWORD> <docker host ip>:1080 http://ifcfg.co``` - result must show docker host ip (for bridged network)
## Authors
* **Sergey Bogayrets**
See also the list of [contributors](https://github.com/serjs/socks5-server/graphs/contributors) who participated in this project.