PPanel

🎯

完整的管理功能

在一个控制台内完成服务器接入、节点编排、订阅与产品发布。

💼

商务运营工具

优惠券、营销、订单与公告全流程自动化，随时可扩展。

👥

用户支持体系

用户目录、工单、文档三位一体，快速响应客户诉求。

📊

数据分析

12 种日志维度即刻洞察流量、余额、佣金等核心指标。

🔧

灵活配置

支付、认证、广告及系统开关均可配置，无需重新构建。

🚀

现代技术栈

React 19 + TypeScript + TailwindCSS + shadcn/ui 带来顺滑体验。

🛡️

稳健后端

go-zero + Gin + Gorm + Asynq 打造的 Go 1.21+ 服务，默认私密。

🐳

一体化部署

官方 `ppanel/ppanel` 镜像内置 gateway 与 server，支持 amd64/arm64。

全栈一览

PPanel 由三个协同仓库组成：

前端：React 19 UI + VitePress 文档，同时覆盖管理端与用户端。

PPanel Server：Go 1.21+ API，兼顾隐私、可观测性与多协议调度。

ppanel：打包 gateway 与后端二进制的 Docker 镜像，一条命令即可启动。

前端体验

响应式仪表盘、细粒度权限与实时指标支撑全角色协作。

shadcn/ui + TailwindCSS 组件体系让管理端与用户端保持统一视觉。

产品与文档同源，交付团队始终参考最新部署指引。

后端基石

统一调度 Shadowsocks、V2Ray、Trojan、Trojan-Go 等协议，接口由 go-zero 生成。

节点全生命周期：心跳、注册、版本检测、滚动升级一步到位。

订阅、计费、支付、订单与工单等业务域与前端配置保持一一映射。

默认不开启用户日志，所有敏感配置集中在 etc/ppanel.yaml 中可审计。

多样交付形态：Go 二进制、Makefile 目标以及 ppanel/ppanel-server:latest 等 CI 镜像。

Gateway 与部署

ppanel/ppanel 镜像同时打包 gateway 与后端（amd64/arm64），将仓库中的 modules/<platform>/etc 挂载至 /app/etc，界面即可直连内置服务。

Docker 快速启动

bash

docker pull ppanel/ppanel:latest
docker run -d --name ppanel \
  -p 8080:8080 \
  -v $(pwd)/ppanel-config:/app/etc \
  ppanel/ppanel:latest

仓库推荐的配置步骤

复制 modules/<架构>/etc 至持久目录（如 ppanel-config），并更新 ppanel.yaml 与密钥。

先用 docker run 快速验证，再依据仓库提供的 Compose 模板获得自动重启与健康检查。

升级流程：拉取新镜像、重启容器、由 gateway 负责节点热更新。

排障时使用 docker exec -it ppanel /bin/sh 与 docker logs -f ppanel，所有文件均位于 /app。