🛡️Proxy Cloud

<img src="assets/images/logo.png" alt="Proxy Cloud Logo" width="150"/> <img src="screenshots/base.jpg" alt="Proxy Cloud Screenshot" width="80%"/> <div align="center"> <img src="https://img.shields.io/github/downloads/code3-dev/ProxyCloud/total?label=Downloads&style=for-the-badge" alt="Downloads Badge"> <img src="https://img.shields.io/github/v/release/code3-dev/ProxyCloud?style=for-the-badge&label=Latest%20Release" alt="Latest Release"> <img src="https://img.shields.io/github/stars/code3-dev/ProxyCloud?style=for-the-badge" alt="Stars"> </div> A modern, feature-rich VPN client that's fast, unlimited, secure, and completely free. <a href="FA.md">فارسی</a> | <a href="ZH.md">中文</a> | <a href="RU.md">Русский</a>

🌟 Why Proxy Cloud?

Proxy Cloud is a cutting-edge VPN solution built with Flutter that offers:

🔒 Military-Grade Security with V2Ray and Xray Core
⚡ Lightning-Fast Connections with global server network
🌍 Multi-Language Support (8+ languages)
💰 100% Free & Open Source - No hidden costs
📱 Beautiful Dark UI with intuitive navigation
🛠️ Advanced Tools for power users

🚀 Overview

Proxy Cloud is a powerful Flutter application designed to provide secure, private internet access through V2Ray VPN technology and Telegram MTProto proxies. With an intuitive dark-themed interface and comprehensive features, Proxy Cloud puts you in control of your online privacy without any subscription fees or hidden costs.

🔧 Core Technologies

Flutter Framework - Cross-platform UI toolkit
Xray Core - Advanced proxy platform for bypassing network restrictions
V2Ray Protocol - Secure and efficient proxy solution
Telegram MTProto - Specialized proxy protocol for Telegram
Provider Package - State management solution
Material 3 Design - Modern UI components and guidelines

✨ Key Features

🔒 V2Ray VPN

One-Tap Connection: Connect to V2Ray servers instantly with a single tap
Subscription Management: Import, organize, and update configurations via subscription URLs
Real-Time Monitoring: Track connection status and performance metrics
Server Selection: Browse and select from multiple server locations
Custom VPN Settings: Configure bypass subnets and DNS options for advanced users

💬 Telegram Proxies

Extensive Proxy Collection: Browse and connect to MTProto proxies from around the world
Detailed Information: View country, provider, ping, and uptime statistics for each proxy
Seamless Integration: One-tap connection to Telegram via selected proxies
Easy Sharing: Copy proxy details to clipboard for sharing with others

🛠️ Advanced Tools

IP Information: View detailed information about your current IP address and location
Host Checker: Test status, response time, and details of any web host
Speed Test: Measure your internet connection download and upload speeds
Subscription Store: Discover and add new V2Ray configurations from a curated collection
Subscription Manager: Add, edit, delete, and update your V2Ray subscriptions in one place

🎨 Modern UI/UX

Sleek Dark Theme: Elegant dark interface with green accents for comfortable viewing
Intuitive Navigation: Bottom navigation bar for easy access to all features
Smooth Animations: Polished transitions and visual effects throughout the app
Real-Time Indicators: Visual feedback on connection status (connected, connecting, disconnected)
Responsive Design: Optimized for various screen sizes and orientations

🌍 Multi-Language Support

Proxy Cloud supports 8+ languages:

English 🇺🇸
Persian (Farsi) 🦁
Chinese 🇨🇳
Russian 🇷🇺
Spanish 🇪🇸
French 🇫🇷
Arabic 🇸🇦
Turkish 🇹🇷

🔧 Advanced Features

Auto-Select Algorithm: Automatically choose the best server based on ping
Per-App Tunneling: Select which apps use the VPN
Battery Optimization: Efficient resource usage
Custom Wallpapers: Personalize your app experience
Ping Testing: Test server responsiveness before connecting

📱 Installation

🤖 Android

| Architecture | Download Link | |-------------|---------------| | Universal | <a href="https://github.com/code3-dev/ProxyCloud/releases/latest/download/proxycloud-universal.apk"><img src="https://img.shields.io/badge/Android-Universal-3DDC84?style=for-the-badge&logo=android&logoColor=white" alt="Android Universal"></a> | | armeabi-v7a | <a href="https://github.com/code3-dev/ProxyCloud/releases/latest/download/proxycloud-armeabi-v7a.apk"><img src="https://img.shields.io/badge/Android-armeabi--v7a-3DDC84?style=for-the-badge&logo=android&logoColor=white" alt="Android armeabi-v7a"></a> | | arm64-v8a | <a href="https://github.com/code3-dev/ProxyCloud/releases/latest/download/proxycloud-arm64-v8a.apk"><img src="https://img.shields.io/badge/Android-arm64--v8a-3DDC84?style=for-the-badge&logo=android&logoColor=white" alt="Android arm64-v8a"></a> | | x86_64 | <a href="https://github.com/code3-dev/ProxyCloud/releases/latest/download/proxycloud-x86_64.apk"><img src="https://img.shields.io/badge/Android-x86_64-3DDC84?style=for-the-badge&logo=android&logoColor=white" alt="Android x86_64"></a> |

💻 Desktop Versions

Windows

macOS

Linux

Arch Linux

ProxyCloud is now on the AUR, therefore you can install it using your prefered AUR helper.

paru -S proxycloud-gui-bin

# or if you are using yay

yay -S proxycloud-gui-bin

📲 Installation Instructions

Android: Download the appropriate APK for your device architecture and install it
Windows: Download the installer or portable version and run it
macOS: Download the .dmg file and drag the app to your Applications folder
Linux: Download the appropriate package for your distribution and install it

👨‍💻 For Developers

🛠️ Prerequisites

Flutter SDK (3.0+)
Dart SDK
Android Studio / VS Code
Android device or emulator

🏗️ Build Steps

Clone the repository:

git clone https://github.com/code3-dev/ProxyCloud.git
cd ProxyCloud

Install dependencies:
```
flutter pub get
```
Run the app in debug mode:
```
flutter run
```
Build release APK:
```
flutter build apk --release
```

📁 Project Structure

lib/
├── main.dart                  # Entry point
├── models/                    # Data models
├── providers/                 # State management
├── screens/                   # UI screens
├── services/                  # Business logic
├── widgets/                   # Reusable components
├── theme/                     # App theme and styling
└── utils/                     # Helper utilities

local_packages/
└── flutter_v2ray_client/      # Custom V2Ray plugin

assets/
├── images/                    # App images
└── languages/                 # Localization files

🎨 UI/UX Design

Proxy Cloud features a modern dark theme with:

Material 3 design principles
Smooth animations and transitions
Intuitive bottom navigation
Real-time connection status indicators
Responsive layout for all screen sizes

📖 Usage Guide

🔧 Setting up V2Ray

Navigate to the VPN tab (home screen)
Tap on "Add Subscription" to enter your subscription URL and name
Wait for the servers to load from your subscription
Select a server from the list
Tap the large connect button to establish a VPN connection

📋 Managing Subscriptions

Go to the Tools tab
Select "Subscription Manager"
Here you can add new subscriptions, edit existing ones, or delete unwanted subscriptions
Use the refresh button to update all subscriptions at once

💬 Using Telegram Proxies

Navigate to the Proxy tab
Browse the list of available MTProto proxies
Tap "Connect" on a proxy to open Telegram with the selected proxy configuration
Alternatively, tap the copy icon to copy the proxy details to manually configure in Telegram

🛒 Exploring the Store

Go to the Store tab
Browse the curated list of V2Ray subscription providers
Tap on any item to view details
Use the "Add" button to quickly add a subscription to your collection

🛠️ Using Tools

Navigate to the Tools tab
Select from various utilities:
- IP Information: Check your current IP address and location details
- Host Checker: Test connectivity to any website or server
- Speed Test: Measure your connection speed
- VPN Settings: Configure advanced options for the VPN connection

⚙️ Advanced Configuration

Auto-Select: Let Proxy Cloud choose the best server automatically
Per-App Tunneling: Control which apps use the VPN
Custom DNS: Set custom DNS servers for better privacy
Bypass Subnets: Configure subnets to bypass the VPN

ProxyCloud

Install / Use

README