AMZ Linux 2 EC2实例通过userData脚本安装nvm/Node失败求助

核心原因 #

EC2的userData脚本默认以root用户执行，而你SSH登录用的是普通用户（比如ec2-user）。nvm会安装到当前执行用户的home目录下：

• root用户的nvm路径是/root/.nvm，普通用户无法直接访问使用
• 手动执行命令时是在ec2-user环境下，nvm安装到/home/ec2-user/.nvm，所以能正常识别

另外，userData运行的是非交互式shell，不会自动加载用户的shell配置文件（比如.bashrc），即使安装了nvm，后续登录也不会自动初始化环境变量。

修正后的userData脚本 #

修改脚本，切换到ec2-user执行安装，并确保nvm的初始化代码写入用户的shell配置文件：

#!/bin/bash
# 切换到ec2-user执行nvm安装
sudo -u ec2-user bash << EOF
curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.39.1/install.sh | bash
# 加载nvm环境
. /home/ec2-user/.nvm/nvm.sh
# 安装指定Node.js版本
nvm install 16.17.0
# 设置默认版本，避免每次登录手动切换
nvm alias default 16.17.0
EOF

验证方法 #

• 重启EC2实例（或重新应用userData）
• SSH登录后直接执行node -v和nvm --version，应该能看到对应版本输出
• 若仍有问题，可查看userData执行日志排查错误：cat /var/log/cloud-init-output.log

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