SlipStream GUI

<div align="center"> <img src="screeen_1-4-0.png" alt="SlipStream GUI Screenshot" width="800"> </div> <div align="center"> <img src="https://img.shields.io/badge/Platform-macOS%20%7C%20Windows%20%7C%20Linux-blue?style=for-the-badge" alt="Platform"> <img src="https://img.shields.io/badge/License-MIT-green?style=for-the-badge" alt="License"> <img src="https://img.shields.io/badge/Node.js-18%2B-brightgreen?style=for-the-badge" alt="Node.js"> <a href="https://github.com/mirzaaghazadeh/SlipStreamGUI/releases/latest"> <img src="https://img.shields.io/github/v/release/mirzaaghazadeh/SlipStreamGUI?style=for-the-badge&label=Version&sort=semver" alt="Version"> </a> <img src="https://img.shields.io/github/actions/workflow/status/mirzaaghazadeh/SlipStreamGUI/release.yml?style=for-the-badge&label=Build" alt="Build Status"> </div> <br> <div align="center"> <a href="README-EN.md">📄 Simple User Guide (English)</a> <br><br>

<a href="README-FA.md">📄 راهنما ساده استفاده (فارسی)</a>

</div> <br> <div align="center"> <strong>A modern, cross-platform GUI client for SlipStream VPN</strong><br> Provides secure, system-wide tunneling through an HTTP proxy interface </div>

👀 Tour

Install the app from the latest release
Set your server (Domain) and DNS Resolver (one or more, separated by spaces/commas/new lines)
DNS Checker (optional): run it, and click "Use" on any OK row to set your DNS Resolver
FindNS Scanner (advanced, NoizDNS users): open FindNS from the header to scan public DNS resolvers for tunnel compatibility and click "Use" to apply a result as your DNS Resolver
Start VPN and watch the Status indicators turn “Running”
Verify with “Test Proxy Connection” and check the Logs panel if needed
Optional: Share your VPN over Wi‑Fi to your phone using the built-in HTTP proxy (8080)

📥 Download & Install

Latest Release

Direct downloads (latest release):

| Platform | Download | |----------|----------| | macOS (Apple Silicon) | SlipStream-GUI-macOS-ARM64.dmg | | macOS (Intel) | SlipStream-GUI-macOS-Intel.dmg | | Windows (64-bit) Installer | SlipStream-GUI-Windows-x64.exe | | Windows (64-bit) Portable | SlipStream-GUI-Windows-x64-Portable.exe | | Windows (32-bit) Installer | SlipStream-GUI-Windows-x86.exe | | Windows (32-bit) Portable | SlipStream-GUI-Windows-x86-Portable.exe | | Linux (x86_64) AppImage | SlipStream-GUI-Linux-x64.AppImage | | Linux (x86_64) DEB | SlipStream-GUI-Linux-x64.deb |

If a direct download fails, use the Releases page.

Quick Install

Download the latest release for your platform from the Releases page
Install the application (double-click the installer)
Run the app and click "Start VPN"

That's it! No additional setup required.

🚀 Quick Start Guide

First Time Setup

Launch SlipStream GUI after installation
Configure Settings (optional):
- DNS Resolver: Your DNS server (default: 8.8.8.8:53)
- Domain: Your SlipStream server domain (default: s.example.com)
- System Proxy: Toggle to auto-configure system proxy (recommended)
- Proxy Bypass List: Add domains or IPs to exclude from the proxy (one per line, e.g. *.google.com, 192.168.1.0/24)
DNS Checker (optional, recommended if you're unsure about DNS):
- Click "DNS Checker"
- Enter a test domain (example: google.com)
- Enter one or more DNS server IPs to test (you can paste large lists; up to 100 servers are checked in parallel)
- OK = OK (no action needed)
- Click "Use" on any OK row to auto-set your DNS Resolver (the app will force port 53)
Start the VPN:
- Click the "Start VPN" button
- Wait for status indicators to show "Running"
- Your traffic is now routed through SlipStream!

Using the VPN

Status Panel: Monitor connection status in real-time
Logs Panel: View connection activity and debug information
Verbose Logging: Toggle detailed logs for troubleshooting
Test Connection: Use the "Test Proxy Connection" button to verify functionality
Stop VPN: Click "Stop VPN" when you want to disconnect

NoizDNS (SlipNet) Mode (Optional)

If your server admin gives you a slipnet://... URL (from NoizDNS / SlipNet), you can use the alternative SlipNet (NoizDNS) connection mode:

In Configuration → Connection Type, select SlipNet (NoizDNS) instead of SlipStream
Paste your slipnet://BASE64... URL into SlipNet URL
(Optional) Set a DNS Server for SlipNet lookups (for example a tunnel-friendly resolver)
Click Start VPN – the rest of the workflow (status, logs, proxy sharing) is the same as SlipStream mode

If you are not sure what NoizDNS/SlipNet is, you can safely ignore this option and keep the default SlipStream mode.

Setting Up a NoizDNS Server

To use SlipStream GUI in SlipNet (NoizDNS) mode, you need a NoizDNS server running. For detailed instructions on deploying your own NoizDNS server, check out:

🔗 noizdns-deploy

This repository provides a one-click deployment script for setting up a NoizDNS (dnstt) server, including:

✅ One-command installation: Automated server deployment
✅ Auto-detection: Same server supports both standard dnstt and NoizDNS (DPI-evasion) clients
✅ DNS configuration guide: Step-by-step DNS setup instructions
✅ SOCKS5 proxy: Dante-based SOCKS proxy with optional authentication
✅ Prebuilt binaries: Fast installation for supported platforms
✅ Systemd integration: Auto-start, restart on failure, security hardening
✅ Management menu: Status, logs, restart, reconfigure, update, uninstall

Quick Server Setup:

# One-command server installation
bash <(curl -Ls https://raw.githubusercontent.com/anonvector/noizdns-deploy/main/noizdns-deploy.sh)

After installation, run noizdns anytime for the management menu.

What You'll Need:

A Linux server (Fedora, Rocky, CentOS, Debian, or Ubuntu)
A domain name with DNS access
Root or sudo access on the server

Before Running the Script — Configure your DNS records:

| Record | Name | Value | |--------|------|-------| | A | ns.example.com | Your server's IP address | | AAAA | ns.example.com | Your server's IPv6 address (optional) | | NS | t.example.com | ns.example.com |

Replace example.com with your domain. The t subdomain is the tunnel endpoint.

After Server Setup:

Wait for DNS propagation (can take up to 24 hours)
Generate your slipnet:// URL (keys and config are in /etc/noizdns/ — see the noizdns-deploy repository for details)
In SlipStream GUI, select SlipNet (NoizDNS) mode and paste your slipnet://BASE64... URL
(Optional) Set a DNS server for SlipNet lookups (e.g., a tunnel-friendly resolver)
Click "Start VPN" to connect!

Setting Up a SlipStream Server

To use SlipStream GUI, you need a SlipStream server running. For detailed instructions on deploying your own SlipStream server, check out:

🔗 slipstream-rust-deploy

This repository provides a one-click deployment script for setting up a SlipStream server, including:

✅ One-command installation: Automated server deployment
✅ DNS configuration guide: Step-by-step DNS setup instructions
✅ Multiple deployment modes: SOCKS proxy or SSH tunneling
✅ Prebuilt binaries: Fast installation for supported platforms
✅ Systemd integration: Automatic service management
✅ TLS certificates: Automatic certificate generation