https://github.com/net-ssh/net-ssh-gateway

A gateway class for tunneling connections via SSH over a forwarded port
https://github.com/net-ssh/net-ssh-gateway

Last synced: about 7 hours ago
JSON representation

Repository metadata

A gateway class for tunneling connections via SSH over a forwarded port

Host: GitHub
URL: https://github.com/net-ssh/net-ssh-gateway
Owner: net-ssh
License: mit
Fork: true (jamis/net-ssh-gateway)
Created: 2011-01-14T22:35:08.000Z (about 15 years ago)
Default Branch: master
Last Pushed: 2022-06-23T23:36:49.000Z (over 3 years ago)
Last Synced: 2026-02-28T11:50:52.629Z (3 days ago)
Language: Ruby
Homepage: http://net-ssh.rubyforge.org/gateway/v1/api/
Size: 89.8 KB
Stars: 65
Watchers: 4
Forks: 20
Open Issues: 4
Releases: 0
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.txt
- License: LICENSE.txt

Net::SSH::Gateway

Please note: this project is in maintenance mode. It is not under active development but pull requests are very much welcome. Just be sure to include tests!

Docs: http://net-ssh.github.com/net-ssh-gateway
Issues: https://github.com/net-ssh/net-ssh-gateway/issues
Codes: https://github.com/net-ssh/net-ssh-gateway
Email: net-ssh@solutious.com

As of v1.1.1, all gem releases are signed. See INSTALL.

DESCRIPTION:

Net::SSH::Gateway is a library for programmatically tunnelling connections to servers via a single "gateway" host. It is useful for establishing Net::SSH connections to servers behind firewalls, but can also be used to forward ports and establish connections of other types, like HTTP, to servers with restricted access.

FEATURES:

Easily manage forwarded ports
Establish Net::SSH connections through firewalls

SYNOPSIS:

In a nutshell:

require 'net/ssh/gateway'

gateway = Net::SSH::Gateway.new('host', 'user')

gateway.ssh("host.private", "user") do |ssh|
puts ssh.exec!("hostname")
end

gateway.open("host.private", 80) do |port|
Net::HTTP.get_print("127.0.0.1", "/path", port)
end

gateway.shutdown!

As of 1.1.0, you can also specify the wait time for the

gateway thread with the :loop_wait option.

gateway = Net::SSH::Gateway.new('host', 'user', :loop_wait => 0.001)

See Net::SSH::Gateway for more documentation.

REQUIREMENTS:

net-ssh (version 2)

If you want to run the tests or use any of the Rake tasks, you'll need:

Echoe (for the Rakefile)
Mocha (for the tests)

INSTALL:

$ gem install net-ssh-gateway

However, in order to be sure the code you're installing hasn't been tampered with, it's recommended that you verify the signature. To do this, you need to add the project's public key as a trusted certificate (you only need to do this once):

# Add the public key as a trusted certificate
# (You only need to do this once)
$ curl -O https://raw.githubusercontent.com/net-ssh/net-ssh-gateway/master/net-ssh-public_cert.pem
$ gem cert --add net-ssh-public_cert.pem

Then, when install the gem, do so with high security:

$ gem install net-ssh-gateway -P HighSecurity

If you don't add the public key, you'll see an error like "Couldn't verify data signature".

Ruby 1.9

As of release 2.0.0, net-ssh-gateway supports only Ruby >= 2.0.0. The last release that supports Ruby 1.9 is 1.3.0.

LICENSE:

(The MIT License)

Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the
'Software'), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Owner metadata

Name: net-ssh
Login: net-ssh
Email:
Kind: organization
Description:
Website:
Location:
Twitter:
Company:
Icon url: https://avatars.githubusercontent.com/u/75385?v=4
Repositories: 8
Last ynced at: 2024-03-25T19:51:32.738Z
Profile URL: https://github.com/net-ssh

GitHub Events

Total

Last Year

Committers metadata

Last synced: about 17 hours ago

Total Commits: 44
Total Committers: 6
Avg Commits per committer: 7.333
Development Distribution Score (DDS): 0.523

Commits in past year: 0
Committers in past year: 0
Avg Commits per committer in past year: 0.0
Development Distribution Score (DDS) in past year: 0.0

Name	Email	Commits
delano	d**o@s**m	21
Jamis Buck	j**s@3**m	13
Tony Pitale	t**e@g**m	6
Kensuke Nagae	k**y@g**m	2
Mat Trudel	m**t@g**t	1
Grant Hutchins & Michael Schubert	p**t@p**m	1

Committer domains:

Issue and Pull Request metadata

Last synced: 13 days ago

Total issues: 10
Total pull requests: 9
Average time to close issues: 11 months
Average time to close pull requests: 10 months
Total issue authors: 8
Total pull request authors: 7
Average comments per issue: 2.6
Average comments per pull request: 4.56
Merged pull request: 4
Bot issues: 0
Bot pull requests: 0

Past year issues: 0
Past year pull requests: 0
Past year average time to close issues: N/A
Past year average time to close pull requests: N/A
Past year issue authors: 0
Past year pull request authors: 0
Past year average comments per issue: 0
Past year average comments per pull request: 0
Past year merged pull request: 0
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/net-ssh/net-ssh-gateway

Top Issue Authors

tpitale (2)
arnoldtonderaimarunda (2)
barttenbrinke (1)
knugie (1)
zeroem (1)
krmannix (1)
bobziuchkovski (1)
nandin87 (1)

Top Pull Request Authors

tpitale (3)
thechile (1)
voxik (1)
altherlex (1)
bitaxis (1)
kyanny (1)
pivotal-casebook (1)

Top Issue Labels

Top Pull Request Labels

Package metadata

Total packages: 13
Total downloads:
- rubygems: 113,135,473 total
Total docker downloads: 158,484,926
Total dependent packages: 85 (may contain duplicates)
Total dependent repositories: 20,888 (may contain duplicates)
Total versions: 29
Total maintainers: 3

gem.coop: net-ssh-gateway

A simple library to assist in establishing tunneled Net::SSH connections

Homepage: https://github.com/net-ssh/net-ssh-gateway
Documentation: http://www.rubydoc.info/gems/net-ssh-gateway/
Licenses: MIT
Latest release: 2.0.0 (published about 9 years ago)
Last Synced: 2026-03-02T15:02:03.272Z (1 day ago)
Versions: 6
Dependent Packages: 0
Dependent Repositories: 0
Downloads: 56,572,322 Total
Docker Downloads: 79,242,463
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 0.256%
- Downloads: 0.464%
- Docker downloads count: 0.561%
Maintainers (3)
- delano
- mfazekas
- minam

rubygems.org: net-ssh-gateway