コンテンツへスキップ

エアギャップ環境とオフライン配備

すべてのスタイルシート、スクリプト、フォント、アイコンが、自分のインストールから配信されます。ログインとサインアップを含む14テンプレート全体で、実測62リクエスト・外部ゼロを検証済みです。

Potatoは、すべてのスタイルシート、スクリプト、フォント、アイコンを、自身のインストールから配信します。 インターネットへの経路がないマシンでも、高速な接続があるマシンと同じインターフェースが描画されます。描画されたアノテーションのページで実測したところ、ログインとサインアップのページを含めて、62リクエスト、外部ゼロでした。

これは、セキュアな研究環境、臨床の現場、フィールドでの配備、厳格なプロキシの内側にあるマシンで重要になります。可用性の性質であると同時に、プライバシーの性質でもあります。

インストールから配信されるアセット

Fabric.js(画像キャンバス)、jQuery、Bootstrap、Font Awesome、Outfitのインターフェース用書体、three.js(点群)、OpenSeadragon(ディープズーム)、d3、Peaks.js(音声の波形)、PDF.js、そしてPotato自身のすべてのCSSとJavaScriptです。

このうち2つは、見た目のためではなく、必須です。jQueryがないと、スパンアノテーションはまったく機能しません。Fabric.jsがないと、画像キャンバスが初期化されないため、描画ツールは表示されても、何も描けません。

フォントがプライバシーの漏えいでした

styles.css は、Google Fontsの @import で始まっていました。オフラインでの動作を壊すだけでなく、ページを読み込むたびに、すべてのアノテーターのIPアドレスとUser-Agentを第三者に送っていました。データを自分たちのインフラの外に出さないために、自前でホストして使うツールでのことです。

これは、過去3回のエアギャップの監査をすり抜けていました。すべてのガードがテンプレート内の <script src> と <link href> を調べていて、スタイルシート内の @import は、どちらでもないためです。書体は、現在はSIL Open Font Licenseのもとで同梱されています。

ログインとサインアップのページにあった第三者のファビコンも、同じ理由で削除されました。ユーザーが認証情報を入力するページから、他社のサーバーへリクエストが出ていたためです。

14テンプレートすべてを対象にする

対象には、ログイン、サインアップ、パスワードのリセット、エラーのページが含まれるようになりました。これらは、エアギャップの監査で最も確認されにくく、最も重要になりやすいページです。

同梱ファイルはチェックサムで検証される

同梱されるものはすべて、CDNが公開しているハッシュに対して検証され、一致しない場合は拒否されます。同梱ファイルはコミットされるため、検証されていないダウンロードは、そのリリースのすべてのユーザーに届いてしまいます。

2つのガードの許可リストは、どちらも空で、ガードは、エントリが何にも一致しなくなると失敗するため、例外が気づかないうちに恒久化することはありません。

potato vendor fetch でインストールする大きなライブラリ

2.12.0以降、Potatoと一緒にコミットするには大きすぎるブラウザのライブラリは、別のコマンドでインストールします。2.13.1には、そのようなライブラリが2つあります。protein_structureディスプレイは、engine: molstar を設定するとMol* 5.12.0を読み込み、molecule ディスプレイと chemical_structure スキームは、RDKitを使うときにRDKit.js 2026.3.6を読み込みます。potato vendor fetch は、リリースが固定しているバージョンをダウンロードし、各ファイルを記録されたSHA-256ハッシュと照合して、インストールします。

bash
potato vendor list                              # what can be fetched, and what is installed
potato vendor fetch --for-config config.yaml    # everything one study needs
potato vendor verify                            # re-check installed files against their hashes
potato vendor path                              # where they are installed

Potatoが、自分でライブラリをダウンロードすることはありません。必要なライブラリがインストールされていない設定は、potato validate とサーバーの起動で失敗し、エラーは、実行するコマンドを示します。ファイルは potato/vendor_fetched/<name>-<version>/ に置かれ、$POTATO_VENDOR_DIR が設定されている場合はその下に置かれます。エアギャップのサーバーでは、接続されたマシンで、同じ POTATO_VENDOR_DIR を使ってfetchを実行し、そのディレクトリをコピーして持ち込み、コピーに対して potato vendor verify を実行してください。

「エアギャップ」が正確に意味すること

アプリケーションにネットワークは必要ありません。モデルは1回限りの転送です。接続されたマシンで potato download-models を実行し、そのディレクトリをコピーして持ち込みます。potato vendor fetch でインストールしたライブラリも、同じ種類の1回限りの転送です。OpenAI、Anthropic、Geminiなど、設定したホスト型のAIエンドポイントには、当然、外へ出る経路が必要です。

したがって、正確な言い方は、「セットアップなしでエアギャップ」ではなく、**「重みがマシンに置かれた後であれば、エアギャップ」**です。

関連項目