快速入狱教程|使用1panel+docker部署PPanel面板

1 重要提醒
2 啥是PPanel
3 术语说明
4 部署方式
5 准备环境
6 数据库
7 服务端和前端（管理端和用户端）
8 docker compose
9 反代
10 初始化
11 面板外观
12 面板设置
13 最后
14 references

重要提醒

本教程仅作交流学习使用，请勿用作非法用途。

啥是PPanel

之前我们写过一篇入狱教程：入狱教程|使用aapanel(宝塔)搭建v2board分支版并下发hysteria2和reality节点|开启webman支持

现在来了更快速入狱教程了，哈哈……

PPanel 是一个纯粹、专业且完美的开源代理面板工具，旨在成为您学习和实践的理想选择。

大白话：一个新的鸡场面板……具体可查看官方文档

术语说明

PPanel 的一些术语与其他面板系统存在差异，为确保您能准确理解文档内容并避免误解，建议在阅读前先了解以下术语：

用户端 为最终用户提供的界面，用户通过该界面与系统进行交互。您可以根据需求自定义或重构该界面，实现站点的个性化定制。
管理端 用于管理员操作的界面，负责管理系统、用户及数据。您可以根据需求对该界面进行定制或重构，以适应您的管理需求。
服务端 PPanel 的 API 层，处理与前端的所有数据交互，负责业务逻辑的执行与数据服务的提供。
节点端 负责 PPanel 服务端与各节点（落地端）的通信，确保网络节点的连接与服务的稳定性。
客户端 用户用来连接系统的应用程序，通常是指用户的设备端软件或应用，负责与系统建立连接并使用相关服务。

部署方式

PPanel支持多种部署方式，可以借助1panel和aapanel等面板，也可以自己手搓，官方还提供一键脚本，甚至还有第三方一键docker脚本，连nginx反代都直接给你搞好……如果从大类来分，可以分为docker部署和和非docker部署。docker部署的话，可以配合Nginx手搓反代，也可借助1panel和aapanel等面板。非docker部署的话，又可分为Nginx + Supervisor + Node.js和Nginx + Supervisor + Bun。总之部署方式非常多样。

最方便的肯定是直接一键脚本，然后反代下，但是这样就失去了折腾的意义，所以小白今天用的1panel面板，我的想法是把数据库放在1panel面板，其他东西直接docker compose拉取，毕竟docker的数据库，小白太水了，玩不转……所以我们用1panel部署MySQL和redis，然后用PPanel官方自带的docker compose部署服务端（ppanel-server）、管理端（ppanel-admin-web）、用户端（ppanel-user-web）。

准备环境

一个vps：

公网ip:22.22.22.22

⼀个域名: userdomain.com

将以下二级域名解析至你的VPS:

api.userdomain.com: api接口地址, 用于前端请求后端服务

user.userdomain.com: 前端用户页面

admin.userdomain.com: 前端管理面板地址

数据库

1panel的安装直接参考官方文档，这里我们就不再赘述了。我们进入1panel应用商店，需要安装这三个应用：OpenResty 、MySQL、Redis。

这里需要注意的是，docker compose部署服务端（ppanel-server）、管理端（ppanel-admin-web）、用户端（ppanel-user-web）和1panel的应用不在同一个docker网络，所以MySQL和Redis需要放行端口外部访问。

然后我们进入1panel的数据库，新建一个数据库。

服务端和前端（管理端和用户端）

我们在/opt/目录下新建一个ppanel文件夹，然后把ppanel-script的安装脚本git clone下来。

mkdir -p /opt/ppanel && cd /opt/ppanel
git clone https://github.com/perfect-panel/ppanel-script.git

接下来我们需要对ppanel-script主目录下的docker-compose.yml文件做一些修改，简单起见，我们能够UI操作咱们就尽量UI操作，直接使用1panel的文件管理功能，双击修改。

原版docker-compose.yml长这样：

version: '3.8'

services:
  ppanel-server:
    image: ppanel/ppanel-server:beta
    container_name: ppanel-server-beta
    ports:
      - '8080:8080'
    volumes:
      - ./config/ppanel.yaml:/app/etc/ppanel.yaml
    restart: always
    depends_on:
      mysql:
        condition: service_healthy
      redis:
        condition: service_healthy
    networks:
      - ppanel-network

  mysql:
    image: mysql:8.0.23
    container_name: mysql_db
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: rootpassword
      MYSQL_DATABASE: my_database
      MYSQL_USER: user
      MYSQL_PASSWORD: userpassword
    ports:
      - "3306:3306"
    volumes:
      - ./docker/mysql:/var/lib/mysql
    command: --default-authentication-plugin=mysql_native_password --bind-address=0.0.0.0
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-uroot", "-prootpassword"]
      interval: 10s
      timeout: 5s
      retries: 3
    networks:
      - ppanel-network

  redis:
    image: redis:7
    container_name: redis_cache
    restart: always
    ports:
      - "6379:6379"
    volumes:
      - ./docker/redis:/data
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 10s
      timeout: 5s
      retries: 3
    networks:
      - ppanel-network

  ppanel-admin-web:
    image: ppanel/ppanel-admin-web:latest
    container_name: ppanel-admin-web
    restart: always
    ports:
      - '3000:3000'
    environment:
      # Replace with actual API endpoint if needed
      NEXT_PUBLIC_API_URL: https://api.example.com

  ppanel-user-web:
    image: ppanel/ppanel-user-web:latest
    container_name: ppanel-user-web
    restart: always
    ports:
      - '3001:3000'
    environment:
      # Replace with actual API endpoint if needed
      NEXT_PUBLIC_API_URL: https://api.example.com

networks:
  ppanel-network:
    driver: bridge

由于我们的mysql和redis是用1panel安装的，所以我们ppanel-server容器的这两个依赖删掉，然后把docker-compose.yml里mysql和redis这两个容器也删掉，删掉这三个部分：

删完之后是不是简洁了很多。然后我们需要在yml文件里增加几个简单的环境变量，主要是站点的语言和域名。

version: '3.8'

services:
  ppanel-server:
    image: ppanel/ppanel-server:beta
    container_name: ppanel-server-beta
    ports:
      - '8080:8080'
    volumes:
      - ./config/ppanel.yaml:/app/etc/ppanel.yaml
    restart: always
    networks:
      - ppanel-network

  ppanel-admin-web:
    image: ppanel/ppanel-admin-web:latest
    container_name: ppanel-admin-web
    restart: always
    ports:
      - '3000:3000'
    environment:
      # Replace with actual API endpoint if needed
      NEXT_PUBLIC_DEFAULT_LANGUAGE: zh-CN
      NEXT_PUBLIC_SITE_URL: https://admin.userdomain.com
      NEXT_PUBLIC_API_URL: https://api.userdomain.com

  ppanel-user-web:
    image: ppanel/ppanel-user-web:latest
    container_name: ppanel-user-web
    restart: always
    ports:
      - '3001:3000'
    environment:
      # Replace with actual API endpoint if needed
      NEXT_PUBLIC_DEFAULT_LANGUAGE: zh-CN
      NEXT_PUBLIC_SITE_URL: https://user.userdomain.com
      NEXT_PUBLIC_API_URL: https://api.userdomain.com

networks:
  ppanel-network:
    driver: bridge

然后，PPanel 支持基于 Web 的初始化，简化了手动配置过程，所以我们进入config目录，把ppanel.yaml的文件内容全都删掉，但是保留文件，这样我们就能通过 Web 界面初始化了。