NodeNanny

---
title: デプロイとインストール
summary: まっさらな VPS でゼロから動かすために必要なこと
order: 1
updated: 2026-07-22
tags: [デプロイ, インストール, VPS]
---

## 対応環境

インストールスクリプトは現在、Ubuntu 20.04/22.04/24.04 と Debian 11/12 に対応しています。
既存のサービスとの競合を避けるため、まっさらな新しい VPS を使うことをおすすめします。

## インストールで行われること

インストールスクリプトを実行すると、いくつかの段階を順に経ます:

1. **言語を選択**——現在は中国語/英語/日本語/ドイツ語/ロシア語の5言語に対応しており、
   インストール完了後、端末で表示されるプロンプトやパネルの画面もこの選択に従います
2. **依存関係の確認**——サーバー上の Node.js のバージョンが要件を満たしているかを確認し、
   足りないものがあればインストール方法を案内します
3. **基盤となるプロキシプログラムのインストール**——このステップでは、業界でよく使われる
   ワンクリックインストールスクリプトを呼び出し、実際に処理を行うプロキシサービス本体
   (xray/sing-box)をインストールします。NodeNanny はこの部分を再発明せず、あくまで
   「見守る」役割に徹します
4. **設定の書き込み**——`config/config.json` を生成し、パネルのパスワードやバインドアドレス
   などを含めます
5. **PM2 で3つの常駐プロセスを起動**——`nodenanny-monitor`(生存監視)、
   `nodenanny-panel`(Webパネル)、`nodenanny-pool`(予備ノードプールの維持)

## 接続断について

SSH経由でリモート操作していて、インストール中にネットワークの不安定さで接続が切れて
しまっても、インストールスクリプト自体はそれによって処理が中断されないように設計されて
います——ただし、より確実な方法は、インストールスクリプトを実行する前にサーバー上で
`tmux` または `screen` のセッションを立ち上げておくことです。そうすれば、接続が切れて
再接続した後に `tmux attach` で元の画面に戻り、進行状況を続けて確認できます。

## インストール完了後、パネルの開き方

パネルはデフォルトではローカルアドレス(`127.0.0.1`)のみを待ち受けます。つまり、デフォル
トの状態ではサーバーのパブリックIPを使ってブラウザから直接開くことはできません——これは
意図的なセキュリティ設計で、インストール直後にパネルが公開インターネット上に露出して
しまうことを防いでいます。開く方法には主に2つあります:

- **SSHトンネル**:ローカルで `ssh -L ローカルポート:127.0.0.1:パネルのポート
  あなたのサーバー` を実行し、ブラウザで `http://127.0.0.1:ローカルポート` を開く
- **Nginx リバースプロキシ+パスワードを設定**:ドメインやパブリックIPで直接アクセスしたい
  場合は、設定でパネルのパスワードを明示的に設定し、`deploy/nginx-nodenanny.conf.example`
  というサンプル設定ファイルに従ってリバースプロキシを構成する必要があります。パネルは
  バインドアドレスがローカル以外に変更されているのにパスワードが空のままだと検知した
  場合、起動を拒否します。これは「パスワードの設定を忘れて公開インターネットに露出して
  しまう」ことを防ぐための保護機能であり、バグではありません。

## インストール後まず確認すること:3つのプロセスがすべて動いているか

```bash
pm2 status
```

`nodenanny-monitor`、`nodenanny-panel`、`nodenanny-pool` の3つのプロセスがすべて
`online` 状態になっているはずです。もしいずれかが繰り返し再起動していたり `errored`
状態になっていたりする場合は、`pm2 logs プロセス名` で具体的なエラーを確認してください。
これは「ネットワーク・プロトコル業界の基礎知識」やこのカテゴリでも順次収録していく、
よくあるトラブルシューティングの出発点でもあります。