README ¶
Cover Socks
Download Installer
- download installer from [https://github.com/coversocks/golang/releases]
Install Server(Linux)
- install service
unzip ~/coversocks-xxxx-Linux.zip
cd ~/coversocks
./coversocks-install.sh -i
- edit configure on
/home/cs/conf/coversocks.json
, see configure section for detail - add port
5200
(default) to firewalld - restart service
systemctl restart coversocks
systemctl status coversocks
Install Server(Windows)
- uncompress the
coversocks-xxxx-Windows-xx.zip
- double click
cert.bat
to createcscert.crt/cscert.key
,openssl
command is required - edit configure on
default-server.json
, see configure section for detail - right click
coversocks-install.bat
and run as administrator - add dartksocks.exe to firewall
Add User
- open browser and goto
https://x.x.x.x:5200/manager/
- input username/password, then click add
Start Client
- edit configure on
default-client.json
, change adderss/username/password - start proxy by
./run.sh
on linux/osx,run.bat
on windows - test proxy by
export http_proxy=http://127.0.0.1:1103
export https_proxy=http://127.0.0.1:1103
export socks_proxy=socks5://127.0.0.1:1105
curl https://www.google.com
Configure(Server)
{
"http_listen_addr": "",
"https_listen_addr": ":5200",
"https_cert": "cscert.crt",
"https_key": "cscert.key",
"manager": {
"test": "40bd001563085fc35165329ea1ff5c5ecbdbbeef"
},
"user_file": "dsuser.json"
}
http_listen_addr
the http listen address, it alway is used when run coversocks behind reverse proxy server like nginx/httpdhttps_listen_addr
the https listen address, it can be connected direct by coversocks clienthttps_cert
the https certhttps_key
the https cert keymanager
the manager user list, the key is username, the value is password which is encrypted by sha1, create it byecho -n xxxx | sha1sum
user_file
the access user list by json key/value, the key is username, the value is password which is encrypted by sha1, create it byecho -n xxxx | sha1sum
Configure(Client)
{
"servers": [
{
"enable": true,
"name": "test1",
"address": [
"wss://127.0.0.1:5200/ds?skip_verify=1"
],
"username": "test",
"password": "123"
}
],
"socks_addr": "0.0.0.0:1105",
"http_addr": "0.0.0.0:1103",
"manager_addr": "0.0.0.0:1101",
"mode": "auto"
}
servers.enable
whether server is enabledservers.name
the server name, it can be any what you wantservers.address
the server websocks address,servers.username
the username to server,servers.password
the password to login server,socks_addr
the socks5 proxy server listen addresshttp_addr
the http/https proxy server listen addressmanager_addr
the auto proxy url listen address (pac)mode
the proxy mode which can bemanual/auto/global
Compile Binary
- for osx and linux
#get source code
go get github.com/coversocks/golang/csocks
#package binary
cd $GOPATH/src/github.com/coversocks/golang
./pkg.sh
- for windows
go get github.com/coversocks/golang/csocks
cd $GOPATH\src\github.com\coversocks\golang
pkg 386
pkg amd64
Click to show internal directories.
Click to hide internal directories.