torpedo - GitLite

KO | EN

gitlite — search

#ai #typescript #go #rust #deep-learning #docker #nodejs #macos #java #windows #cli #awesome-list #vue #pytorch

torpedo

(★ 110)

Connect to databases in private VPCs securely the easy way - no VPN required

File Explorer

Download Latest Version (.zip)

- - issue-template.md
- - binary.yml
- - main.go
- - bastion.go
  - stack.json
- - client.go
- - server.go
- build_binary
- build_docker
- release
.gitignore
.goreleaser.yml
Dockerfile
go.mod
go.sum
LICENSE
README.md

# Installation Guide

1. Get the code

git clone https://github.com/anomalyco/torpedo

Downloads the entire project code from GitHub to your computer.

cd torpedo

Moves into the project folder you just downloaded.

2. Docker

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Docker Desktop Needed to build and run containers. Install it and keep it running in the background.

docker build -t torpedo .

Builds a runnable image based on the Dockerfile.

docker run -p 8080:80 torpedo

Runs the built image as an actual container.

✅ Run docker compose ps to check the containers are Up. If the README mentions a port, open http://localhost:PORT in your browser.

3. Go

Medium

Prerequisites

Git Needed to download the project code from GitHub.
Go The Go compiler and toolchain.

go build ./...

Compiles the Go program into an executable.

go run .

Runs the Go program directly without a separate build step.

✅ If the build finishes without errors, it worked. If you used go run ., check the terminal output.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# torpedo

Connect to databases in private VPCs the easy way - no VPN required

## How it works

On first run, `torpedo` will create an ECS cluster (this does not cost anything). From there, any time you want to connect to a database `torpedo` will generate random SSH keys, spin up a temporary container that has access to your database, and forward a local port through it. Then you can connect to the database on `localhost` as though it were running locally. The container will be destroyed once you're done with your session.

## Usage

Make sure you have a default AWS profile set or manually set one with `AWS_PROFILE=xxx torpedo`

```shell
$ torpedo
🚀 torpedo is ready

connect to port 5432 on localhost
it's forwarded to main-1.cz73excokyft.us-east-2.rds.amazonaws.com:5432

press ctrl+c to exit
```

### Help

```shell
NAME:
   torpedo - A tool to access AWS resources behind a VPC

USAGE:
   torpedo [global options] command [command options] [arguments...]

COMMANDS:
   client, c  Run the client command
   server, s  Run the server command
   help, h    Shows a list of commands or help for one command

GLOBAL OPTIONS:
   --verbose   (default: false)
   --help, -h  show help
```

## Acknowledgements

This wasn't my idea! There is a much more fleshed out product called `7777` here: [https://port7777.com/](https://port7777.com/) by [Matthieu Napoli](https://mnapoli.fr/) and [Marco Aurélio Deleu](https://blog.deleu.dev/). `torpedo` works in a similar way but was rewritten in Go for faster bootup speeds and made open source for community contribution.