Node.js のバージョンを確かめて、アップデートする手順

Node.js のバージョンを確かめて、アップデートする手順

2026年10月21日に公開された Node.js のセキュリティアップデートに合わせて、自分の環境の Node.js を確かめて、修正版に上げる手順をまとめます。Node.js は、本番のサーバーだけでなく、手元のパソコン、Docker のイメージ、CI、ホスティングのビルド環境など、いろいろな場所で動いています。ひとつずつ見ていきましょう。何が直ったのかは「Node.js のセキュリティアップデート(2026年10月)」をご覧ください。

目標のバージョン

22.23.4/24.22.1/26.12.1 以降。Node.js 20 には修正版が出ないので、22 か 24 へ移ります。

1. まず、いまのバージョンとインストール方法を確かめる

node -v          # いま動いている Node.js のバージョン
which node       # どこに入っているか(Windows は where node)
npm -v

which node の結果を見ると、どの方法で入れたかの見当がつきます。

  • ~/.nvm/ をふくむ → nvm
  • /opt/homebrew/ や /usr/local/Cellar/ をふくむ → Homebrew(Mac)
  • ~/.volta/ や fnm のフォルダ → volta や fnm
  • /usr/local/bin/node → 公式インストーラーのことが多い

同じパソコンに、ちがう方法で入れた Node.js が二つ以上あることもあります。which -a node で、全部を並べて見られます。

2. 手元のパソコンを更新する

nvm を使っている場合

nvm install 22          # 22 系の最新版を入れる(24 なら nvm install 24)
nvm alias default 22    # 新しく開くターミナルでも使う
node -v

前のバージョンで入れていたグローバルなパッケージも移したいときは、nvm install 22 --reinstall-packages-from=current とします。

Homebrew を使っている場合(Mac)

brew update
brew upgrade node       # node@22 や node@24 を入れているなら、その名前で
node -v

Homebrew に修正版が届くまで、少し時間がかかることがあります。【要確認:brew info node で、修正版が入れられるようになっているか】

公式インストーラーを使っている場合

nodejs.org から、使っている系列(22 や 24)の最新版のインストーラーをダウンロードして、上書きで入れなおします。終わったら、ターミナルを開きなおして node -v で確かめます。

volta や fnm の場合

volta install node@22
fnm install 22 && fnm default 22

3. サーバーを更新する

Linux のサーバーでは、パッケージ管理(apt や dnf)で入れていることが多いと思います。いつもの更新コマンドで新しいバージョンが入るかを確かめてから、更新します。

# Debian / Ubuntu(NodeSource などのリポジトリを使っている場合)
sudo apt update && sudo apt install --only-upgrade nodejs

# RHEL 系
sudo dnf upgrade nodejs

【要確認:ディストリビューション標準のパッケージは、バージョン番号を変えずに修正だけを取りこむことがある。提供元のセキュリティ情報で確認する】

更新したら、Node.js で動いているアプリを再起動するのを忘れずに。古いプロセスは、古い Node.js のまま動き続けます。

pm2 restart all               # pm2 を使っている場合
sudo systemctl restart myapp  # systemd で動かしている場合

4. Docker のイメージを作りなおす

FROM node:22 のように系列だけを書いている場合でも、手元やサーバーに古いイメージが残っていると、それがそのまま使われます。新しいベースイメージを取りに行くように、作りなおします。

docker pull node:22
docker build --pull -t myapp .
docker run --rm myapp node -v   # 修正版になっているか確かめる

バージョンをきっちり決めたいときは、FROM node:22.23.4-bookworm-slim のように細かく書く方法もあります。【要確認:Docker Hub の公式イメージに修正版のタグが出ているか】作りなおしたイメージで、もう一度デプロイするところまでが更新です。

5. CI(GitHub Actions)を確かめる

actions/setup-node で node-version: "22" のように系列だけを書いている場合、ランナーにあらかじめ入っている 22 系がそのまま使われることがあり、最新版とはかぎりません。最新の修正版を使いたいときは、check-latest: true を足すか、バージョンを細かく書きます。

- uses: actions/setup-node@v4
  with:
    node-version: "22"
    check-latest: true      # いちばん新しい 22.x を取りに行く

リポジトリに .nvmrc を置いて、node-version-file: .nvmrc で読ませると、手元と CI のバージョンをそろえやすくなります。node-version: "20" のままのワークフローがあれば、22 か 24 に変えておきましょう。

6. ホスティングを確かめる

  • Vercel — 22.x と 24.x のプロジェクトは、細かいバージョンを Vercel が管理しているので、設定を変える必要はないと案内されています。20.x のプロジェクトは、設定画面か package.json の engines.node で 22.x か 24.x に変えて、デプロイしなおします
  • Netlify — ビルドの Node.js は、環境変数 NODE_VERSION や .nvmrc などで決まります。系列だけを指定しているときに、修正版が使われているかはビルドログで確かめます。【要確認:Netlify Functions の実行環境のバージョンの決まり方】
  • Cloudflare Workers / Pages Functions — 本番で動くのは Node.js ではなく、Cloudflare の「workerd」という別の実行環境です。そのため、Node.js 本体の今回の修正は、そのまま当てはまるわけではありません。【要確認:nodejs_compat を使っている場合の影響について、Cloudflare からの案内】ただし、サイトを組み立てるビルドでは Node.js を使います。Pages のビルドなら環境変数 NODE_VERSION や .node-version で、手元でビルドして wrangler でアップロードしているなら、手元の Node.js を更新します

7. 更新したあとに

  • もう一度 node -v で、目標のバージョンになっているか確かめる
  • 系列をまたいで上げたとき(20 → 22 など)は、node_modules を消して入れなおすと安心。ネイティブの部品をふくむパッケージは作りなおしが必要なことがある
  • テストを流して、いつもどおり動くかを確かめる
  • 「どこで、どのバージョンを使っているか」を一覧にしておくと、次のアップデートのときに迷わない

参考

シェアする

Xでシェア
ほかの記事も読んでみてねブログの一覧へ

← ブログ一覧へ