Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mmiranda/cfdtunnel
A wrapper for cloudflared that manages multi clients for you
https://github.com/mmiranda/cfdtunnel
cloudflared cloudlfare clouflare-access go golang proxy tunnel
Last synced: 10 days ago
JSON representation
A wrapper for cloudflared that manages multi clients for you
- Host: GitHub
- URL: https://github.com/mmiranda/cfdtunnel
- Owner: mmiranda
- License: mit
- Created: 2021-11-25T14:05:00.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2023-05-19T03:59:43.000Z (over 1 year ago)
- Last Synced: 2024-08-01T12:17:02.405Z (3 months ago)
- Topics: cloudflared, cloudlfare, clouflare-access, go, golang, proxy, tunnel
- Language: Go
- Homepage:
- Size: 176 KB
- Stars: 51
- Watchers: 2
- Forks: 1
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](http://golang.org)
[](https://codecov.io/gh/mmiranda/cfdtunnel)
[](https://goreportcard.com/report/github.com/mmiranda/cfdtunnel)
](https://github.com/mmiranda/cfdtunnel/actions/workflows/test-coverage.yml/badge.svg)
# Cloudflared Tunnel Wrapper
**cfdtunnel** is a wrapper for [cloudflared](https://github.com/cloudflare/cloudflared) `access` tunnel, designed to access multiple tunnels without having to worry about your `cloudflared` process.
### Why?
To manage the **cloudflared** process is tedious and error prone when using multiple tunnels, leading to port conflicts, clients left running for no reason and so on.
This tool automates the following process:
```bash
cloudflared access tcp --hostname foo.bar.com --url 127.0.0.1:1234
cloudflared access tcp --hostname foo.bar2.com --url 127.0.0.1:5678
cloudflared access tcp --hostname foo.bar3.com --url 127.0.0.1:xxxx
```
## Installation
The easiest way to install it is using Homebrew:
```bash
brew tap mmiranda/apps
brew install cfdtunnel
```
If you prefer, you also can download the latest binary on the [release section](https://github.com/mmiranda/cfdtunnel/releases)
## How does it work?
Basically this tool takes care of the `cloudflared` process initialization for you.
1. Runs cloudflared based on you config ini file
2. Runs the command you want
3. Kills the cloudflared proccess at the end
You can use any command on top of *cfdtunnel*:
### Kubectl
```bash
cfdtunnel --profile my-profile1 -- kubectl get namespaces
```
### K9S
```bash
cfdtunnel --profile my-profile1 -- k9s
```
### Configuration
Configuration is really simple, you just need to create your profiles in `~/.cfdtunnel/config`
Example:
```ini
[my-profile1]
host = https://kubernetes.foo.bar.com
port = 1234
env = HTTPS_PROXY=socks5://127.0.0.1:1234
# env = OTHER=value
[my-profile2]
host = sql.foo.bar.com
# port is not necessary
```
Defining a port is not required, if you don't specify, *cfdtunnel* will launch the tunnel using the ~~most random~~ port **5555**
#### Environment Variables
In case your application demands specific environment variables, *cfdtunnel* will make sure it is created prior to its execution. You just need to define it on config file as well.
## Contributing
Contributions, issues, and feature requests are welcome!
Give a ⭐️ if you like this project!
## License
[MIT](https://choosealicense.com/licenses/mit/)