https://github.com/laserattack/vos.sh
VPN over SSH for Linux
https://github.com/laserattack/vos.sh
Last synced: about 1 month ago
JSON representation
VPN over SSH for Linux
- Host: GitHub
- URL: https://github.com/laserattack/vos.sh
- Owner: laserattack
- License: wtfpl
- Created: 2026-07-05T20:41:01.000Z (about 1 month ago)
- Default Branch: master
- Last Pushed: 2026-07-05T20:56:56.000Z (about 1 month ago)
- Last Synced: 2026-07-05T22:13:46.418Z (about 1 month ago)
- Language: Shell
- Size: 1.95 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# vos.sh
VPN tunnel via SSH SOCKS5 proxy using
[tun2socks](https://github.com/xjasonlyu/tun2socks)
## Requirements
`tun2socks` in PATH, `sudo` access
## Installation
1. Download `tun2socks` and place it in PATH
2. Make `vos.sh` executable
## Configuration
Edit the settings block at the top of the script:
```
SSH_USER=""
SSH_HOST=""
SSH_PORT=""
SOCKS_PORT=""
```
## Usage
```
./vos.sh start Start VPN tunnel
./vos.sh stop Stop VPN tunnel
./vos.sh status Show tunnel status
```
## How it works
1. All traffic routes through **TUN interface -> tun2socks -> local
SOCKS5 -> SSH tunnel**
2. Traffic to the SSH server itself bypasses the tunnel to keep the
connection alive
3. Two default routes: VPN via TUN (metric 1) and fallback via
physical gateway (metric 10)