https://github.com/phx/dockervpn
DockerVPN is an OpenConnect-based VPN client that exposes an upstream proxy via TinyProxy on localhost:8888. DockerVPN uses the docker0 interface so you can stay connected to both an external network, while having SSH and HTTP/S access to a remote internal network, and it's a great alternative to VPN split-tunneling.
https://github.com/phx/dockervpn
Last synced: about 1 year ago
JSON representation
DockerVPN is an OpenConnect-based VPN client that exposes an upstream proxy via TinyProxy on localhost:8888. DockerVPN uses the docker0 interface so you can stay connected to both an external network, while having SSH and HTTP/S access to a remote internal network, and it's a great alternative to VPN split-tunneling.
- Host: GitHub
- URL: https://github.com/phx/dockervpn
- Owner: phx
- License: agpl-3.0
- Created: 2019-10-08T04:15:54.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2020-04-21T16:28:34.000Z (about 6 years ago)
- Last Synced: 2025-01-29T10:33:58.229Z (over 1 year ago)
- Language: Shell
- Size: 42 KB
- Stars: 1
- Watchers: 3
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# DockerVPN
DockerVPN is an OpenConnect-based VPN client that exposes an upstream proxy via TinyProxy on localhost:8888. DockerVPN uses the docker0 interface so you can stay connected to both an external network, while having SSH and HTTP/S access to a remote internal network, and it's a great alternative to VPN split-tunneling.
## Install:
1. `git clone https://github.com/phx/dockervpn.git`
2. `cd dockervpn`
3. `./install.sh`
## Run:
```
Connect: 'dockervpn'
View status/logs: 'dockervpn --status'
Re-connect: 'dockervpn'
Disconnect: 'docker stop vpn'
Exec into container: 'sshvpn'
Browse to internal sites: point proxy to '127.0.0.1:8888'
To change (and persist) VPN and/or proxy passwords:
'dockervpn --changepass' OR
'dockervpn --changepass [OLD_VPN/PROXY_PASS] [NEW_VPN/PROXY_PASS]' OR
'dockervpn --changepass [OLD_VPN_PASS] [NEW_VPN_PASS] [OLD_PROXY_PASS] [NEW_PROXY_PASS]'
-c | --creds [USER:PASS] Specify credentials to use for both VPN_USER/PROXY_USER
and VPN_PASS/PROXY_PASS.
-h | --help Display this help text.
-i | --interactive Run in interactive mode and prompt for VPN_USER, VPN_PASS,
PROXY_USER, and PROXY_PASS. If you wish to do this, you can
remove any hardcoded variables from /usr/local/bin/dockervpn.
-p | --password [VPN_PASS/PROXY_PASS] Pass the VPN_PASS/PROXY_PASS password on the command line
(both passwords must match to use this option).
-s | --status Check the status of DockerVPN.
-u | --user [VPN_USER/PROXY_USER] Specify the user. You will be prompted for password if not
combined with -p or --password.
```
## Uninstall:
1. `git clone https://github.com/phx/dockervpn.git` (in case you already deleted it)
2. `cd dockervpn`
3. `./uninstall.sh`
## To-Do:
- Get feedback on the command line parameters (file an issue).
- Maybe re-do `install.sh` using `case` statements to provide better functionality for more use cases.
- Make the entire setup more secure by using encryption and `$XDG_HOME` config file.