cPanel面板应用程序管理器允许使用 Phusion Passenger® 应用程序服务器部署应用程序。Phusion Passenger 服务器具有进程管理器和反向代理的功能，并为用户提供操作工具。本教程主要介绍cPanel面板如何创建应用程序和相关教程。
注意：本教程适用于 112 至最新版本。
该界面适用于运行 Apache 和 NGINX® 的服务器。
一、要求
主机提供商必须在 WHM 的功能管理器界面中选择应用程序管理器功能，并根据操作系统安装以下 Apache 模块之一：
1、ea-apache24-mod-passenger – 该软件包仅适用于运行 Ubuntu 的系统；
2、ea-ruby27-mod_passenger – 该软件包仅适用于运行 AlmaLinux OS 或 Rocky Linux™ 的系统。
如有需要，供应商还应安装以下软件包：
3、ea-apache24-mod_env – 该模块允许应用程序配置为应用程序设置环境变量；
4、如果需要 Node.js™ 应用程序支持，请安装以下软件包之一：
- ea-nodejs16
- ea-nodejs18
- ea-nodejs20
注意：安装 Node.js 软件包时，将卸载任何其他 Node.js 软件包。必须更新任何现有应用程序，以使用新版本的 Node.js。任何新应用程序都将使用最新安装的 Node.js 版本。
5、python – 为应用程序安装相应版本的 python。
注意：应用程序管理器默认使用 /usr/bin/python3（如果存在）。如果不存在，应用程序管理器默认使用 /usr/bin/python。如果想默认使用其他版本，请使用以下命令添加首选版本的路径：
echo -n /path/to/python > /etc/cpanel/ea4/passenger.python
如果需要此功能，请联系主机提供商。
二、应用程序
此表包含以下信息：
1、名称 – 应用程序名称。
2、域 – 应用程序的域名。
3、路径 – 相对于主目录，应用程序源代码所在的文件。
4、状态 – 应用程序是否启用或禁用。
5、操作 – 使用此列中的项目执行以下操作：
- 编辑 – 编辑应用程序；
- 取消注册 – 取消注册应用程序；
- 启用依赖关系 – 确认并在必要时安装应用程序的 Node.js 包管理器 (npm) 依赖关系。
三、创建应用程序
在应用程序管理器界面注册应用程序之前，必须先创建应用程序。例如，可以执行以下操作之一：
1、使用我们的 Git 版本控制界面从 GitHub 克隆一个现有应用程序（cPanel ” 主页 ” 文件 ” Git™ 版本控制）。
2、在服务器上创建一个新应用程序。
在这些界面中创建的任何内容都无法使用应用程序管理器功能：
- cPanel 的 Ruby on Rails 界面（cPanel ” 主页 ” 软件 ” Ruby on Rails）；
- cPanel 的 RubyGems 界面（cPanel ” 主页 ” 软件 ” RubyGems）；
- WHM 模块安装程序界面的 Ruby gem 安装程序部分（WHM ” 主页 ” 软件 ” 模块安装程序）。
四、注册应用程序
此功能使用系统中最新版本的 Ruby 配置新应用程序。Passenger 的安装版本决定了系统使用哪个版本的 Ruby。不能安装超过一个版本的 Passenger。
现有应用程序不会更改其 Ruby 版本。如果卸载应用程序的 Ruby 版本，应用程序将不再运行。
要注册应用程序，请执行以下步骤：
1、单击注册应用程序，将出现一个新界面。
2、在 Application Name（应用程序名称）文本框中输入应用程序名称。
3、从部署域菜单中选择要部署应用程序的主域、附加域或子域。
4、在基础应用程序 URL 文本框中输入应用程序的基础 URL。注册应用程序后，在 Web 浏览器中输入此 URL 以访问应用程序。
5、在 Application Path 文本框中输入相对于主目录的源代码目录路径。
6、选择部署环境。这将设置应用程序运行的服务器环境。
- 如果仍在开发应用程序，请单击 “开发”；
- 如果已准备好部署和使用应用程序，请单击生产。
7、如果要添加环境变量，请单击 “环境变量 “部分中的 “添加变量”。
8、单击部署。
五、环境变量
注意：要添加环境变量，系统管理员必须安装 ea-apache24-mod_env Apache 模块。
环境变量允许配置应用程序在多个系统上运行的进程。环境变量表包含以下信息：
1、变量名称 – 环境变量的名称。
环境变量名称必须满足以下条件：
- 名称只能包含字母、数字、下划线和破折号；
- 名称必须包含 256 个字符或更少；
- 名称不能以数字开头。
2、Value – 环境变量的值。
环境变量值必须包含 1024 个或更少的 ASCII 可打印字符。
3、操作 – 使用此列中的项目执行以下操作：
- 编辑 – 编辑环境变量；
- 取消注册 – 删除环境变量。
六、添加环境变量
要在应用程序的配置文件中添加环境变量，请执行以下步骤：
1、在环境变量部分，单击添加变量。
2、在变量名称列的环境变量名称文本框中输入变量名称。
3、在 “值 “列的 “环境变量值 “文本框中输入变量值。
4、单击操作栏中的保存。
七、编辑应用程序
要编辑应用程序的配置文件，请执行以下步骤：
1、在应用程序表中，找到要编辑的应用程序。
2、在操作栏中单击编辑。这时会出现一个新界面。
3、进行所需的更改。
4、单击部署。
八、取消注册应用程序
取消注册应用程序会将其从列表中删除，并删除其配置文件。但不会删除应用程序。
要取消注册应用程序，请执行以下步骤：
1、在应用程序表中，找到要取消注册的应用程序。
2、单击取消注册。此时会出现一条确认信息。
3、单击取消注册以完全取消注册应用程序，此时会出现一条成功消息。
