使用 Node.js 快速部署

本篇教程以 Linux 操作系统示例，尚未在 Windows 或其他操作系统下测试。

对于 Windows 用户，文档作者建议使用 Docker 进行部署。

环境要求

• 已安装 Git 版本控制系统
• Node.js 版本 >= 20.x
• 已安装 Yarn 包管理工具
• 已安装 PM2 进程管理工具（可选）

开始部署

1. 克隆 EasyNode 项目的仓库：

git clone https://github.com/chaos-zhu/easynode

2. 安装依赖：

cd easynode
yarn

3. 构建前端：

cd web
yarn build

4. 移动前端构建文件：

mkdir -p ../server/app/static
mv dist/* ../server/app/static

5. 启动服务

cd ../server
yarn start

IMPORTANT

从 v3.0.8 版本开始，用户名和密码不再是默认固定值。
需要通过查看终端日志来获取，请在启动服务后注意终端输出，避免错过用户名和密码信息。

TIP

建议第一次启动 EasyNode 时，先手动运行启动命令然后关注终端输出，记住用户名和密码后再考虑配置进程守护。

配置进程守护（可选）

1. 使用 PM2 守护进程：

（请勿启动多个 EasyNode 进程，请在保存数据后于上一小节的终端中执行 Ctrl + C，进程退出后再进行此步骤）

pm2 start index.js --name easynode

2. 保存 PM2 进程列表：

pm2 save

3. 设置 PM2 开机自启：

pm2 startup

请按照提示完成开机自启的配置，例如：

wwwok@SeekServ:~/easynode/server$ pm2 startup
[PM2] Init System found: systemd
[PM2] To setup the Startup Script, copy/paste the following command:
sudo env PATH=$PATH:/home/wwwok/.nvm/versions/node/v22.17.0/bin /home/wwwok/.nvm/versions/node/v22.17.0/lib/node_modules/pm2/bin/pm2 startup systemd -u wwwok --hp /home/wwwok

那么下一步就是执行：

sudo env PATH=$PATH:/home/wwwok/.nvm/versions/node/v22.17.0/bin /home/wwwok/.nvm/versions/node/v22.17.0/lib/node_modules/pm2/bin/pm2 startup systemd -u wwwok --hp /home/wwwok

以完成 PM2 开机自启的配置，
请按照你在执行 PM2 设置开机自启命令后的实际输出来操作。

4. 再次保存进程列表（重要）：

pm2 save

环境变量

将 ~/easynode/server/.env.template 文件重命名为 .env 以启用环境变量配置。

• DEBUG：开启或关闭 debug 模式。

  • 0：关闭
  • 1：开启

通常情况下需要重启后环境变量的变更才能生效。

注意事项

• 端口冲突：请确保服务器的 8082 端口未被其他服务占用，或可使用其他端口。
  • 在 server/app/config/index.js 中修改，module.exports = {...} 中的 httpPort: 8082

部署后下一步

访问：http://localhost:8082（或替换为你的服务器 IP）

如果你看到 EasyNode 的登陆页面，则说明部署成功，下一步请参见首次登陆章节。

常见问题解答请参见常见问题章节。