NodeNanny

---
title: NodeNanny とは何か
summary: 一言で言えば:あなた自身のプロキシノードを見守り、落ちたら自動で救い、繋がらなければ予備プールが穴埋めします
order: 0
updated: 2026-07-22
tags: [紹介, 初心者向け]
---

## 一言で説明すると

NodeNanny は、あなた自身の VPS 上で動く「ノードの世話係」です。あなたが自分で構築した
プロキシノード(xray/sing-boxなど)が生きているかどうかを常に監視し、問題が起きたら自動
で再起動します。もし自前のノードがどうしても復旧できない場合には、「予備ノードプール」も
用意されています——公開されている情報源やあなたが手動で指定したサブスクリプションから
使えるノードを探して穴埋めし、クライアントのサブスクリプションリンクが常に何かしら使える
状態を保ち、突然すべて切断されてしまうことを防ぎます。

## 解決したい核心的な課題

自分でプロキシノードを構築する上で、もっとも心配なのは次の2つです:

1. **サービスプロセスが落ちても誰も気づかない**——真夜中にプロセスがクラッシュし、目が
   覚めてから何時間も断線していたことに気づく
2. **ノード自体は落ちていないが、一時的に使えない**(BAN されている、データセンターの障害
   など)——このような場合、プロセスを再起動するだけでは意味がなく、「代役」が必要になる

NodeNanny はこの2つの問題に対してそれぞれ専用の仕組みを用意しています。プロセスレベルの
生存監視+自動再起動が1つ目を解決し、予備ノードプールが2つ目を解決します。

## 全体アーキテクチャ(これだけ知っておけば十分で、コードを読む必要はありません)

このプロジェクトは3つの常駐プロセスで構成されています(PM2 という Node.js のプロセス
管理ツールで管理されています):

- **nodenanny-monitor**:あなた自身のノードのサービスプロセスを監視し、落ちたら再起動
  します
- **nodenanny-panel**:Webコントロールパネル。ブラウザで見えるものはすべてここから
  提供されます
- **nodenanny-pool**:「予備ノードプール」の維持を担当します——定期的に各情報源から
  ノードを探し、それぞれが本当に使えるかテストし、使えないものを除外します

3つのプロセスは同じデータファイル群を読み書きすることで連携しており、別途データベースは
必要ありません。

## 予備プールの3層フィルタリングロジック

予備ノードプールは「取得したらそのまま使う」わけではなく、各候補ノードは予備プールに
入る前に3段階のチェックを順番に通過しなければなりません:

1. **生存確認(alive)**:このノードは接続できるか
2. **速度確認(speed)**:接続できた後、実際にデータが流れるか。遅すぎるものは除外され
   ます
3. **真正性確認(authentic)**:前の2層は「見せかけの生存」ノード(接続はできるが実際には
   正常にプロキシとして機能しない)に騙される可能性があります。この層では実際の対象サイト
   に対して本物のリクエストを送って動作を検証します

3層すべてを通過して初めて「使用可能」と判定され、パネルに表示されます。

## ノード情報源の信頼度ランク

ノードの情報源(公開情報から収集したものでも、あなた自身が追加したサブスクリプション
リンクでも)は一律に扱われるわけではなく、「試用→信頼→ブラックリスト」という状態遷移で
管理されます:

- 新しい情報源はまず **trial(試用)** 状態から始まり、重み上限はわずか5%です。素性が
  分からない新しい情報源が最初から大きな割合を占めてしまうことを防ぎます
- 試用期間中に合格率が一貫して基準を満たし続ければ、**trusted(信頼)** に昇格し、重み
  上限が解除されます
- 合格率が下がり続ければ、trusted の情報源は trial に降格され、trial の情報源はブラック
  リストに入れられます
- ブラックリスト入りは永久ではありません。ブラックリストに入った情報源も、その後何回か
  連続して実測の合格率が基準を回復すれば、再び trial として解除されます

この仕組みはすべて自動で行われ、あなた自身が手動で確認済みの信頼できるサブスクリプション
ソースを手動で追加したい場合を除いて、手動で介入する必要はありません(次のページで追加
方法を説明します)。

具体的な機場/VPNサービスの選び方については「『機場』とVPNの基礎知識」カテゴリを参照して
ください。ここで言う「ノード情報源」は、サブスクリプションリンク自体の技術的な信頼性を
指しており、機場サービス業者自体の商業的な評判評価は含みません。