https://github.com/hidumou/frpc-gui
A modern, user-friendly GUI application for managing FRP (Fast Reverse Proxy) clients across multiple platforms.
https://github.com/hidumou/frpc-gui
frp frpc gui
Last synced: about 1 month ago
JSON representation
A modern, user-friendly GUI application for managing FRP (Fast Reverse Proxy) clients across multiple platforms.
- Host: GitHub
- URL: https://github.com/hidumou/frpc-gui
- Owner: hidumou
- License: mit
- Created: 2025-12-31T15:31:51.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-01-09T07:02:13.000Z (5 months ago)
- Last Synced: 2026-01-13T19:44:29.763Z (5 months ago)
- Topics: frp, frpc, gui
- Language: TypeScript
- Homepage:
- Size: 3.21 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# FRPC GUI
**Cross-platform FRP Client GUI Manager**
A modern, user-friendly GUI application for managing FRP (Fast Reverse Proxy) clients across multiple platforms.
[](https://github.com/hidumou/frpc-gui/releases)
[](LICENSE)
[](https://github.com/hidumou/frpc-gui/releases)
[](https://github.com/hidumou/frpc-gui/stargazers)
[](https://github.com/hidumou/frpc-gui/issues)
[English](./README.md) | [简体中文](./README_zh-CN.md)
## 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](https://github.com/hidumou/frpc-gui/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:
```bash
# 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
```bash
# 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
```bash
# 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](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](https://github.com/hidumou/frpc-gui/issues) on GitHub.
## Acknowledgments
- [FRP](https://github.com/fatedier/frp) - Fast Reverse Proxy
- [Electron](https://www.electronjs.org/) - Cross-platform desktop framework