项目概述
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，只需以下几步即可完成安装和启动，非常适合新手快速上手：
- 下载脚本
可以直接用 wget 下载官方脚本文件：
wget https://raw.githubusercontent.com/w568w/pproxy/main/proxy.sh
如果无法直接访问 GitHub，可使用镜像源（选其一）：
wget https://github.akams.cn/https://raw.githubusercontent.com/w568w/pproxy/main/proxy.sh
- 运行脚本启动服务
执行以下命令即可启动代理与 WebUI：
bash proxy.sh
脚本会自动检测系统环境、下载所需核心（Mihomo）及 Web 前端（metacubexd），并在后台启动，无需任何额外配置。所有相关文件都仅会生成在当前目录下的 ./proxy-data 文件夹中，保证系统整洁。
- 访问 WebUI 进行管理
执行后终端会提示 WebUI 访问地址，默认通常为（请将 <server-ip> 替换为你的服务器 IP）：
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 是一个实用的小型项目，适合追求极简体验和高度自动化的场景。