passageway 0.0.1 → 0.0.2
Sign up to get free protection for your applications and to get access to all the features.
- data/README.md +52 -17
- data/lib/passageway/version.rb +1 -1
- metadata +3 -3
data/README.md
CHANGED
@@ -1,29 +1,64 @@
|
|
1
|
-
# Passageway
|
1
|
+
# Passageway -- instant public tunnel to your local web server
|
2
2
|
|
3
|
-
|
3
|
+
## Install
|
4
4
|
|
5
|
-
|
5
|
+
Now you can install Passageway with RubyGems:
|
6
6
|
|
7
|
-
|
7
|
+
% gem install passageway
|
8
8
|
|
9
|
-
|
9
|
+
or to get the source:
|
10
10
|
|
11
|
-
|
11
|
+
git clone http://github.com/rtyler/passageway.git
|
12
12
|
|
13
|
-
|
13
|
+
## Usage
|
14
14
|
|
15
|
-
|
15
|
+
passageway [options] <localport>
|
16
|
+
-k, --key FILE upload a public key for authentication
|
16
17
|
|
17
|
-
|
18
|
+
Passageway is a client to a free and open source reverse tunneling
|
19
|
+
service made specifically for web traffic. It's intended to be used to
|
20
|
+
temporarily expose local web servers to the greater Internet for
|
21
|
+
debugging, unit tests, demos, etc.
|
18
22
|
|
19
|
-
|
23
|
+
This is how you make your local port 8080 public:
|
24
|
+
|
25
|
+
$ passageway 8080
|
26
|
+
Port 8080 is now publicly accessible from http://8bv2.localtunnel.com ...
|
27
|
+
|
28
|
+
$ passageway 8080
|
29
|
+
Port 8080 is now publicly accessible from http://8bv2.localtunnel.com ...
|
30
|
+
|
31
|
+
Using Passageway is comparable to using SSH reverse/remote port
|
32
|
+
forwarding on a remote host that has GatewayPorts enabled, but without
|
33
|
+
all the configuration or the need of a host. The localtunnel command
|
34
|
+
works with a server component that is running on localtunnel.com,
|
35
|
+
which is provided as a free service.
|
36
|
+
|
37
|
+
If you have never run localtunnel before, you'll need to upload a public
|
38
|
+
key to authenticate. You do this once:
|
39
|
+
|
40
|
+
$ passageway -k ~/.ssh/id_rsa.pub 8080
|
41
|
+
|
42
|
+
After that, you shouldn't have to use -k again.
|
43
|
+
|
44
|
+
Passageway can be started before or after the local web server. It
|
45
|
+
tunnels through to the url given in that status message "publicly
|
46
|
+
accessible from..." for as long as the command is running. The tunnel
|
47
|
+
is closed if the command exits.
|
48
|
+
|
49
|
+
Passageway will search for the file `.localtunnel_callback` in the current
|
50
|
+
working directory. If it exists, it will execute the file with one argument,
|
51
|
+
the public endpoint, when the tunnel is opened. This is useful for starting
|
52
|
+
other tools or processes that need the name of the endpoint.
|
53
|
+
|
54
|
+
## Contributors
|
20
55
|
|
21
|
-
|
56
|
+
andyl (andy@r210.com)
|
57
|
+
Charles Merriam (charles.merriam@gmail.com)
|
58
|
+
Hunter Gillane (hunter.gillane@gmail.com)
|
59
|
+
Michael Sofaer (msofaer@pivotallabs.com)
|
60
|
+
Jeff Lindsay (progrium@gmail.com)
|
22
61
|
|
23
|
-
##
|
62
|
+
## License
|
24
63
|
|
25
|
-
|
26
|
-
2. Create your feature branch (`git checkout -b my-new-feature`)
|
27
|
-
3. Commit your changes (`git commit -am 'Add some feature'`)
|
28
|
-
4. Push to the branch (`git push origin my-new-feature`)
|
29
|
-
5. Create new Pull Request
|
64
|
+
MIT
|
data/lib/passageway/version.rb
CHANGED
metadata
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: passageway
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 0.0.
|
4
|
+
version: 0.0.2
|
5
5
|
prerelease:
|
6
6
|
platform: ruby
|
7
7
|
authors:
|
@@ -127,7 +127,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
|
|
127
127
|
version: '0'
|
128
128
|
segments:
|
129
129
|
- 0
|
130
|
-
hash: -
|
130
|
+
hash: -778556231809903355
|
131
131
|
required_rubygems_version: !ruby/object:Gem::Requirement
|
132
132
|
none: false
|
133
133
|
requirements:
|
@@ -136,7 +136,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
|
|
136
136
|
version: '0'
|
137
137
|
segments:
|
138
138
|
- 0
|
139
|
-
hash: -
|
139
|
+
hash: -778556231809903355
|
140
140
|
requirements: []
|
141
141
|
rubyforge_project:
|
142
142
|
rubygems_version: 1.8.25
|