🦊 KettuRay

A sleek, powerful, and hybrid VPN client for Windows built with Go and Wails.

Features • Architecture • Getting Started • Development

📖 Overview

KettuRay is a lightweight yet immensely powerful VPN client combining the best proxy cores into a single, seamless Windows experience. Built heavily around a dark "design-code" aesthetic, it provides a distraction-free, vertical, frameless user interface with ultra-fast UX flows.

✨ Features

⚡ Hybrid Core Engine: Leverages the power of Xray-core as the backend proxy engine and sing-box as the TUN-based frontend for reliable system-wide traffic routing.
🎨 Premium UI/UX: Compact, frameless, and dark-themed interface built specifically for Windows. Enjoy smooth animations, beautiful typography, and immediate responsiveness.
🔐 Next-Gen Protocols: Full support for VLESS, VMess, Trojan, Shadowsocks, REALITY, and gRPC.
📋 Seamless Import: Smart clipboard parsing allows you to copy a config link and instantly add it to your profile.
🔄 Smart Connectivity: Real-time ping testing, auto-connect on startup, and intelligent auto-reconnect fallback mechanism.
⌨️ Global Hotkeys: Control KettuRay instantly from anywhere with Win + Alt + V.
🔔 Native Integrations: Sleek system tray icon management and native Windows notifications popping right above your taskbar.
📜 Live Logs: Expandable sidebar with real-time connection logging and copy capabilities.

🏗 Architecture

KettuRay utilizes a split-core design:

Frontend: JavaScript/HTML/CSS powered by Vite, packed inside a borderless Wails v2 Webview wrapper.
Controller (Go): A robust Go backend that handles system-level calls, hotkeys, systray menus, and inter-process communication (IPC).
Network Cores:
- Xray-core securely negotiates complex proxy connections to your remote endpoints.
- sing-box wraps the connection in a virtual network interface (TUN) to capture all local system traffic correctly without tedious system proxy configurations.

🚀 Getting Started

Prerequisites

To build and run KettuRay, you will need:

Go 1.20+
Node.js 16+ (for frontend assets)
Wails CLI v2

Install Wails globally via Go:

go install github.com/wailsapp/wails/v2/cmd/wails@latest

Installation

Clone the repository:

git clone https://github.com/khton/kettuRay.git
cd kettuRay_go

Install frontend dependencies:
```
cd frontend
npm install
cd ..
```

🛠 Development

Start the application in development mode with live reloading for both Go and the frontend:

wails dev

To build a standalone production executable:

wails build -clean -platform windows/amd64

The compiled binary (kettuRay.exe) will be generated inside the build/bin directory.

_{Developed with ❤️ for secure and aesthetically pleasing internet access.}

3.6 KiB Raw Blame History