如何通过SSH终端在群晖NAS DSM 7.1上安装Node.js v20

步骤1：确认当前环境与NAS架构 #

• 登录群晖SSH终端，执行以下命令查看当前Node.js版本：

  node -v
  npm -v
  

• 执行以下命令确认NAS的CPU架构（后续下载对应包需要）：

  uname -m
  

  常见架构对应：x86_64（64位英特尔/AMD）、armv7l（32位ARM）、aarch64（64位ARM）

步骤2：下载Node.js v20预编译二进制包 #

• 根据第一步得到的架构，去Node.js官方下载对应版本的v20预编译压缩包（格式为.tar.xz）
• 也可直接在终端用wget下载，示例（替换为对应架构的下载地址）：

  # x86_64架构示例
  wget https://nodejs.org/dist/v20.17.0/node-v20.17.0-linux-x64.tar.xz
  # armv7l架构示例
  wget https://nodejs.org/dist/v20.17.0/node-v20.17.0-linux-armv7l.tar.xz
  

步骤3：解压并部署Node.js包 #

• 解压下载的压缩包：

  # 替换为你下载的包名
  tar -xJf node-v20.17.0-linux-x64.tar.xz
  

• 将解压后的文件夹移动到系统全局目录：

  # 替换为解压后的文件夹名
  mv node-v20.17.0-linux-x64 /usr/local/node20
  

步骤4：替换系统默认Node.js软链接 #

• 先备份原有Node.js和npm的软链接：

  sudo mv /usr/bin/node /usr/bin/node.bak
  sudo mv /usr/bin/npm /usr/bin/npm.bak
  

• 创建新的软链接指向刚部署的Node.js v20：

  sudo ln -s /usr/local/node20/bin/node /usr/bin/node
  sudo ln -s /usr/local/node20/bin/npm /usr/bin/npm
  

步骤5：验证升级结果 #

• 执行以下命令确认版本是否切换成功：

  node -v
  npm -v
  

  若输出v20开头的版本号，说明升级完成

步骤6：安装Homebridge #

• 现在可以正常全局安装Homebridge：

  sudo npm install -g homebridge
  

注意事项 #

• 部分老旧ARM架构（如armv6l）的NAS可能不支持Node.js v20，此时可尝试降级到Node.js v18（Homebridge部分版本也支持v18）
• 所有命令建议用sudo执行，避免权限不足问题
• 如果后续需要恢复原有Node.js版本，可删除新软链接并恢复备份：

  sudo rm /usr/bin/node /usr/bin/npm
  sudo mv /usr/bin/node.bak /usr/bin/node
  sudo mv /usr/bin/npm.bak /usr/bin/npm
  

内容的提问来源于stack exchange，提问作者boehmatron