如何在 Spaceship Web Hosting 中设置 Node.js 应用

在 Setup Node.js App 工具中，Spaceship Web Hosting 允许您直接从控制面板部署和管理 Node.js 应用程序。该功能由 CloudLinux 提供支持，并使用 Passenger 运行应用程序。

本指南解释了界面的工作方式、如何创建应用程序以及如何进行管理。

概览

1. 登录 cPanel 后，在专属部分打开 Setup Node.js App：
   
   

   

   
   

2. 在页面顶部，您会看到 创建应用程序 按钮。在其下方，会列出所有已存在的 Node.js 应用程序。每个应用程序条目会显示其配置信息和管理选项：
   
   

   

对于每个已创建的应用程序，界面允许您查看其常规信息，包括应用程序的 URL （URI）、根目录、模式（开发或生产）以及当前状态。

在同一页面，您可以重启或停止应用程序，编辑其配置和环境变量，或完全移除。

提示：应用程序表格可通过点击列标题（如 App URI、根目录、模式或状态）进行排序。这让您更容易在同一账户下管理多个应用程序。

如何创建应用程序

点击 +创建应用程序 按钮后，您需要通过输入以下参数来配置您的应用：

• Node.js 版本
  选择您的应用程序所需的版本。请始终确保与 package.json 文件兼容。
  

• 应用程序模式
  可在开发和生产之间选择。对于上线网站，推荐使用生产模式。
  

• 应用程序根目录
  指定存储应用程序文件的目录。这将在 /home/username 下创建相应的文件夹。
  

• 应用程序 URL
  选择应用程序可访问的域名或子域名。
  

• 应用程序启动文件
  输入启动应用程序的主文件（例如 app.js 或 server.js）

输入所有设置后，点击 创建。成功消息弹出后，系统将初始化环境并显示您的应用程序详细信息。

管理应用程序

部署后，您可以在同一界面管理您的应用程序。在这里，您可以：

• 编辑您的应用程序

编辑页面将打开：

• 重启

• 停止/启动

• 删除

注意：移除应用程序会删除配置，但不会自动删除您的项目文件，除非您手动操作。

上传文件和安装依赖

创建应用程序后，上传您的项目文件（包括 package.json）到指定的应用程序根目录。

然后，您可以通过两种方式安装依赖：

• 在 Setup Node.js App >> 运行 NPM Install：
  
  

  

  
  系统将读取您的 package.json 文件并安装所有所需模块。
  

• 通过 SSH >> 虚拟环境。

  
  要通过 SSH 进入虚拟环境，请运行页面顶部显示的高亮命令：
  
  

  

  
  接下来，运行该命令npm install。这样可以达到相同效果，但也为您提供灵活性：
  

  • 安装特定软件包（npm install package-name）

  • 安装其他模块/开发依赖

  • 运行构建脚本（npm run build）

  • 直接排查npm 错误。

设置环境变量

环境变量可在应用程序设置中配置。您可以定义如 NODE_ENV、API 密钥、数据库凭据等变量。

保存更改后请重启应用程序。