简介
欢迎使用 PPanel！这是一个纯粹、专业、完美的开源代理面板工具，旨在为用户提供完整的管理解决方案。
什么是 PPanel？
PPanel 是一个现代化的代理面板系统，采用前后端分离架构，提供完整的用户管理、订阅服务、订单管理、节点管理等功能。无论您是个人用户还是企业用户，PPanel 都能满足您的需求。
核心特性
- 🎯 完整管理: 服务器管理、节点配置、订阅系统、产品管理等
- 💼 商务运营: 订单管理、优惠券系统、营销活动、公告发布
- 👥 用户支持: 用户管理、工单系统、文档中心，提供全方位用户服务
- 📊 数据分析: 12 种类型日志，全面的流量、余额、佣金数据分析
- 🔧 灵活配置: 支付配置、认证控制、广告管理，灵活的系统选项
- 🚀 现代技术栈: 基于 React 19 + TypeScript + TailwindCSS + shadcn/ui 构建
术语说明
PPanel 的一些术语与其他面板系统存在差异，为确保您能准确理解文档内容并避免误解，建议在阅读前先了解以下术语：
用户端
为最终用户提供的界面，用户通过该界面与系统进行交互。您可以根据需求自定义或重构该界面，实现站点的个性化定制。
管理端
用于管理员操作的界面，负责管理系统、用户及数据。您可以根据需求对该界面进行定制或重构，以适应您的管理需求。
服务端
PPanel 的 API 层，处理与前端的所有数据交互，负责业务逻辑的执行与数据服务的提供。
节点端
负责 PPanel 服务端与各节点（落地端）的通信，确保网络节点的连接与服务的稳定性。
客户端
用户用来连接系统的应用程序，通常是指用户的设备端软件或应用，负责与系统建立连接并使用相关服务。
项目架构
PPanel 采用 Monorepo 架构，便于统一管理和维护：
前端应用
- apps/admin: 管理后台应用，提供完整的后台管理功能
- apps/user: 用户端应用，为最终用户提供服务界面
共享包
- packages/ui: 共享 UI 组件库，包含所有可复用的 UI 组件
- packages/typescript-config: 统一的 TypeScript 配置
技术栈
- 框架: React 19 + TypeScript
- 路由: TanStack Router
- 状态管理: Zustand
- 样式: TailwindCSS 4.0
- UI 组件: shadcn/ui
- 构建工具: Vite + Turbo
- 代码规范: Biome
- Git 规范: Lefthook + Gitmoji
主要功能
运维管理
- 服务器管理
- 节点管理
- 订阅配置
- 产品管理
商务管理
- 订单管理
- 优惠券管理
- 营销管理
- 公告管理
用户与支持
- 用户管理
- 工单系统
- 文档管理
系统管理
- 系统配置
- 认证控制
- 支付配置
- 广告配置
日志与分析
- 完整的操作日志记录
- 流量统计分析
- 财务数据追踪