https://github.com/astro/socksify-ruby

Redirect any TCP connection initiated by a Ruby script through a SOCKS5 proxy
https://github.com/astro/socksify-ruby

Keywords

ruby rubygem socks socks5

Keywords from Contributors

activerecord ruby-gem feature-flag

Last synced: about 22 hours ago
JSON representation

Repository metadata

Redirect any TCP connection initiated by a Ruby script through a SOCKS5 proxy

Host: GitHub
URL: https://github.com/astro/socksify-ruby
Owner: astro
License: other
Created: 2009-03-19T15:48:55.000Z (almost 17 years ago)
Default Branch: master
Last Pushed: 2025-07-20T12:51:43.000Z (8 months ago)
Last Synced: 2026-02-26T23:59:02.281Z (5 days ago)
Topics: ruby, rubygem, socks, socks5
Language: Ruby
Homepage: http://astro.github.io/socksify-ruby/
Size: 142 KB
Stars: 170
Watchers: 7
Forks: 80
Open Issues: 7
Releases: 3
Metadata Files:
- Readme: README.md
- Changelog: ChangeLog
- License: COPYING

SOCKSify Ruby

What is it?

SOCKSify Ruby redirects any TCP connection initiated by a Ruby script through a SOCKS5 proxy. It serves as a small drop-in alternative to tsocks, except that it handles Ruby programs only and doesn't leak DNS queries.

How does it work?

require 'socksify/http'

This adds a new class method Net::HTTP.socks_proxy which takes the host and port address of a socks proxy. Once set, all requests will be routed via socks. This is acheived by patching a private method in Net::HTTP, as sadly Ruby no longer has native socks proxy support out of the box.

Additionally, Socksify.resolve can be used to resolve hostnames to IPv4 addresses via SOCKS.

Installation

$ gem install socksify

Usage

Redirect all TCP connections of a Ruby program

Run a Ruby script with redirected TCP through a local Tor anonymizer:

$ socksify_ruby localhost 9050 script.rb

Explicit SOCKS usage in a Ruby program (Deprecated in Ruby 3.1 onwards)

Set up SOCKS connections for a local Tor anonymizer, TCPSockets can be used as usual:

require 'socksify'

TCPSocket.socks_server = "127.0.0.1"
TCPSocket.socks_port = 9050
rubyforge_www = TCPSocket.new("rubyforge.org", 80)
# => #<TCPSocket:0x...>

Use Net::HTTP explicitly via SOCKS

Require the additional library socksify/http and use the Net::HTTP.socks_proxy method. It is similar to Net::HTTP.Proxy from the Ruby standard library:

require 'socksify/http'

uri = URI.parse('http://ipecho.net/plain')
Net::HTTP.socks_proxy('127.0.0.1', 9050).start(uri.host, uri.port) do |http|
  req = Net::HTTP::Get.new uri
  resp = http.request(req)
  puts resp.inspect
  puts resp.body
end
# => #<Net::HTTPOK 200 OK readbody=true>
# => <A tor exit node ip address>

Note that Net::HTTP.socks_proxy never relies on TCPSocket.socks_server/socks_port. You should either set socks_proxy arguments explicitly or use Net::HTTP directly.

Authentication

require 'socksify/http'

uri = URI.parse('http://ipecho.net/plain')
Net::HTTP.socks_proxy('127.0.0.1', 1080, username: 'my_username', password: 'my_pwd').start(uri.host, uri.port) do |http|
  req = Net::HTTP::Get.new uri
  resp = http.request(req)
  puts resp.inspect
  puts resp.body
end

Resolve addresses via SOCKS

Socksify.resolve("spaceboyz.net")
# => "87.106.131.203"

Testing and Debugging

A tor proxy and socks5 proxy with auth is required before running the tests.

Install tor from your usual package manager, check it is running with pidof tor
Start a SOCKS5 proxy using Docker docker run -d --name socks5 -p 1080:1080 -e PROXY_USER=user -e PROXY_PASSWORD=password serjs/go-socks5-proxy

Then run the tests with:
bundle exec rake

Colorful diagnostic messages are enabled by default via:

Socksify::debug = true`

Development

The repository can be checked out with:

$ git-clone git@github.com:astro/socksify-ruby.git

Send patches via pull requests.

Further ideas

Resolv replacement code, so that programs which resolve by themselves don't leak DNS queries
IPv6 address support
UDP as soon as Tor supports it
Perhaps using standard exceptions for better compatibility when acting as a drop-in?

Author

Stephan Maka

License

SOCKSify Ruby is distributed under the terms of the GNU General Public License version 3 (see file COPYING) or the Ruby License (see file LICENSE) at your option.

Owner metadata

Name: Astro
Login: astro
Email:
Kind: user
Description: Rust, Nix, Haskell, Erlang, XSLT, Prolog, JavaScript, C – roughly in that order
Website: https://spaceboyz.net/~astro/
Location: Dresden
Twitter:
Company: @cyberus-technology
Icon url: https://avatars.githubusercontent.com/u/12923?u=c38f4303aa9461c4a7096d3a8b7184ca240f58cb&v=4
Repositories: 245
Last ynced at: 2024-04-14T19:02:03.384Z
Profile URL: https://github.com/astro

GitHub Events

Total

Release event: 2
Pull request event: 11
Fork event: 3
Issues event: 3
Watch event: 6
Issue comment event: 9
Push event: 7
Create event: 2

Last Year

Release event: 2
Pull request event: 6
Fork event: 1
Issues event: 3
Watch event: 3
Issue comment event: 5
Push event: 5
Create event: 2

Committers metadata

Last synced: 1 day ago

Total Commits: 110
Total Committers: 19
Avg Commits per committer: 5.789
Development Distribution Score (DDS): 0.6

Commits in past year: 9
Committers in past year: 4
Avg Commits per committer in past year: 2.25
Development Distribution Score (DDS) in past year: 0.667

Name	Email	Commits
Astro	a**o@s**t	44
Musy Bite	m**e@g**m	20
MatzFan	b**n@g**m	16
MatzFan	m**n@m**m	7
Andrey Kouznetsov	s**k@g**m	3
David Dollar	d**r@g**m	3
liz johnson	l**8@g**m	3
Anton Smagin	s**n@g**m	2
Yuichi Tateno	h**h@g**m	2
Andrew Nesbitt	a**z@g**m	1
Bachue Zhou	b**u@g**m	1
Bobby Lawrence	d**7@g**m	1
Christopher Thorpe	c**t@e**u	1
Florin Asavoaie	f**e@g**m	1
Michael Xavier	m**l@m**t	1
Naoyoshi Aikawa	n**1@g**m	1
Erik Gustavson	e**k@b**m	1
Yilin Chen	s**f@g**m	1
codener	d**r@m**e	1

Committer domains:

Issue and Pull Request metadata

Last synced: 6 months ago

Total issues: 23
Total pull requests: 45
Average time to close issues: almost 2 years
Average time to close pull requests: 9 months
Total issue authors: 23
Total pull request authors: 23
Average comments per issue: 3.3
Average comments per pull request: 1.47
Merged pull request: 30
Bot issues: 0
Bot pull requests: 0

Past year issues: 1
Past year pull requests: 10
Past year average time to close issues: 1 day
Past year average time to close pull requests: about 12 hours
Past year issue authors: 1
Past year pull request authors: 4
Past year average comments per issue: 1.0
Past year average comments per pull request: 0.4
Past year merged pull request: 6
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/astro/socksify-ruby

Top Issue Authors

dlahn (1)
ecnalyr (1)
pirj (1)
joeldrapper (1)
fokx (1)
rusch (1)
patrickhno (1)
joshweir (1)
ruehsn (1)
MatzFan (1)
cozmogeek (1)
peck (1)
karis10 (1)
da2x (1)
erwin (1)

Top Pull Request Authors

MatzFan (11)
musybite (4)
ddollar (3)
onsails (3)
anton-smagin (3)
lizzypy (2)
ojab (2)
andrew (2)
paccator (2)
pavelkvasnikov (1)
artamonovdev (1)
awakia (1)
dblommesteijn (1)
goosetav (1)
olleolleolle (1)

Top Issue Labels

Top Pull Request Labels

Package metadata

Total packages: 11
Total downloads:
- rubygems: 148,897,308 total
Total docker downloads: 16,453,496
Total dependent packages: 40 (may contain duplicates)
Total dependent repositories: 627 (may contain duplicates)
Total versions: 39
Total maintainers: 2

gem.coop: socksify

Redirect all TCPSockets through a SOCKS5 proxy

Homepage: https://github.com/astro/socksify-ruby
Documentation: http://www.rubydoc.info/gems/socksify/
Licenses: Ruby,GPL-3.0-only
Latest release: 1.8.1 (published 8 months ago)
Last Synced: 2026-03-02T05:31:59.762Z (1 day ago)
Versions: 15
Dependent Packages: 0
Dependent Repositories: 0
Downloads: 74,451,703 Total
Docker Downloads: 8,226,748
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 0.374%
- Downloads: 0.389%
- Docker downloads count: 1.108%
Maintainers (2)
- astro
- 44915
Funding:
- https://github.com/sponsors/astro

rubygems.org: socksify