https://github.com/yankeguo/termhere
A simple reverse shell tunnel with pty support (window size, ctrl-c, ctrl-d, etc.)
https://github.com/yankeguo/termhere
pty reverse shell tunnel
Last synced: about 2 months ago
JSON representation
A simple reverse shell tunnel with pty support (window size, ctrl-c, ctrl-d, etc.)
- Host: GitHub
- URL: https://github.com/yankeguo/termhere
- Owner: yankeguo
- License: mit
- Created: 2023-09-05T02:44:05.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-01-02T08:54:41.000Z (over 2 years ago)
- Last Synced: 2025-08-19T21:36:10.978Z (11 months ago)
- Topics: pty, reverse, shell, tunnel
- Language: Go
- Homepage:
- Size: 53.7 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# termhere
A simple reverse shell tunnel with pty support (window size, ctrl-c, ctrl-d, etc.)
## Usage
1. Get the binary `termhere` from [GitHub Releases](https://github.com/yankeguo/termhere/releases)
2. Start `termhere server` in **Machine 1**
```shell
export TERMHERE_TOKEN=aaa
./termhere server
```
3. Start `termhere client` in **Machine 2**
```shell
export TERMHERE_TOKEN=aaa
./termhere client -s 10.10.10.10:7777 /bin/bash
```
Now you can get a shell of **Machine 2** from the `termhere server` running in **Machine 1**
## TLS Support
`termhere` supports TLS with client authentication, you can use `--cert-file` and `--key-file` to enable TLS, and
use `--client-ca-file` to enable client authentication.
**TLS Simple**
```shell
# server
termhere server -l 'tcp+tls://:7777' --cert-file server.full-crt.pem --key-file server.key.pem
# client
termhere client -s "tcp+tls://127.0.0.1:7777" --ca-file rootca.crt.pem
```
**TLS with Client Auth**
```shell
# server
termhere server -l 'tcp+tls://:7777' --cert-file server.full-crt.pem --key-file server.key.pem --client-ca-file rootca.crt.pem
# client
termhere client -s "tcp+tls://127.0.0.1:7777" --ca-file rootca.crt.pem --cert-file client.full-crt.pem --key-file client.key.pem
```
Fore more information about **TLS Support**, please refer to [uniconn](https://github.com/yankeguo/uniconn)
## Credits
GUO YANKE, MIT License