エアギャップ環境とオフライン配備
すべてのスタイルシート、スクリプト、フォント、アイコンが、自分のインストールから配信されます。ログインとサインアップを含む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ハッシュと照合して、インストールします。
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 installedPotatoが、自分でライブラリをダウンロードすることはありません。必要なライブラリがインストールされていない設定は、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エンドポイントには、当然、外へ出る経路が必要です。
したがって、正確な言い方は、「セットアップなしでエアギャップ」ではなく、**「重みがマシンに置かれた後であれば、エアギャップ」**です。
関連項目
- モデルズー — 何をコピーして持ち込むか
- ガイド:エアギャップ環境でのアノテーション
- 本番環境のセットアップ
- ソースドキュメント