<div align="center">

🌐 IRBox Client

A versatile and secure proxy client built with modern technologies to provide seamless and reliable internet connectivity

Designed for privacy-conscious users, IRBox offers multi-protocol support, advanced routing capabilities, and intuitive management tools to ensure a smooth and secure browsing experience.

Farsi Version

</div>

🚀 Key Features

Multi-Protocol Support

• VLESS
• VMess
• Shadowsocks
• Trojan
• Hysteria2
• TUIC
• SSH
• WireGuard

Advanced Management

• Subscription Support - Import and auto-update subscription URLs
• Routing Rules - Domain-based rules (proxy/direct/block) with presets for ad blocking and regional bypass
• Split Tunneling - Choose default route: proxy all traffic or selected domains

Connection Modes

• System Proxy - HTTP proxy for system-wide access
• TUN Mode - Full VPN capturing all traffic
• Admin Elevation - One-click "Run as Administrator" for TUN mode

User Experience

• Onboarding - Interactive guided tour for first-time users
• TCP Ping - Bulk server latency testing
• Auto-select Best Server - Intelligent server selection
• Themes - 2 color themes (Dark, Light)
• Styles - Default, Minimal

🎁 Gift: Free Xray / sing-box Configs

As a small gift to the community, IRBox provides a free public subscription compatible with Xray and sing-box clients.

🔗 Subscription URL:

https://raw.githubusercontent.com/frank-vpl/servers/refs/heads/main/irbox

🛠️ Installation

Prerequisites

• Rust and Cargo
• Tauri CLI
• NodeJS and NPM
• Tauri prerequisites

Quick Setup

1. Clone the repository

   git clone https://github.com/frank-vpl/IRBox.git
   cd IRBox
   

2. Install dependencies

   npm install
   

3. Install Tauri CLI

   cargo install tauri-cli --version ^2
   

4. Download cores

   Windows:

   ./cores.bat
   

   Linux/macOS:

   chmod +x cores.sh
   ./cores.sh
   

🚀 Usage

Development

cargo tauri dev

Production

cargo tauri build

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

📄 License

This project is licensed under the GNU General Public License v3.0 (GPL-3.0) - see the LICENSE file for details.

Core Technologies

IRBox leverages the power of two leading proxy technologies:

<div align="center">

| Core | Description | |------|-------------| | Xray-core | A platform for building proxies to bypass network restrictions | | sing-box | The universal proxy platform |

</div>

Licenses of Third-Party Libraries

• Rust - License
• Tauri - License
• sing-box - License
• Xray-core - License

🙏 Acknowledgments

• Built with Tauri - Framework for building secure native apps
• Powered by sing-box and Xray-core
• Inspired by the need for secure and flexible VPN solutions

📚 Documentation

IRBox Documentation

🎨 Design Assets

<div align="center">

App Logo & Icons

• Icons by Hossein Pira – PiraIcons - License

</div>

🧩 Technologies Used

<div align="center">

Frontend Dependencies

Framework & Core

</div>

Dependencies

• react - A JavaScript library for building user interfaces
• react-dom - Provides DOM-specific methods that can be used at the top level of your app
• @tauri-apps/api - Tauri API bindings
• @tauri-apps/plugin-deep-link - Tauri plugin for deep linking
• @tauri-apps/plugin-shell - Tauri plugin for shell operations

Development Dependencies

• typescript - TypeScript is a typed superset of JavaScript that compiles to plain JavaScript
• vite - Next generation frontend tooling
• @vitejs/plugin-react - Vite plugin for React projects
• @tauri-apps/cli - Tauri Command Line Interface
• @types/react - Type definitions for React
• @types/react-dom - Type definitions for ReactDOM