🚀 免费部署 Node.js 应用:从注册到上线完整图文教程

💡 本教程为零基础用户准备,帮助你快速注册账号、搭建免费服务器并部署 Node.js 项目,实现一键上线运行!


🧾 准备工作

✅ 1. 注册必备服务

  • 🔗 GitHub 账号官网注册:点击直达
    用于托管项目代码、管理工作流等。

  • 🔗 免费服务器注册地址:点击注册
    推荐使用带有 Node.js 支持的主机服务(如 InfinityFree、000webhost、Glitch、Render 等)。

  • 🔗 身份生成器地址:点击直达
    用于注册平台时获取信息,如姓名、邮箱、地址等。

  • 🔗 UUID 生成器:点击直达
    用于作为用户唯一标识,也可用于服务加密字段。


📁 项目部署

📦 项目代码地址:点击直达

将项目代码上传至服务器文件夹:

/domains/你的域名/public_html

注意:请替换为你自己的完整域名路径,并确保目录结构正确。

  1. 核心启动文件:确认你项目的启动文件为 app.js


⚙️ Node.js 应用配置(以某免费主机为例)

登录面板后依次操作:

Website Management ➡ NodeJs APP ➡ Create application ➡ CREATE

必填项:

  • Node.js Versionv22

  • Application rootdomains/xxx.xxxx.com/public_html(务必替换为你的真实域名)

  • Application startup fileapp.js

添加环境变量(Add variable):

名称

描述

DOMAIN

你的自定义域名

PORT

自定义端口(避免被他人占用)

UUID

用上方链接生成的 UUID

NEZHA_SERVER

哪吒探针地址(可选)

NEZHA_PORT

哪吒探针端口(可选)

NEZHA_KEY

哪吒探针密钥(可选)


🔧 终端命令操作

点击进入面板 → Development Tools ➡ Terminal

  1. 复制创建 Node 应用时提示的一行 初始化命令,粘贴并执行获取运行权限;

然后运行以下命令安装依赖:

npm i

📂 注意文件结构与跳过验证

注意哪吒端口问题不要用默认3000,基本都是被占用的


❗ 常见问题:503 错误

如出现访问 503:

  • ✅ 尝试更换端口;

  • ✅ 检查环境变量与路径是否正确;

  • ✅ 更换端口后需重新点击 Run JS script 以启动服务。