Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
platput authored Mar 8, 2023
1 parent 333f18f commit 3bf1597
Showing 1 changed file with 14 additions and 3 deletions.
17 changes: 14 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,16 @@
# sockv5er
a tool to create ssh tunnels on demand using the free tier ec2 instances from AWS from any given region

# Setup
## What does it do:
- Creates a security group with port 22 open to the world
- Creates a private key which will be used to connect to the ec2 instance
- Creates an ec2 instance which will shutdown in 20 minutes if nothing is done.
- Connects to the ec2 instance and starts a socksv5 proxy using ssh tunnel
- Once you add the proxy settings for 127.0.01:1337 all your browser traffic will be encrypted and transferred through the tunnel between your system and the ec2 instance.
- Cleans up the ec2 instance after usage.
- Subsequent runs of this app will give you option to clean up any existing resources created by this app.

# ⚙️ Setup
- Create a new AWS account and set up the access id and secret key
- Set the below env variables in the system.

Expand All @@ -15,15 +24,17 @@ SOCKS_V5_PORT=1337 # A free port on your system.
- Press CTRL + C to exit.
- To clean up all the resources, execute `sockv5er` again and press `Y`

# Features
# 🎊 Features
- Creates an EC2 instance in the free tier and starts an SSH tunnel which can be used as socksv5 proxy
- Terminates the created EC2 instances in 20 minutes after it starts up in case the app crashes
- Tracks the resources the app creates so that it can be deleted in the subsequent run

# TODO
# 📝 TODO
- Postpone the shutdown of the EC2 instance as long as the ssh tunnel is active
- Handle the exit from the SSH tunnel in a graceful way
- Add more test cases
- Make the readme.md a bit more elaborate
- Add better log messages and print statements

# ✏️ Contribute
All contrbutions are welcome. So raise away your PRs. But I will be prioritising the PRs with items from the TODO list above.

0 comments on commit 3bf1597

Please sign in to comment.