A Modern Cross-Platform Proxy Management Panel
Powered by Mihomo (Clash.Meta) Core | Elegant Web UI | One-Click Deployment
- 🎨 Modern UI - Beautiful Apple Glass style design with dark/light themes
- ��️ Cross-Platform - Supports macOS, Windows, Linux (OpenWrt NOT supported)
- 🔧 System Proxy - Auto-configure system proxy (macOS/Windows), no manual setup needed
- 📊 Real-time Dashboard - Traffic stats, connection monitoring, exit IP display
- 📦 Subscription Management - Multiple subscription sources with one-click update
- �� Core Management - Auto version detection, one-click download and install
- ⚡ Config Generator - Visual rule configuration with smart routing
- 🌐 i18n - Chinese/English language support
- 🔐 Authentication - Built-in login system to protect the panel
Click to expand screenshots
| Dashboard | Proxy Groups |
|---|---|
| Real-time traffic monitoring | Node selection & speed test |
| Subscriptions | Core Management |
|---|---|
| Multi-source management | Auto version detection |
curl -fsSL https://raw.githubusercontent.com/star8618/P-BOX/main/install.sh | sudo bashThe script will:
- Detect system architecture automatically (amd64/arm64)
- Download the latest stable release
- Install to
/etc/p-box - Create a systemd service for auto-start
- Configure Nginx reverse proxy
- Start the service on port 8666
Download pre-built binaries from the Releases page:
| Platform | File |
|---|---|
| macOS Apple Silicon | p-box-darwin-arm64.tar.gz |
| macOS Intel | p-box-darwin-amd64.tar.gz |
| Linux x64 | p-box-linux-amd64.tar.gz |
| Linux ARM64 | p-box-linux-arm64.tar.gz |
| Windows x64 | p-box-windows-amd64.zip |
# Extract and run
tar -xzf p-box-*.tar.gz
cd p-box-*
./p-boxVisit http://localhost:8383 to access the panel.
To run P-BOX from source or contribute to development:
- Go 1.21 or higher
- Node.js 18 or higher
- npm (comes with Node.js)
-
Clone the repository:
git clone https://github.com/star8618/P-BOX.git cd P-BOX -
Initialize Data Directory:
mkdir -p data/configs data/cores data/logs
-
Setup Backend:
cd backend go mod tidy go build -o p-box . cd ..
-
Setup Frontend:
cd frontend npm install cd ..
The easiest way is to use the provided startup script:
chmod +x start-all.sh
./start-all.shFollow the prompts to choose Development Mode (1) or Production Mode (2).
- Frontend: http://localhost:5173
- Backend: http://localhost:8383
p-box/
├── backend/ # Go Backend
│ ├── main.go # Entry point
│ ├── server/ # HTTP server
│ ├── modules/ # Feature modules
│ └── data/ # Runtime data
├── frontend/ # React Frontend
│ ├── src/ # Source code
│ └── public/ # Static assets
├── data/ # App data (configs, cores, rules)
├── build.sh # Multi-platform build script
├── install.sh # Linux installer script
└── start-all.sh # Development startup script
| Backend | Frontend |
|---|---|
| Go 1.21+ | React 18 |
| Gin | Vite 5 |
| WebSocket | TypeScript |
| YAML | Tailwind CSS |
| Zustand | |
| i18next |
A default configuration file data/config.yaml is generated on the first run:
# Server port (Linux default: 8666, others: 8383)
port: 8383
# Proxy port
mixedPort: 7890
# API secret (optional)
secret: ""
# Transparent proxy mode: off, tun, tproxy
transparentMode: "off"Pull Requests and Issues are welcome!
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m "Add amazing feature") - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License.
- Mihomo - High-performance proxy core
- Clash - Original Clash core
- Sing-box - The universal proxy platform
- React - Frontend framework
- Tailwind CSS - CSS framework
If you find this project helpful, please give it a ⭐️ Star!