Skip to content

aamirmousavi/wiresuck

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🧦 Wiresuck

A high-performance, user-space WireGuard-to-Proxy tunnel for macOS. wiresuck allows you to route SOCKS5 and HTTP proxy traffic through a WireGuard tunnel WITHOUT needing root privileges or changing your system's network configuration.

Wiresuck is a fully installable desktop application. You can download the latest pre-built version from our Releases Page.

✨ Features

  • 🛡️ Rootless Operation: Runs entirely in user-space using the WireGuard netstack. No sudo or system-wide network changes required.
  • 🔄 Mixed Mode: A single local port automatically detects and handles both SOCKS5 and HTTP proxy protocols.
  • 🖼️ Native GUI: A beautiful desktop application with system tray support, real-time activity monitoring, and configuration management.
  • ⌨️ Standalone CLI: A powerful command-line interface for headless use or automation.
  • 📂 Easy Import: Import your standard WireGuard .conf files directly into the app.
  • ⚡ Performance Config: Customizable MTU and port settings with automatic persistence.
  • 🔍 Activity Monitor: Prepend-based real-time logging to see connection requests as they happen.

🚀 Installation & Building

Prerequisites

  • Go 1.26.4 or later.
  • Fyne Helper Tool: Required for packaging the installable app.
    go install fyne.io/fyne/v2/cmd/fyne@latest

Build the Installable App (macOS)

To create a native .app bundle that you can move to your /Applications folder:

# Package the GUI as an installable macOS App
fyne package -os darwin -icon gui/icon.png -appID com.wiresuck.app -name Wiresuck

Build from Source (Binaries Only)

# Clone the repository
git clone https://github.com/aamirmousavi/wiresuck.git
cd wiresuck

# Build the GUI binary
go build -o wiresuck-gui ./main.go

# Build the CLI binary
go build -o wiresuck-cli ./cli/main.go

🖥️ Usage

Native GUI (wiresuck-gui)

Simply run the binary or open the Wiresuck.app bundle:

  • Tunnels: Import your .conf files via the sidebar.
  • Monitor: Direct visibility into active connections (SOCKS5/HTTP).
  • Settings: Persistent storage of your preferred Port and MTU.
  • Tray: Close the window to hide the app; manage activation via the menu bar icon.

Command Line (wiresuck-cli)

Perfect for servers or power users:

./wiresuck-cli --config my-vpn.conf --port 1080 --log

🛠️ Testing the Connection

Once Wiresuck is active, you can route any application through it:

Using SOCKS5:

curl --socks5 127.0.0.1:1080 https://ifconfig.me

Using HTTP Proxy:

curl --proxy http://127.0.0.1:1080 https://ifconfig.me

📝 License

MIT License. Created with ❤️ for privacy and convenience.

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Packages

 
 
 

Contributors

Languages