FRPC GUI

Cross-platform FRP Client GUI Manager

A modern, user-friendly GUI application for managing FRP (Fast Reverse Proxy) clients across multiple platforms.

English | 简体中文

Features

• Cross-platform Support: Works on macOS, Windows, and Linux
• Intuitive Dashboard: Visual interface for managing all your FRP tunnels
• Easy Configuration: Import and manage FRP configurations with a clean UI
• Real-time Logs: Monitor your FRP client activity with built-in log viewer
• Flexible Settings: Customize FRP server settings and client options
• TOML Support: Native support for FRP TOML configuration files

Screenshots

Dashboard

Manage and monitor all your FRP tunnels in one place

Settings

Configure FRP server connection and client settings

Import Configuration

Easily import existing FRP configuration files

Log Viewer

View real-time logs from your FRP client

Installation

Download Pre-built Binaries

You can download the latest release from the Releases page.

• macOS: Download .dmg or .zip file
• Windows: Download .exe installer or .zip archive

macOS Gatekeeper Notice

Since the application is not signed with an Apple Developer certificate, macOS may show a warning that the app is "damaged" or "can't be opened". To fix this, run the following command in Terminal after installation:

# For .app installed from DMG
sudo xattr -rd com.apple.quarantine /Applications/FRPC\ GUI.app

# Or for the app extracted from ZIP (adjust the path as needed)
sudo xattr -rd com.apple.quarantine /path/to/FRPC\ GUI.app

Alternatively, you can build from source to avoid this issue.

Build from Source

# Clone the repository
git clone https://github.com/hidumou/frpc-gui.git
cd frp-gui

# Install dependencies
pnpm install

# Build the application
pnpm electron:build

The built application will be in the release directory.

Usage

1. Launch the Application: Open FRPC GUI after installation
2. Configure Server: Add your FRP server address and port in Settings
3. Import Configuration: Import your existing frpc.toml configuration file
4. Start Tunnels: Enable and manage your tunnels from the dashboard
5. Monitor Logs: View real-time logs to troubleshoot any issues

Development

# Install dependencies
pnpm install

# Start development server
pnpm dev

# Build for production
pnpm build

Requirements

• Node.js: >= 18.0.0
• pnpm: >= 8.0.0

Technology Stack

• Electron: Cross-platform desktop application framework
• React: UI library
• Vite: Build tool and dev server
• TypeScript: Type-safe JavaScript
• Tailwind CSS: Utility-first CSS framework
• Radix UI: Accessible UI component library
• i18next: Internationalization framework

License

MIT License - see LICENSE file for details

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Support

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

Acknowledgments

• FRP - Fast Reverse Proxy
• Electron - Cross-platform desktop framework