# pproxy：一键搭建高效代理及WebUI解决方案

**URL:** <https://www.sunai.net/t/topic/985>\
**Category:** IT\
**Tags:** github, web界面, 代理服务, shell脚本\
**Created:** [2025 年7 月 30 日 04:42 UTC](https://www.sunai.net/t/topic/985 "2025-07-30T04:42:09Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

作者： ![sunaibot](https://www.sunai.net/user_avatar/www.sunai.net/sunaibot/32/1427_2.png) [@sunaibot](https://www.sunai.net/u/sunaibot)\
发布日期： [2025 年7 月 30 日 04:42 UTC](https://www.sunai.net/t/topic/985/1 "2025-07-30T04:42:09Z")

</div>

> **[GitHub - w568w/pproxy: 一键脚本 | 在任意服务器上快速启动代理客户端和 WebUI](https://github.com/w568w/pproxy)**
>
> 一键脚本 | 在任意服务器上快速启动代理客户端和 WebUI

## 项目概述

pproxy 是一个面向极简与高效场景设计的代理启动工具，旨在让用户能够在任何服务器上用最少的操作，快速拥有代理客户端和可视化 Web 控制界面。无论是远程运维、临时测试还是个人多端流量中转，只需下载并运行一个 shell 脚本，即可自动完成从依赖检测到最新代理核心与前端的拉取、安装和启动，几乎无需人工干预。

该工具仅依赖 Bash 3.2+ 和基础的 GNU 工具，大大提升了兼容性。不论你是在标准 Linux 发行版，还是 Busybox、Toybox 等精简环境，都能流畅运行。pproxy 的全部运行内容均集中在本地数据目录，绝不生成杂乱文件或者影响系统环境。幕后的 Mihomo 核心与 metacubexd 前端，保障了协议全面与控制便捷。智能测速和镜像下载机制，则有效解决了网络受限情况下的体验瓶颈。支持多次启动不留副作用，用户可随时中断、重新启动，无需担心重复冗余或异常状态。对于追求便捷、可靠、一致性的用户来说，这是一个高效且优雅的代理启动解决方案。

## 项目统计

### 📊 项目概况

⭐ **80** Stars | 🍴 **11** Forks | 👀 **80** Watchers | 🐛 **0** Issues

📅 创建于: 2025-05-12 | 🔄 更新于: 2025-07-29

### 💻 技术栈

该项目主要使用 **Shell** 开发，占代码库的 100.0%

## 核心功能

借助 **pproxy** ，你可以在任意服务器上一键启动强大的代理客户端和可视化 Web 控制面板，无需繁琐操作，简单高效。只需下载一份单文件脚本，直接运行，轻松部署属于自己的代理服务。以下是 pproxy 的核心能力：

- **零负担部署**  
无需克隆完整项目，只需下载 proxy.sh 单文件即可完成代理服务搭建，适合所有喜欢“轻量工具”的技术爱好者。

- **极致兼容性**  
只要你的服务器有 Bash 3.2+、Curl 和最基础的 GNU 工具集（可在 Busybox、Toybox 等极简环境运行），无论是何种系统分发版，都可极速启动，无障碍。

- **极速网络体验**  
内置 GitHub 镜像源及智能测速机制，无需担心因网络环境差异导致下载困难，自动帮你选择最佳下载路径，轻松避开网络封锁和延迟。

- **资料整洁无忧**  
自动将所有相关文件保存在同一目录下的 `./proxy-data` 文件夹中，绝不在你的系统留下杂乱无章的痕迹，保持环境纯净。

- **快速开启先进代理**  
默认集成最新版 Mihomo 核心引擎，支持多协议加速，并配备 metacubexd Web UI，为你带来可视化、易操作的流量管理界面。不仅支持绝大多数常见协议，还能随时切换配置，适应各种网络需求。

- **多次运行、无副作用**  
支持幂等操作，无论执行多少次，都不会重复下载或产生多余后台进程，重启过程安全可靠，让你用得安心。

更多贴心智能和创新特性也在持续开发和完善中，力求为你带来真正“即下即用”的代理神器！

## 技术架构

PProxy 采用简洁高效的技术架构，核心依赖仅为 Bash 3.2+、curl 及 GNU 基础工具集，具备极强的兼容性和可移植性。项目通过 Shell 脚本单文件（proxy.sh）实现自动化的依赖管理与服务部署，用户无需克隆仓库或手动安装环境，即可一键启动代理服务与 Web 管理界面。后端代理核心基于 Mihomo 引擎，兼容 Clash 生态，支持多协议并发及高级流量转发需求；前端则选用 metacubexd 提供现代化的 WebUI 管理界面，便于策略切换与连接管理。

架构层次清晰：Shell 脚本负责智能拉取二进制依赖（含镜像源与网络状况检测），并自动化配置启动。所有运行数据隔离存储于同一目录下的 proxy-data，确保幂等、安全与易于运维。核心设计理念强调“零侵入”，即不对系统做任何假设或污染，真正实现即插即用。技术流程大致为：本地运行 proxy.sh → 拉取/检查 Mihomo 与 metacubexd → 启动服务端口 → 提供 WebUI 入口。整体架构追求极简、健壮与高度兼容，适合各类场景的快速部署与自动化运维。

## 使用指南

要在服务器上快速部署代理客户端和 WebUI，只需以下几步即可完成安装和启动，非常适合新手快速上手：

1. **下载脚本**

可以直接用 `wget` 下载官方脚本文件：

```bash
wget https://raw.githubusercontent.com/w568w/pproxy/main/proxy.sh

```

如果无法直接访问 GitHub，可使用镜像源（选其一）：

```bash
wget https://github.akams.cn/https://raw.githubusercontent.com/w568w/pproxy/main/proxy.sh

```

1. **运行脚本启动服务**

执行以下命令即可启动代理与 WebUI：

```bash
bash proxy.sh

```

脚本会自动检测系统环境、下载所需核心（Mihomo）及 Web 前端（metacubexd），并在后台启动，无需任何额外配置。所有相关文件都仅会生成在当前目录下的 `./proxy-data` 文件夹中，保证系统整洁。

1. **访问 WebUI 进行管理**

执行后终端会提示 WebUI 访问地址，默认通常为（请将 `<server-ip>` 替换为你的服务器 IP）：

```auto
http://<server-ip>:9091/ui

```

建议开放防火墙端口 `9091`，然后用浏览器访问此地址。WebUI 提供了完整的代理配置、协议管理等界面，操作简单，配置直观。

**注意事项**

- 支持多种 Linux 发行版（包括 Busybox、Toybox 环境），仅需 Bash 3.2+ 和常用的 \*nix 工具集及 curl。
- 多次运行脚本不会重复启动服务，支持 Ctrl+C 中断和随时重启。
- 更改配置后，直接在 WebUI 中保存并重启代理即可，无需再次运行脚本。

现在，你已经拥有了一个即开即用、功能完整的代理服务环境！

## 总结评价

pproxy 项目以极简单文件和最小依赖为核心，实现了在多种 Linux 环境中一键部署代理客户端与 WebUI，对于需要快速搭建代理服务的用户具有实际价值。其无需繁琐配置、自动化管理 Mihomo 与 metacubexd 内核的做法，提升了易用性和可维护性。采用幂等设计和严格目录管控，进一步保证了脚本的安全与清洁。尽管当前项目热度（80 Stars）尚属早期，社区反馈有限，但其高度的兼容性和便携特性为跨平台用户提供了便利。建议有轻量、快速需求的运维或开发人员尝试使用，并关注脚本兼容性与长期维护情况。若未来能增强配置灵活性与社区参与，将有望吸引更多用户，推动生态建设。总体来看，pproxy 是一个实用的小型项目，适合追求极简体验和高度自动化的场景。
