過去バージョン

この記事の要点

NodeSource リポジトリを追加 → dnf install nodejs が公式推奨 コマンド 1 行: curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash - → sudo dnf install -y nodejs 複数バージョンを使い分けるなら nvm または fnm を推奨 OS による違い: CentOS 7 は yum、CentOS Stream 8/9 / RHEL 8+ は dnf native module ビルドのため gcc-c++ make など Development Tools も入れる 本番運用には pm2 または systemd でデーモン化 コンテナ運用なら node:lts-alpine イメージで CentOS に依存しない構成も可

CentOS で Node.js をインストールする 4 つの方法

方法	用途	難易度
NodeSource リポジトリ + dnf	★ 推奨。本番サーバ	★
nvm (Node Version Manager)	開発機。複数バージョン併用	★★
fnm (Fast Node Manager)	nvm より高速	★★
ソースビルド	特殊用途のみ	★★★

方法1: NodeSource リポジトリ (公式推奨)

OS パッケージマネージャに Node.js 公式リポジトリを追加する方法。本番サーバに最適です。

CentOS Stream 8 / 9 / RHEL 8+ / Rocky / AlmaLinux

# 1. NodeSource リポジトリを追加 (LTS = Long Term Support 推奨)
curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -

# 特定メジャーバージョンが欲しい場合
# curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -
# curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash -

# 2. dnf でインストール
sudo dnf install -y nodejs

# 3. バージョン確認
node -v       # v20.x.x など
npm -v        # 10.x.x など

# 4. ビルドツール (native module 用)
sudo dnf groupinstall -y "Development Tools"
sudo dnf install -y gcc-c++ make

CentOS 7 (旧バージョン)

# CentOS 7 は yum を使う
curl -fsSL https://rpm.nodesource.com/setup_18.x | sudo bash -
sudo yum install -y nodejs

# CentOS 7 のサポートは 2024-06 で終了 → 早急に Stream 8/9 か Rocky/Alma に移行推奨

# 開発ツール
sudo yum groupinstall -y "Development Tools"

方法2: nvm (複数バージョン管理)

開発機で「プロジェクトごとに Node バージョンを変えたい」場合の定番ツール:

# 1. nvm インストール
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# 2. シェル再起動 or source
source ~/.bashrc

# 3. 利用可能バージョン確認
nvm ls-remote --lts

# 4. インストール
nvm install --lts        # 最新 LTS
nvm install 20.10.0
nvm install 22

# 5. デフォルト切替
nvm use 20
nvm alias default 20

# 6. プロジェクト単位 (.nvmrc)
cd ~/my-app
echo "20.10.0" > .nvmrc
nvm use            # .nvmrc を読み込む

# 7. 全バージョン一覧
nvm ls

方法3: fnm (高速版 nvm)

# Rust 製で nvm より高速
curl -fsSL https://fnm.vercel.app/install | bash

# シェル再起動 or
eval "$(fnm env)"

# 使い方は nvm 互換
fnm install --lts
fnm use 20
fnm default 20
fnm list

動作確認

# バージョン
node -v        # v20.10.0
npm -v         # 10.2.3
npx -v         # 10.2.3

# 簡単な実行
node -e "console.log('Hello Node.js')"

# REPL に入る
node
> 1 + 2
3
> .exit

# Hello World サーバ
cat > server.js <<'EOS'
const http = require('http');
http.createServer((req, res) => {
  res.end('Hello from CentOS Node.js\n');
}).listen(3000, () => console.log('listening on 3000'));
EOS

node server.js &
curl http://localhost:3000

ファイアウォール開放 (本番)

# firewalld で 3000 番を開ける
sudo firewall-cmd --permanent --add-port=3000/tcp
sudo firewall-cmd --reload

# または HTTPS は通常 nginx をリバプロにして 443 のみ開放
sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo firewall-cmd --reload

# SELinux でポートバインド許可
sudo semanage port -a -t http_port_t -p tcp 3000

本番運用: pm2 でデーモン化

# pm2 グローバルインストール
sudo npm install -g pm2

# アプリ起動
pm2 start server.js --name myapp

# 起動状況確認
pm2 list
pm2 logs myapp
pm2 monit              # ダッシュボード

# 再起動・停止
pm2 restart myapp
pm2 stop myapp
pm2 delete myapp

# OS 起動時自動起動 (systemd と連携)
pm2 startup systemd
# 出力されたコマンドを実行 (root で)
pm2 save               # 現在のプロセス一覧を保存

systemd で直接デーモン化

# /etc/systemd/system/myapp.service
[Unit]
Description=My Node.js App
After=network.target

[Service]
Type=simple
User=appuser
WorkingDirectory=/opt/myapp
ExecStart=/usr/bin/node /opt/myapp/server.js
Restart=on-failure
Environment=NODE_ENV=production
Environment=PORT=3000

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now myapp
sudo systemctl status myapp
journalctl -u myapp -f

Docker (CentOS と独立)

# Dockerfile
FROM node:lts-alpine

WORKDIR /app
COPY package*.json ./
RUN npm ci --omit=dev
COPY . .

EXPOSE 3000
USER node
CMD ["node", "server.js"]

docker build -t myapp .
docker run -d -p 3000:3000 --name myapp myapp
docker logs -f myapp

トラブルシューティング

症状	原因	対処
node: command not found	PATH に入っていない	which node 確認 / シェル再起動
EACCES: permission denied npm install -g	root 以外で global install	nvm 利用 or npm config set prefix ~/.npm-global
gyp ERR! find Python	Python が無い	sudo dnf install python3
node-gyp rebuild エラー	gcc-c++ make 不足	Development Tools 入れる
古いバージョンしか入らない	OS デフォルトの古いリポジトリ	NodeSource を追加

FAQ

Q: dnf install nodejs だけだとどのバージョンが入る?
A: OS のデフォルトリポジトリだと古い (CentOS Stream 9 で 16 系など)。NodeSource を追加してから入れるのが推奨。

Q: CentOS 7 はもう使えない?
A: 2024-06-30 でサポート終了。新規構築は Rocky Linux 9 / AlmaLinux 9 / CentOS Stream 9 を推奨。

Q: npm install で異常に遅い
A: NPM レジストリへの接続が遅い場合、社内ミラー (Verdaccio / Nexus) を設定するか、npm config set registry https://registry.npmmirror.com など速いミラーに変更。