hi-frontend/docs/zh/index.md

layout, tk, hero, features

layout	tk	hero	features
home	teekHome false	name text tagline actions image PPanel Pure Professional Perfect 以优雅的开源控制平面驾驭任意代理集群 theme text link brand 安装 PPanel /zh/guide/installation/ theme text link alt 项目概览 /zh/guide/intro src alt /logo.svg PPanel	icon title details 🎯 完整的管理功能 在一个控制台内完成服务器接入、节点编排、订阅与产品发布。 icon title details 💼 商务运营工具 优惠券、营销、订单与公告全流程自动化，随时可扩展。 icon title details 👥 用户支持体系 用户目录、工单、文档三位一体，快速响应客户诉求。 icon title details 📊 数据分析 12 种日志维度即刻洞察流量、余额、佣金等核心指标。 icon title details 🔧 灵活配置 支付、认证、广告及系统开关均可配置，无需重新构建。 icon title details 🚀 现代技术栈 React 19 + TypeScript + TailwindCSS + shadcn/ui 带来顺滑体验。 icon title details 🛡️ 稳健后端 go-zero + Gin + Gorm + Asynq 打造的 Go 1.21+ 服务，默认私密。 icon title details 🐳 一体化部署 官方 `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，界面即可直连内置服务。

::: tip Docker 快速启动

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

:::

仓库推荐的配置步骤

1. 复制 modules/<架构>/etc 至持久目录（如 ppanel-config），并更新 ppanel.yaml 与密钥。
2. 先用 docker run 快速验证，再依据仓库提供的 Compose 模板获得自动重启与健康检查。
3. 升级流程：拉取新镜像、重启容器、由 gateway 负责节点热更新。
4. 排障时使用 docker exec -it ppanel /bin/sh 与 docker logs -f ppanel，所有文件均位于 /app。