Skip to content

mcfly722/cloak-vpn-helper

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

46 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Cloak + Wireguard VPN Gateway helper

Status: done version License: GPL3.0

Problem

Many devices (like Samsung Smart TV) has no proxy settings to configure it through v2rayN proxy, so for this kind devices separate VPN gateway required.

This helper simplifies this IP VPN Gateway installation (Used Cloak + WireGuard).

Finally, data flows through the following chain:

  • LAN: Smart TV or other device (in device network settings you should configure new VPN Gateway IP)
  • LAN: VPN Gateway
  • LAN: WireGuard client
  • LAN: Cloak client
  • Censored Internet
  • Remote: Cloak server
  • Remote: WireGuard server
  • Free Internet

Helper generates required key pairs and gives you final bash scripts for deployment.
All keys generates on client side (by your internet browser) and not transmitted to any servers! (it is zero trust configurator)

Helper site: https://mcfly722.github.io/cloak-vpn-helper

Supported OS

OS bit Architecture Tested
Raspberry Pi OS x64 arm64
Ubuntu 24.04 x64 amd64
Ubuntu 22.04 x64 amd64

Debug & Troubleshooting

Cloak and Wireguard configs locations:

Location File
Local Gateway /etc/cloak/cloak-client.json
Local Gateway /etc/wireguard/wg0.conf
External VM /etc/cloak/cloak-server.json
External VM /etc/wireguard/wg0.conf

useful commands:

# view journals
sudo journalctl -u cloak-server.service -f
sudo journalctl -u cloak-client.service -f

# for internal gateway
ss -nltu 'sport = 1984'
sudo tcpdump -i any -nn src host <YOUR EXTERNAL VM IP> and port 443

# for remote VM
ss -nltu 'sport = 443'
ss -nltu 'sport = 51820'
sudo tcpdump -nei ens3 tcp port 443
sudo tcpdump -nei ens3 udp port 51820

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published