LinuxにNode.jsをインストールして使う入門｜nvmでWSL2やVPSにJavaScript実行環境を構築する方法

この記事のポイント

・nvm install --lts でNode.jsのLTS版をsudo不要でインストールできる
・nvmを使えばバージョン切り替えが nvm use コマンド1行でできる
・npmコマンドでパッケージの install/uninstall/run などの基本操作を習得できる
・「nvm: command not found」など初心者がはまるエラーと対処法も網羅している

# ログインユーザーを確認する
$ whoami
tomohiro

# OSの種類を確認する（Ubuntu/Rocky Linuxなど）
$ cat /etc/os-release | head -4
NAME="Ubuntu"
VERSION="24.04.2 LTS (Noble Numbat)"
ID=ubuntu
ID_LIKE=debian

# Ubuntuかどうか確認する
$ which apt
/usr/bin/apt

# Rocky Linuxかどうか確認する
$ which dnf
/usr/bin/dnf

# 現在使っているシェルを確認する
$ echo $SHELL
/bin/bash    ← bashの場合

# または
/bin/zsh     ← zshの場合

# curlでnvmのインストールスクリプトをダウンロード・実行する
$ curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash

# 実行後の出力例
=> Downloading nvm from git to '/home/tomohiro/.nvm'
=> Cloning into '/home/tomohiro/.nvm'...
remote: Enumerating objects: 375, done.
remote: Counting objects: 100% (375/375), done.
=> Appending nvm source string to /home/tomohiro/.bashrc
=> Appending bash_completion source string to /home/tomohiro/.bashrc
=> Close and reopen your terminal to start using nvm or run the following to use it now:

# .bashrcを再読み込みする
$ source ~/.bashrc

# nvmが使えるようになったか確認する
$ nvm --version
0.40.0

# Ubuntu/Debianの場合
$ sudo apt update && sudo apt install -y curl

# Rocky Linux/RHELの場合
$ sudo dnf install -y curl

# 最新LTS版のNode.jsをインストールする
$ nvm install --lts

# インストール後の出力例
Installing latest LTS version.
Downloading and installing node v22.15.0...
Downloading https://nodejs.org/dist/v22.15.0/node-v22.15.0-linux-x64.tar.xz...
#########################################################  100.0%
Computing checksum with sha256sum
Checksums matched!
Now using node v22.15.0 (npm v10.9.2)
Creating default alias: default -> lts/* (-> v22.15.0)

# Node.jsのバージョンを確認する
$ node --version
v22.15.0

# npm（パッケージマネージャー）のバージョンも確認する
$ npm --version
10.9.2

# インストール済みのNode.jsバージョン一覧を表示する
$ nvm ls
->    v22.15.0
default -> lts/* (-> v22.15.0)

# デフォルトバージョンをv22に固定する
$ nvm alias default 22

# 設定後の確認
$ nvm ls
->    v22.15.0
default -> 22 (-> v22.15.0)

# プロジェクト用ディレクトリを作成して移動する
$ mkdir my-node-project && cd my-node-project

# package.jsonを生成する（-yで質問をスキップ）
$ npm init -y

# 出力例
Wrote to /home/tomohiro/my-node-project/package.json:
{
  "name": "my-node-project",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo Error: no test specified && exit 1"
  },
  "author": "",
  "license": "ISC"
}

# lodash（ユーティリティライブラリ）をインストールする例
$ npm install lodash

# 出力例
added 1 package, and audited 2 packages in 2s
1 package is looking for funding
  run `npm fund` for details
found 0 vulnerabilities

# インストール済みパッケージの一覧を確認する
$ npm list
my-node-project@1.0.0 /home/tomohiro/my-node-project
└── lodash@4.17.21

# パッケージを削除する
$ npm uninstall lodash

removed 1 package, and audited 1 package in 1s
found 0 vulnerabilities

# package.json の scripts フィールドの例
{
  "scripts": {
    "start": "node server.js",
    "dev": "node --watch server.js",
    "test": "node test.js"
  }
}

# npm run で実行する
$ npm run start
$ npm run dev

# start と test は run を省略できる
$ npm start
$ npm test

# create-react-appをインストールせずに一時実行する例
$ npx create-react-app my-app

# コマンドのバージョン確認ツールを一時実行する例
$ npx npm-check-updates

# .gitignoreを作成してnode_modulesを除外する
$ echo "node_modules/" > .gitignore

# 他の開発者が package.json から依存関係を再現する場合は
# npm install を実行するだけで node_modules が再作成される
$ npm install

# テキストエディタ（nano）でJSファイルを作成する
$ nano hello.js

// hello.js
console.log('Hello, Linux Node.js!');

const now = new Date();
console.log('現在時刻: ' + now.toLocaleString('ja-JP'));

# nodeコマンドでJSファイルを実行する
$ node hello.js

# 出力例
Hello, Linux Node.js!
現在時刻: 2026/7/11 10:00:00

# server.jsを作成する
$ nano server.js

// server.js
const http = require('http');

const server = http.createServer((req, res) => {
  res.writeHead(200, { 'Content-Type': 'text/plain; charset=utf-8' });
  res.end('Hello from Node.js on Linux!
');
});

server.listen(3000, () => {
  console.log('サーバーがポート3000で起動しました');
  console.log('http://localhost:3000 にアクセスしてください');
});

# サーバーを起動する
$ node server.js

# 出力例
サーバーがポート3000で起動しました
http://localhost:3000 にアクセスしてください

# REPLを起動する
$ node
Welcome to Node.js v22.15.0.
Type ".help" for more information.
> 1 + 2
3
> console.log('test')
test
undefined
> .exit
$

# Node.js 20系をインストールする
$ nvm install 20

# インストール済みバージョン一覧を確認する
$ nvm ls
       v20.18.0
->     v22.15.0
default -> lts/* (-> v22.15.0)
lts/* -> lts/jod (-> v22.15.0)
lts/iron -> v20.18.0

# Node.js 20に切り替える
$ nvm use 20
Now using node v20.18.0 (npm v10.8.2)

# バージョンを確認する
$ node --version
v20.18.0

# 元のLTS（v22）に戻す
$ nvm use --lts
Now using node v22.15.0 (npm v10.9.2)

# .nvmrcファイルを作成する（v22を指定する例）
$ echo "22" > .nvmrc

# .nvmrcを読んでバージョンを切り替える
$ nvm use
Found '/home/tomohiro/my-node-project/.nvmrc' with version <22>
Now using node v22.15.0 (npm v10.9.2)

# .bashrcを再読み込みする
$ source ~/.bashrc

# または新しいターミナルを開き直す
# WSL2の場合はウィンドウを閉じて再度開く

# ~/.bashrc にnvmの記述があるか確認する
$ grep -n "nvm" ~/.bashrc
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # This loads nvm

# 手動でnvmのパス設定を~/.bashrcに追記する
$ echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.bashrc
$ echo '[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"' >> ~/.bashrc
$ source ~/.bashrc

# インストール済みバージョンを確認する
$ nvm ls

# 何も表示されない場合はLTS版をインストールする
$ nvm install --lts

# バージョンが表示されるがnodeが使えない場合はuseで切り替える
$ nvm use --lts

# エラーの例
$ npm install -g some-package
npm WARN checkPermissions Missing write access to /usr/lib/node_modules
npm ERR! code EACCES
npm ERR! syscall access
npm ERR! path /usr/lib/node_modules

# 対処：nvmでNode.jsをインストールし直す
# （nvmを使えばsudo不要でグローバルインストールが可能になる）
$ nvm install --lts
$ nvm use --lts
$ npm install -g some-package   # sudoなしで成功する

# エラーの例
npm WARN EBADENGINE Unsupported engine {
npm WARN EBADENGINE   package: 'some-package@2.0.0',
npm WARN EBADENGINE   required: { node: '>=20' },
npm WARN EBADENGINE   current: { node: 'v18.20.5', npm: '10.7.0' }
npm WARN EBADENGINE }

# 対処：Node.jsを必要バージョン以上に切り替える
$ nvm use 20
$ npm install some-package

# エラーの例
npm ERR! code CERT_HAS_EXPIRED
npm ERR! errno CERT_HAS_EXPIRED

# 対処1：npmのキャッシュをクリアして再試行する
$ npm cache clean --force
$ npm install

# 対処2：システムのCA証明書を更新する（Ubuntu/Debian）
$ sudo apt update && sudo apt install -y ca-certificates
$ sudo update-ca-certificates

# エラーの例
Error: error:0308010C:digital envelope routines::unsupported
  opensslErrorStack: [ 'error:03000086:...' ],
  library: 'digital envelope routines',
  reason: 'unsupported',
  code: 'ERR_OSSL_EVP_UNSUPPORTED'

# 対処1：Node.js 16系に切り替える（プロジェクトが新しいNode.jsに対応していない場合）
$ nvm install 16
$ nvm use 16
$ npm start

# 対処2：環境変数でOpenSSLのレガシープロバイダーを有効にする（一時的な回避策）
$ export NODE_OPTIONS=--openssl-legacy-provider
$ npm start