P-BOX

KO | EN

gitlite — search

#python #hacktoberfest #react #golang #android #rust #deep-learning #nodejs #java #awesome #cli #kubernetes #security #open-source

(★ 9)

Professional, modern, and high-performance proxy management platform supporting 18+ protocols, transparent proxying, inbound services, tunnel management, WireGuard, and cloud-native integrations.

P-BOX Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 🚀 P-BOX

**A Modern Cross-Platform Proxy Management Panel**

Powered by Mihomo (Clash.Meta) Core | Elegant Web UI | One-Click Deployment

[![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://raw.githubusercontent.com/dl185/P-BOX/main/LICENSE)
[![Go](https://img.shields.io/badge/Go-1.21+-00ADD8?logo=go)](https://go.dev)
[![React](https://img.shields.io/badge/React-18-61DAFB?logo=react)](https://react.dev)
[![TypeScript](https://img.shields.io/badge/TypeScript-5-3178C6?logo=typescript)](https://typescriptlang.org)

</div>

---

## ✨ Features

- 🎨 **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

## 📸 Screenshots

<details>
<summary>Click to expand screenshots</summary>

</details>

## 🚀 Quick Start

### Linux One-Click Install (Recommended)

```bash
curl -fsSL https://raw.githubusercontent.com/star8618/P-BOX/main/install.sh | sudo bash
```

The 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**

### Manual Installation

Download pre-built binaries from the [Releases](../../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` |

```bash
# Extract and run
tar -xzf p-box-*.tar.gz
cd p-box-*
./p-box
```

Visit http://localhost:8383 to access the panel.

### Local Development & Installation

To run P-BOX from source or contribute to development:

#### 📋 Prerequisites
- **Go** 1.21 or higher
- **Node.js** 18 or higher
- **npm** (comes with Node.js)

#### 🔨 Step-by-Step Setup
1. **Clone the repository:**
   ```bash
   git clone https://github.com/star8618/P-BOX.git
   cd P-BOX
   ```

2. **Initialize Data Directory:**
   ```bash
   mkdir -p data/configs data/cores data/logs
   ```

3. **Setup Backend:**
   ```bash
   cd backend
   go mod tidy
   go build -o p-box .
   cd ..
   ```

4. **Setup Frontend:**
   ```bash
   cd frontend
   npm install
   cd ..
   ```

#### 🚀 Running the App
The easiest way is to use the provided startup script:
```bash
chmod +x start-all.sh
./start-all.sh
```
Follow the prompts to choose **Development Mode** (1) or **Production Mode** (2).

- **Frontend**: http://localhost:5173
- **Backend**: http://localhost:8383

## 📁 Project Structure

```
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
```

## 🛠️ Tech Stack

## ⚙️ Configuration

A default configuration file `data/config.yaml` is generated on the first run:

```yaml
# 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"
```

## 🤝 Contributing

Pull Requests and Issues are welcome!

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

## 📜 License

This project is licensed under the [MIT License](LICENSE).

## 🙏 Acknowledgments

- [Mihomo](https://github.com/MetaCubeX/mihomo) - High-performance proxy core
- [Clash](https://github.com/Dreamacro/clash) - Original Clash core
- [Sing-box](https://github.com/SagerNet/sing-box) - The universal proxy platform
- [React](https://react.dev) - Frontend framework
- [Tailwind CSS](https://tailwindcss.com) - CSS framework

---

**If you find this project helpful, please give it a ⭐️ Star!**

</div>

P-BOX

P-BOX Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

P-BOX

P-BOX Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README