Back to Kodegakure

ShadowGuard VPN

Version: 1.0.0

Free, unlimited VPN solution with a server in France. Fully open source and customizable.

Download ShadowGuard VPN
Client Setup
Server Setup
Client Application

Installation Instructions

1. Download and Install

Download the Shadowguard Setup 1.0.0.exe.

Run the installer and complete the installation.

2. Place Configuration File

After installation, navigate to:

C:\Program Files\Shadowguard

Place your wg-client.conf file inside this folder alongside the other Shadowguard files.

Important: The VPN cannot connect without this configuration file.

3. Run Shadowguard

Right-click on Shadowguard.exe and select:

Run as Administrator

The app requires admin permissions to control VPN connections.

Troubleshooting

WireGuard Missing?

In some cases, WireGuard is not automatically installed.

If this happens:

  • Locate wireguard-installer.exe inside the installation folder.
  • Run the installer and follow the steps to install WireGuard.
  • Try opening Shadowguard again with admin rights.

Create Your Own VPN Server (Any VPS)

Follow these steps to set up your personal VPN server on any VPS provider.

📦 Requirements

  • A VPS (any provider) with Ubuntu 20.04+
  • SSH client (PuTTY for Windows or Terminal for Mac/Linux)
  • Root access to your VPS
  • Basic command line knowledge

🚀 Step 1: Connect to Your VPS

Connect to your VPS via SSH:

ssh root@your_vps_ip

Enter your password when prompted.

🔒 Step 2: Install WireGuard

apt update
apt install wireguard -y

🔑 Step 3: Generate Server Keys

wg genkey | tee server_privatekey | wg pubkey > server_publickey

View and save your server private key:

cat server_privatekey

Tip: Keep your private keys secure! Never share them.

📝 Step 4: Create WireGuard Config

nano /etc/wireguard/wg0.conf

Paste the following configuration (replace with your private key):

[Interface]
PrivateKey = YOUR_SERVER_PRIVATE_KEY
Address = 10.0.0.1/24
ListenPort = 51820

PostUp = iptables -A FORWARD -i wg0 -j ACCEPT; iptables -t nat -A POSTROUTING -o eth0 -j MASQUERADE
PostDown = iptables -D FORWARD -i wg0 -j ACCEPT; iptables -t nat -D POSTROUTING -o eth0 -j MASQUERADE

Save and exit (Ctrl+X, Y, Enter).

🔥 Step 5: Enable IP Forwarding

echo "net.ipv4.ip_forward=1" >> /etc/sysctl.conf
sysctl -p

🔓 Step 6: Configure Firewall

ufw allow 51820/udp
ufw allow OpenSSH
ufw enable

🏁 Step 7: Start WireGuard

wg-quick up wg0
systemctl enable wg-quick@wg0

Check the status:

wg

📱 Step 8: Create Client Config

Generate client keys:

wg genkey | tee client_privatekey | wg pubkey > client_publickey

Add the client to the server config:

nano /etc/wireguard/wg0.conf

Add at the bottom (replace with client public key):

[Peer]
PublicKey = CLIENT_PUBLIC_KEY
AllowedIPs = 10.0.0.2/32

Restart WireGuard:

wg-quick down wg0
wg-quick up wg0

Create the client configuration file:

[Interface]
PrivateKey = CLIENT_PRIVATE_KEY
Address = 10.0.0.2/24
DNS = 1.1.1.1

[Peer]
PublicKey = SERVER_PUBLIC_KEY
Endpoint = YOUR_VPS_IP:51820
AllowedIPs = 0.0.0.0/0
PersistentKeepalive = 25

Save this as wg-client.conf and use it with ShadowGuard VPN.

ShadowGuard Client Application

The ShadowGuard VPN client is built using Electron, allowing it to run as a standalone desktop application on Windows, macOS, and Linux.

Note: While Electron provides a convenient way to build cross-platform desktop apps, there are other approaches to creating VPN clients, such as native applications or browser extensions. The Electron approach was chosen for its cross-platform capabilities and ease of development.

SHADOW-GUARD

🇫🇷

France #1

Status: Disconnected

DOWN 0 Mbps
UP 0 Mbps

Application Structure

Simulation only — download the full version to connect.

main.js

Electron main process

index.html

Application UI

renderer.js

UI interaction logic

preload.js

IPC bridge

wg-client.conf

VPN configuration

package.json

Project configuration

Key Functionality

  • Manages WireGuard VPN connection
  • Provides real-time connection status
  • Simulates network speed monitoring
  • Visual traffic graph
  • One-click connect/disconnect

Building the Application

To build the ShadowGuard application:

npm install
npm run build

Development Note: The application is developed in Visual Studio Code and built using electron-builder to create installers for different platforms.

Key Features

Free & Unlimited

Unrestricted VPN access for everyone

France Server

Fast and reliable connection

Any VPS

Set up on any provider

Lightweight

Minimal resource usage

Open Source

Fully transparent code

Cross-Platform

Runs on Windows, macOS, Linux

Notes

You are free to use, inspect, and modify the files included in the installation directory.

This VPN is provided as is, without any restrictions or limits.

Final Note: WireGuard is a modern VPN protocol that's fast and secure. If you allow multiple clients, speed may drop - this is normal for VPNs.