使用宝塔（aapanel）部署PPanel（新的机场面板）– 全网首发

写在前面

何为PPanel？
官方原话：PPanel 是一个纯粹、专业且完美的开源代理面板工具，旨在成为您学习和实践的理想选择。
个人理解：全新的机场面板。
机器配置问题

根据自身实力准备机器，这里只是演示的机器配置，你也可以用更低配置的机器，并不是强制要求（不喜勿喷！）

准备工作

云服务器（至少一台带公网IP）
域名

教程中使用的是腾讯云的轻量款新加坡 2C4G，自行准备个机器就行，演示打算all in one,所以就只用一个机器了，正常我觉得应该用多个机器分离式部署更好。另外我计划使用MySql8.x 所以内存最好4G以上吧

域名解析

不管从哪里搞的域名，先将其与你的云服务器IP进行绑定，我使用的是CloudFlare进行域名解析。
file
需要解析三个子域名，前缀随意，我这个只是个示例，根据你的爱好来。
api.dushilaoren.xyz - 服务端
user.dushilaoren.xyz - 用户端
admin.dushilaoren.xyz - 管理端

环境准备

以下只是本次部署的环境：

aapanel
Ubuntu 2404
MySql 8.0+(5.7+就行)
redis 7.0+(6.0+就行)
本教程的环境基于宝塔面板进行部署，毕竟宝塔用着挺简单的，不过这里使用的是海外版(反正大多数人这么叫)-aapanel。

安装aapanel

这个安装很简单，直接使用官方的一键指令就OK，不会有什么问题，有问题就再执行一遍。

URL=https://www.aapanel.com/script/install_7.0_en.sh && if [ -f /usr/bin/curl ];then curl -ksSO "$URL" ;else wget --no-check-certificate -O install_7.0_en.sh "$URL";fi;bash install_7.0_en.sh aapanel aapanel

file
这个提示输入‘Y’确认就可以开始安装了，默默等待几分钟安装完成就行，理论上网速越快安装越快。
file
出现上面那一堆就OK了，用上面的信息登陆aapanel管理台，然后进入下一步安装其他环境

使用aapanel安装剩下的环境

下面都是UI操作，基本上按照来就ok。

安装Nginx 以及 MySql

首次登陆aapanel会有一个弹窗让你选择初始环境
file
只需要勾选图中这两个就行的，注意版本。
如果想要后期通过UI管理数据库可以勾选上另外两个工具
file
PHP版本7.4+就OK。
file
接下来就只需要你的patience等待即可，预计十分钟左右。

安装Redis

Redis需要自行去软件商店安装。首先来到软件商店，然后搜索Redis，最后点击安装
file
默认只有redis7，刚好也是我们需要的
file
静静等待它后台安装完成

安装Supervisor

这个主要用来进程守护，当然也可以用systemd。但是能够UI操作咱们就尽量UI操作
file
和安装redis的流程一样，进行搜索安装即可

安装Node.js

前端需要用nodejs进行托管，首先来到aapanel的website页面。
file
点击安装按钮，它会自动安装node.js管理器。
然后点击nodejs管理器安装nodejs
file
默认的版本比较老，切换到官方源然后更新一下列表
file
咱们选择22.13这个版本
file
安装完成之后记得cli也设置一下
file

创建数据库

这里主要是MySql的，Redis在安装时会自动配置。
file
先到数据库页面然后点击左上角的新增，按照图片中进行操作，注意数据集使用utf8mb4.

至此，环境就大功告成。

部署服务端

接下来就开始我们的主要工作了，首先是下载服务端的二进制文件。

下载文件

下载地址：

https://github.com/perfect-panel/ppanel/releases/download/v0.1.0/ppanel-server-v0.1.0-linux-amd64.tar.gz

将下载好的文件上传到云服务器：
首先创建一个路径/www/wwwroot/ppanel
file
将文件上传到这个路径下
file
点击上传按钮，将文件拖进来，上传完成后解压该文件
file
最好解压完之后改一下权限，返回上一层修改权限。
勾选文件夹，然后右键单击，进入权限菜单
file
设置后点击OK进行应用
file
保持和我的一致就行。

启用程序
启动很简单，使用前面安装好的Supervisor进行管理。
首先来到Supervisor

然后添加一个进程

按照刚刚的文件位置进行填写

Start Command: /www/wwwroot/ppanel/ppanel-server run

这个状态就是成功的
设置反向代理

aapanel的website页面，点击反向代理，创建新的代理
file
接下来会用到之前解析的域名，我这里使用api.dushilaoren.xyz
file
然后申请ssl证书，先点击修改
file
然后跟着我的选，进行申请
file
完成之后如图
file
接下来就可以访问这个域名进行基础配置
file
点击右上角的中文按钮切换到中文页面。
输入邮箱密码以及创建的数据库信息。
file
数据库信息在如上图位置，将它们复制到对应的位置
file
可以在填写完成之后点击测试，redis保持默认信息就行，然后开始初始化即可
file
几秒钟就安装完成。
接下来就是前端部署。

前端部署

前端分为用户端和管理端，首先部署用户端。

部署管理端

下载源码

下载地址：

https://github.com/perfect-panel/ppanel-web/releases/download/v1.0.0-beta.4/ppanel-admin-web.tar.gz

上传源码
和服务端一样，创建一个文件夹然后将代码放进去并解压。

完成上面操作之后如上图，然后修改权限。
由于这些步骤前面提到过就不重复演示。

完成之后如上图
配置环境变量

启动项目之前需要先填写你的基础链接信息，首先来到启动脚本同级的路径，例如我现在的就应该是：/www/wwwroot/ppanel-admin-web/apps/admin
file
图中的.env文件就是需要修改的文件，模版文件如下：

# 应用的默认语言
NEXT_PUBLIC_DEFAULT_LANGUAGE=<您的默认语言 zh-CN | en-US>

# 站点 URL 和 API 端点
NEXT_PUBLIC_SITE_URL=<您的站点 URL>
NEXT_PUBLIC_API_URL=<您的 API URL>

# 支持或咨询的联系邮箱
NEXT_PUBLIC_EMAIL=<您的联系邮箱>

# 社区和社交媒体链接
NEXT_PUBLIC_TELEGRAM_LINK=<您的 Telegram 链接>
NEXT_PUBLIC_TWITTER_LINK=<您的 Twitter 链接>
NEXT_PUBLIC_DISCORD_LINK=<您的 Discord 链接>
NEXT_PUBLIC_INSTAGRAM_LINK=<您的 Instagram 链接>
NEXT_PUBLIC_LINKEDIN_LINK=<您的 LinkedIn 链接>
NEXT_PUBLIC_FACEBOOK_LINK=<您的 Facebook 链接>
NEXT_PUBLIC_GITHUB_LINK=<您的 GitHub 链接>

# 默认用户凭证（用于初始设置或测试目的）
NEXT_PUBLIC_DEFAULT_USER_EMAIL=<您的默认用户邮箱>
NEXT_PUBLIC_DEFAULT_USER_PASSWORD=<您的默认用户密码>

除了上面的内容还有一个地方需要修改，应该是aapanel的bug，node在启动命令的时候无法手动指定端口，因此为了避免后面的用户端面板冲突，所以需要手动修改一下启动文件。
这是我的：

# 应用的默认语言
NEXT_PUBLIC_DEFAULT_LANGUAGE=zh-CN
#<您的默认语言 zh-CN | en-US>

# 站点 URL 和 API 端点
NEXT_PUBLIC_SITE_URL=https://admin.dushilaoren.xyz
NEXT_PUBLIC_API_URL=https://api.dushilaoren.xyz

# 支持或咨询的联系邮箱
NEXT_PUBLIC_EMAIL=tingfeng@pmxu.xyz

# 社区和社交媒体链接
#NEXT_PUBLIC_TELEGRAM_LINK=<您的 Telegram 链接>
#NEXT_PUBLIC_TWITTER_LINK=<您的 Twitter 链接>
#NEXT_PUBLIC_DISCORD_LINK=<您的 Discord 链接>
#NEXT_PUBLIC_INSTAGRAM_LINK=<您的 Instagram 链接>
#NEXT_PUBLIC_LINKEDIN_LINK=<您的 LinkedIn 链接>
#NEXT_PUBLIC_FACEBOOK_LINK=<您的 Facebook 链接>
#NEXT_PUBLIC_GITHUB_LINK=<您的 GitHub 链接>
# 
## 默认用户凭证（用于初始设置或测试目的）
#NEXT_PUBLIC_DEFAULT_USER_EMAIL=<您的默认用户邮箱>
#NEXT_PUBLIC_DEFAULT_USER_PASSWORD=<您的默认用户密码>

file
将.env同级文件server.js的端口从3000改为3001

启动管理端

完成上面操作之后再次回到Website页面添加nodejs项目。
file
然后填写项目信息
file
主要注意项目路径以及自定义命令
例如我的自定义命令：

/www/wwwroot/ppanel-admin-web/apps/admin/server.js

接下来申请SSL证书，同样的点击修改
file
来到SSL管理页面，勾选域名然后申请
file
然后就可以访问域名对管理端进行设置
file
自行根据自己需求进行修改

部署用户端

下载源码

下载地址：

https://github.com/perfect-panel/ppanel-web/releases/download/v1.0.0-beta.4/ppanel-user-web.tar.gz

上传源码

和上面的管理端一样的操作，这里忽略
上传并解压，然后修改权限，完成后如图
file

配置环境变量

用户端和管理端一样，都需要设置环境变量，以及端口修改
模版如下：

# 应用的默认语言
NEXT_PUBLIC_DEFAULT_LANGUAGE=<您的默认语言 zh-CN | en-US>

# 站点 URL 和 API 端点
NEXT_PUBLIC_SITE_URL=<您的站点 URL>
NEXT_PUBLIC_API_URL=<您的 API URL>

# 支持或咨询的联系邮箱
NEXT_PUBLIC_EMAIL=<您的联系邮箱>

# 社区和社交媒体链接
NEXT_PUBLIC_TELEGRAM_LINK=<您的 Telegram 链接>
NEXT_PUBLIC_TWITTER_LINK=<您的 Twitter 链接>
NEXT_PUBLIC_DISCORD_LINK=<您的 Discord 链接>
NEXT_PUBLIC_INSTAGRAM_LINK=<您的 Instagram 链接>
NEXT_PUBLIC_LINKEDIN_LINK=<您的 LinkedIn 链接>
NEXT_PUBLIC_FACEBOOK_LINK=<您的 Facebook 链接>
NEXT_PUBLIC_GITHUB_LINK=<您的 GitHub 链接>

# 默认用户凭证（用于初始设置或测试目的）
NEXT_PUBLIC_DEFAULT_USER_EMAIL=<您的默认用户邮箱>
NEXT_PUBLIC_DEFAULT_USER_PASSWORD=<您的默认用户密码>

这是我的：

# Default Language
NEXT_PUBLIC_DEFAULT_LANGUAGE=zh-CN

# Site URL and API URL
NEXT_PUBLIC_SITE_URL=https://user.dushilaoren.xyz
NEXT_PUBLIC_API_URL=https://api.dushilaoren.xyz

# Contact Email
NEXT_PUBLIC_EMAIL=tingfeng@pmxu.xyz
# Community Links
#NEXT_PUBLIC_TELEGRAM_LINK=https://t.me/ppanel
#NEXT_PUBLIC_TWITTER_LINK=https://github.com/perfect-panel/ppanel-web
#NEXT_PUBLIC_DISCORD_LINK=https://github.com/perfect-panel/ppanel-web
#NEXT_PUBLIC_INSTAGRAM_LINK=https://github.com/perfect-panel/ppanel-web
#NEXT_PUBLIC_LINKEDIN_LINK=https://github.com/perfect-panel/ppanel-web
#NEXT_PUBLIC_FACEBOOK_LINK=https://github.com/perfect-panel/ppanel-web
#NEXT_PUBLIC_GITHUB_LINK=https://github.com/perfect-panel/ppanel-web

# Default Login User
#NEXT_PUBLIC_DEFAULT_USER_EMAIL=admin@ppanel.dev
#NEXT_PUBLIC_DEFAULT_USER_PASSWORD=password

# Please put in the .env file, otherwise the i18n command will not work
# OpenAI API key and proxy URL required for i18n command (optional)
#OPENAI_API_KEY=
#OPENAI_PROXY_URL=

启动用户端程序

和管理端一样的去创建node项目
file
然后用相同的方法创建SSL证书
file

访问你的域名即可正常进入用户端，平时只需要给用户提供用户端域名就好，不要泄露api以及管理端域名
file
不得不说UI确实好看

注意事项

在安装过程中遇到一些小的问题。

aapanel的node项目进程占用问题

在aapanel中部署的node项目，也就是管理端以及用户端无法通过aapanel的UI进行停止或者重启，你停止之后会出现无法启动的问题，主要原因是因为aapanel没有彻底结束这个进程，需要你手动去ssh通过shell命令查询改端口的PID然后杀死进程
ss -tulnp | grep :3000
通过上面的指令找到进程号，然后用下面的指令结束进程
kill -9 331538
file

.env的环境变量中url地址要加上协议

比如NEXT_PUBLIC_SITE_URL=<您的站点 URL>和NEXT_PUBLIC_API_URL=<您的 API URL>需要写成NEXT_PUBLIC_SITE_URL=https://xxxx不能直接只写域名

最后夸赞一波开发者大大真厉害，这个面板真好看呀，希望能赶超其余面板

查看评论 - 6 条评论

Comments 6 条评论

博主 1

回复

发布于 20 天前 ( Chrome 121 Windows 10/11 )( ) 来自: 香港 Kowloon 香港

感谢感谢。
博主 21218776

回复

发布于 10 天前 ( Chrome 131 Windows 10/11 )( ) 来自: 香港 Kowloon 香港

步骤都对了，部署上了但是管理端一到服务管理页面就报错了
- 博主渡世老人
  
  回复
  
  发布于 9 天前 ( Chrome 131 Windows 10/11 )( ) 来自: 香港 Kowloon 香港
  
  @21218776 建议附上截图
博主 aishlai

回复

发布于 7 小时前 ( Chrome 131 macOS Catalina or Higher 10.15.7 )( ) 来自: 香港 Kowloon 香港

第一步初始化服务端后，项目目录里面的配置可以正常生成，配置的数据库中也有内容，Redis中也可以看到数据，但是守护进程无法启动报错如下：{"level":"FATAL","time":"2025-01-29 20:26:38","caller":"internal/main.go:64","message":"init session error","error":"ERR AUTH password called without any password configured for the default user. Are you sure your configuration is correct?"}
- 博主渡世老人
  
  回复
  
  发布于 6 小时前 ( Chrome 131 Android 10 )( ) 来自: 香港 Kowloon 香港
  
  @aishlai 你的服务端配置文件对吗，看提示像是没设置对默认管理员的账号密码
博主 aishlai

回复

发布于 5 小时前 ( Chrome 131 macOS Catalina or Higher 10.15.7 )( ) 来自: 香港 Kowloon 香港

系统版本 Ubuntu 22.04