Sox is a library for creating SOCKS5 clients and servers. Sox is a network proxy and can proxy connections like HTTP requests or ssh connections.
For more documentation on the specs, this implementation is based on please read documents at ./docs/specs.
For more documentation on the implementations of SOCKS, please read documents at ./docs/.
- SOCKS5
- addr type
- IPv4 connection
- IPv6 connection
- Domain connection
- Authentication
- unauthentication
- GSS connection
- username and password
- IANA unimplented in ssh
- command types
- connect
- bind
- udp associate
- reply / response
- reply server messages
- connection response server messages
- addr type
- SOCKS4
- SOCKS5 server
Add this to your application's shard.yml:
dependencies:
sox:
github: wontruefree/soxA SOCKS Client so to make a connection you have to have a corresponding SOCKS server. The easiest one to use is ssh.
To start up a local ssh SOCKS server you can connect to yourself.
# Setup SOCKS on localhost
ssh -D 1080 -C -N 127.0.0.1Have a local SOCKS server directing its connection to a remote host.
# Setup SOCKS connecting to remote host
ssh -D 1080 -C -N user@remote.comTo open a SOCKS connection and send a basic HTTP request and get a response.
require "sox"
socket = Sox.new(addr: "52.85.89.35")
request = HTTP::Request.new("GET", "/", HTTP::Headers{"Host" => "crystal-lang.org"})
request.to_io(socket)
socket.flush
response = HTTP::Client::Response.from_io(socket)
if response.success?
puts "Got to crystal through SOCKS5!!!"
endSox::Client functions almost like the Crystal (HTTP::Client)[https://crystal-lang.org/api/latest/HTTP/Client.html]
client = Sox::Client.new("www.example.com", host_addr: "127.0.0.1", host_port: 1080)
response = client.get("/")
puts response.status_code # => 200
puts response.body.lines.first # => "<!doctype html>"
client.closeSox::UDP functions almost like the Crystal (UDPSocket)[https://crystal-lang.org/api/latest/UDPSocket.html]
server = UDPSocket.new
server.bind "localhost", 9999
client = Sox::UDP.new(host_addr: "127.0.0.1", host_port: 1080)
client.connect "localhost", 9999
client.send "message"
message, client_addr = server.receive
message # => "message"
client_addr # => Socket::IPAddress(127.0.0.1:50516)
client.close
server.closeyou can use Sox::Client almost like the Crystal (HTTP::Client)[https://crystal-lang.org/api/latest/HTTP/Client.html]
client = Sox::Client.new("www.example.com", host_addr: "127.0.0.1", host_port: 1080)
response = client.get("/")
puts response.status_code # => 200
puts response.body.lines.first # => "<!doctype html>"
client.closeTo open a connection to a remote SOCKS5 Server.
require "sox"
socket = Sox.new(host_addr: "gateway.com", addr: "52.85.89.35")
request = HTTP::Request.new("GET", "/", HTTP::Headers{"Host" => "crystal-lang.org"})
request.to_io(socket)
socket.flush
response = HTTP::Client::Response.from_io?(socket)
if response.success?
puts "Got to crystal through SOCKS5!!!"
endSometimes you connect to web servers or remote SOCKS servers on ports that are not default. This is built into the top level interface no having to deal with requests or connection requests directly.
require "sox"
socket = Sox.new(host_addr: "gateway.com" host_port: 8010, addr: "52.85.89.35", port: 3000)
request = HTTP::Request.new("GET", "/", HTTP::Headers{"Host" => "crystal-lang.org"})
request.to_io(socket)
socket.flush
response = HTTP::Client::Response.from_io?(socket)
if response.success?
puts "Got to crystal through SOCKS5!!!"
endBefore running specs you should add your public key to the authorized keys. Please read below if you have not previously set up a socks server for testing. Although I like Unit Test Spec SOCKS only use tools in the stdlib so this is written in spec style syntax.
To run the test suite use the spec command built into crystal.
crystal specenable key based authentication for testing
# enable key based localhost authentication
cat ~/.ssh/id_rsa.pub > ~/.ssh/authorized_keysThere are some basic tests for a commonly used SOCKS5 server tor.
Install tor via apt.
sudo apt install torOptional: Start tor at login and keep tor running in the background.
systemctl start torUse homebrew to install tor on your mac.
brew install torOptional: Use brew services to keep tor running in the background.
brew services start tor