Skip to content

code3-dev/ProxyCloud

Repository files navigation

🛡️Proxy Cloud

Proxy Cloud Logo

Proxy Cloud Screenshot

Downloads Badge Latest Release Stars

A modern, feature-rich VPN client that's fast, unlimited, secure, and completely free.

فارسی | 中文 | Русский

🌟 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 Android Universal
armeabi-v7a Android armeabi-v7a
arm64-v8a Android arm64-v8a
x86_64 Android x86_64

💻 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

  1. Android: Download the appropriate APK for your device architecture and install it
  2. Windows: Download the installer or portable version and run it
  3. macOS: Download the .dmg file and drag the app to your Applications folder
  4. 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

  1. Clone the repository:

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

    flutter pub get
  3. Run the app in debug mode:

    flutter run
  4. 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

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

📋 Managing Subscriptions

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

💬 Using Telegram Proxies

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

🛒 Exploring the Store

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

🛠️ Using Tools

  1. Navigate to the Tools tab
  2. 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

🤝 Contributing

We welcome contributions to make Proxy Cloud even better! Here's how you can help:

🚀 Getting Started

  1. Fork the repository
  2. Create your feature branch: git checkout -b feature/amazing-feature
  3. Commit your changes: git commit -m 'Add some amazing feature'
  4. Push to the branch: git push origin feature/amazing-feature
  5. Open a Pull Request

📋 Contribution Guidelines

  • Please read CONTRIBUTING.md for details on our code of conduct
  • Ensure your code follows the project's coding standards
  • Write clear commit messages
  • Test your changes thoroughly
  • Update documentation as needed

🐛 Reporting Issues

  • Use the GitHub issue tracker to report bugs
  • Provide detailed information about the issue
  • Include steps to reproduce when possible
  • Add screenshots if relevant

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

📜 Legal

⚠️ Disclaimer

Proxy Cloud is provided as-is without warranties of any kind. Users are responsible for:

  • Complying with local laws and regulations
  • Using the software responsibly
  • Understanding the risks associated with VPN usage
  • Ensuring they have the right to access content through the service

🌟 Star History

Star History Chart

Star us on GitHub to show your support! ⭐

📞 Support

If you encounter any issues or have questions, please open an issue on our GitHub repository.

💬 Community

  • Join our Telegram channel for updates and discussions
  • Participate in GitHub discussions
  • Share your feedback and suggestions

🐛 Bug Reports

  • Check existing issues before creating a new one
  • Provide detailed information about the bug
  • Include steps to reproduce when possible
  • Add screenshots or logs if relevant

🙏 Acknowledgements

🏗️ Core Technologies

  • Flutter - UI toolkit for building natively compiled applications
  • Xray Core - A platform for building proxies to bypass network restrictions
  • AndroidLibV2rayLite - Android library for Xray core
  • Provider - State management solution

🎨 Design & UI

  • Material Design 3 guidelines
  • Google Fonts for typography
  • Custom animations and transitions

❤️ Special Thanks

  • All contributors who have helped shape this project
  • Our amazing user community
  • Open source community for inspiration

💖 Support Development

If you find Proxy Cloud useful, please consider supporting the development:

Cryptocurrency & Bitcoin donation button by NOWPayments

🎯 How You Can Help

  • Star the project on GitHub
  • Share with friends and colleagues
  • Report bugs and suggest features
  • Contribute code improvements
  • Translate to more languages
  • Donate to support ongoing development

Developed by Hossein Pira
Fast, Unlimited, Safe and Free

Report BugRequest FeatureContact Developer