メインコンテンツまでスキップ

dig-node コントロールパネル

DIG Chrome extension には、ローカルの dig-node を管理するためのコントロールパネルが組み込まれています。ここからノードのライブステータスを確認したり、キャッシュされたコンテンツのためにどれだけのディスク容量を予約するかを決めたりできます。さらに、一度だけのペアリングを済ませれば、ノードのアップストリーム、ホストしているストア、同期、ピアまで管理できます。日常的な利用にコマンドラインは不要です。

コントロールパネルは、DIG Browser のノード管理画面に相当する機能を拡張機能に組み込んだものです。自分自身のマシンで動いているノードと通信するため、すべてがローカルにとどまります。

開き方​

  1. 拡張機能を開きます。
  2. Network(ネットワーク)タブを開き、Control(コントロール)を選びます。(コンパクトなポップアップには概要のみが表示されます。各セクションを全画面で見るにはコントロールパネルを開くを使ってください。)

パネルはノードを自動的に検出します。

  • ノードが実行中 → 管理画面が表示されます。
  • ノードが見つからない → ノードのインストール方法を説明する短いページが表示されます。この場合でもブラウジング自体は問題なく行えます——コンテンツの読み込みはパブリックネットワークへフォールバックします。ノードが必要になるのは、下記の管理画面だけです。

ライブステータス​

上部のライブインジケーターは、ノードが接続済み、接続中、切断のいずれの状態にあるかを、そのアドレスとバージョンとともに表示します。この表示は自動的に更新されます——ノードを起動または停止すると、数秒以内にインジケーターが切り替わり、パネルを開き直したり再読み込みしたりする必要はありません。

キャッシュコンテンツ用にディスク容量を予約する(キャッシュと LRU)​

あなたのノードは取得済みのコンテンツをローカルにキャッシュするため、再訪問が瞬時になり、そのコンテンツの配信を手助けすることにもなります。キャッシュには予約サイズがあります——ノードが使用できるディスク容量の上限です。キャッシュがこの上限を超えると、ノードは最も長く使われていない項目から自動的に削除していきます(「LRU」ポリシー)。これにより、予約した容量を超えることはなく、実際に使っているコンテンツはキャッシュされたままになります。

このセクションはペアリングなしですぐに利用できます。

使用量を確認する。 バーが予約上限に対する使用容量を示すほか、いくつかのライブな数値も表示されます:キャッシュされている項目数、その合計サイズ、ノード起動後に削除(エビクション)された量、そしてキャッシュのヒット/ミス件数です。

予約上限を設定する。 新しいサイズを入力して適用します。最小値は 64 MiB で、これより小さい値はこの下限に引き上げられます。上限を現在の使用量より低く設定すると、使用量が収まるまで最も古い項目からエビクションが実行されます。

キャッシュ項目を確認・削除する。 キャッシュ一覧には各項目のサイズ、最終使用日時、そしてエビクション順序(位置 0 が次に削除される項目)が表示されます。次のことができます。

  • 1 件をエビクションする — 単一のキャッシュ項目を今すぐ削除します。
  • すべてクリアする — キャッシュを完全に空にします。

項目を削除してもローカルディスクの空き容量が増えるだけです。再び訪れたコンテンツは、単に再取得されます。

ヒント

よく使うマシンでは、キャッシュにできるだけ多くの容量を割り当ててください——予約容量が大きいほど再取得が減り、より多くのコンテンツをローカルから配信できます。ディスク容量が限られたマシンでは予約を小さくしましょう。LRU が最も有用な項目を残し、それ以外を破棄します。

ノードを管理する(ペアリングが必要)​

残りのセクションはノードの設定を変更するため、明示的な許可が必要です。拡張機能はブラウザのサンドボックス内で動作するため、ノードのローカル権限ファイルを直接読み取ることができません——そこで、一度だけペアリングを行います。ペアリングによって拡張機能には専用の、範囲が限定され取り消し可能な資格情報が発行されます。ノードのマスターキーが露出することは決してなく、承認できるのはそのノードを実行しているコンピューター上だけです。

拡張機能をノードとペアリングする​

  1. コントロールパネルでペアリングを選びます。拡張機能に 6 桁のコードとペアリング ID が表示されます。
  2. ノードを実行しているコンピューターのターミナルで dig-node pair を実行し、保留中のリクエストを一覧表示します(または直接 dig-node pair approve <pairing-id> を実行します)。
  3. ターミナルに表示されたコードが拡張機能のコードと一致することを確認してから承認します。この一致確認があなたを守る仕組みです。承認しているのがほかならぬこの拡張機能であることを保証します。
  4. コントロールパネルは自動的にペアリング済みの状態に切り替わります。資格情報は拡張機能側にのみ保存されます。

ペアリングコードは数分で失効します。承認する前に失効した場合は、もう一度ペアリングを選んで新しいコードを取得してください。

資格情報の利用をやめるには、パネルでペアリング解除を選びます(ローカル側で忘れるだけです)。ノード側で取り消すには、そのコンピューターで dig-node pair revoke <token-id> を実行してください——パネルは次の操作時に未ペアリングの状態へ戻ります。

注記

ペアリングが必要なのは、下記の管理セクションのみです。上記のライブステータスとキャッシュ/LRU の操作はペアリングなしで動作します。

アップストリーム​

ノードが取得元としているアップストリームを確認し、別のものに設定できます。変更したアップストリームは、次にノードが起動したときに反映されます。

ホストしているストア​

ノードが保持・固定(ピン留め)しているストアを確認し、新しいストアを固定して(ノードがそれを保持・配信するように)ピン留めしたり、固定を解除したり、任意のストアのステータスを確認したりできます。特定バージョンを固定すると、それを事前に取得しておき、すぐに配信できる状態にします。

同期​

認証付きのストア全体同期が利用可能かどうかを確認し、特定バージョンについて同期を実行して、ノードにそのバージョンを取得・キャッシュさせることができます。

ピア​

あなたのノードのピアネットワークの状態——家庭用ルーターの内側からでも到達可能にするためのリレーへの接続状況や、接続中のピア——を確認できます。

関連ページ​