Skip to content

Commit 389eab6

Browse files
committed
update docs
1 parent d96b66e commit 389eab6

File tree

1 file changed

+31
-12
lines changed

1 file changed

+31
-12
lines changed

README.md

Lines changed: 31 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -91,7 +91,7 @@ $ chisel server --help
9191
variable PORT and fallsback to port 8080).
9292
9393
--key, An optional string to seed the generation of a ECDSA public
94-
and private key pair. All commications will be secured using this
94+
and private key pair. All communications will be secured using this
9595
key pair. Share the subsequent fingerprint with clients to enable detection
9696
of man-in-the-middle attacks (defaults to the CHISEL_KEY environment
9797
variable, otherwise a new key is generate each run).
@@ -122,17 +122,24 @@ $ chisel server --help
122122
--reverse, Allows client to specify reverse port forwarding remotes
123123
in addition to normal remotes.
124124
125-
--pid Generate pid file in current directory
125+
--pid Generate pid file in current working directory
126126
127127
-v, Enable verbose logging
128128
129129
--help, This help text
130130
131+
Signals:
132+
The chisel process is listening for:
133+
a SIGUSR2 to print process stats, and
134+
a SIGHUP to short-circuit the client reconnect timer
135+
131136
Version:
132137
X.Y.Z
133138
134139
Read more:
135140
https://github.com/jpillora/chisel
141+
142+
136143
```
137144

138145
```
@@ -170,12 +177,17 @@ $ chisel client --help
170177
5000:socks
171178
R:2222:localhost:22
172179
173-
*When the chisel server has --socks5 enabled, remotes can
180+
When the chisel server has --socks5 enabled, remotes can
174181
specify "socks" in place of remote-host and remote-port.
175182
The default local host and port for a "socks" remote is
176183
127.0.0.1:1080. Connections to this remote will terminate
177184
at the server's internal SOCKS5 proxy.
178185
186+
When the chisel server has --reverse enabled, remotes can
187+
be prefixed with R to denote that they are reversed. That
188+
is, the server will listen and accept connections, and they
189+
will be proxied through the client which specified the remote.
190+
179191
Options:
180192
181193
--fingerprint, A *strongly recommended* fingerprint string
@@ -194,27 +206,34 @@ $ chisel client --help
194206
specify a time with a unit, for example '30s' or '2m'. Defaults
195207
to '0s' (disabled).
196208
197-
--proxy, An optional HTTP CONNECT proxy which will be used reach
198-
the chisel server. Authentication can be specified inside the URL.
199-
For example, http://admin:[email protected]:8081
200-
201209
--max-retry-count, Maximum number of times to retry before exiting.
202210
Defaults to unlimited.
203211
204212
--max-retry-interval, Maximum wait time before retrying after a
205213
disconnection. Defaults to 5 minutes.
206214
207-
--pid Generate pid file in current directory
215+
--proxy, An optional HTTP CONNECT proxy which will be used reach
216+
the chisel server. Authentication can be specified inside the URL.
217+
For example, http://admin:[email protected]:8081
218+
219+
--pid Generate pid file in current working directory
208220
209221
-v, Enable verbose logging
210222
211223
--help, This help text
212224
225+
Signals:
226+
The chisel process is listening for:
227+
a SIGUSR2 to print process stats, and
228+
a SIGHUP to short-circuit the client reconnect timer
229+
213230
Version:
214231
X.Y.Z
215232
216233
Read more:
217234
https://github.com/jpillora/chisel
235+
236+
218237
```
219238

220239
### Security
@@ -338,13 +357,13 @@ See more [test/](test/)
338357

339358
### Changelog
340359

341-
- `1.0.0` - Initial release
342-
- `1.1.0` - Swapped out simple symmetric encryption for ECDSA SSH
343-
- `1.2.0` - Added SOCKS5 (server) and HTTP CONNECT (client) support
360+
- `1.0` - Initial release
361+
- `1.1` - Swapped out simple symmetric encryption for ECDSA SSH
362+
- `1.2` - Added SOCKS5 (server) and HTTP CONNECT (client) support
363+
- `1.3` - Added reverse tunnelling support
344364

345365
### Todo
346366

347-
- Allow clients to act as an indirect tunnel endpoint for other clients
348367
- Better, faster tests
349368
- Expose a stats page for proxy throughput
350369
- Treat client stdin/stdout as a socket

0 commit comments

Comments
 (0)