ZimaOSでのGPTWOL：カスタムYAMLとWake-on-LANの設定

GPTWOLはZimaOS上でカスタムDockerアプリケーションとして実行できますが、コミュニティYAMLで重要なのは、古いサンプル認証情報ではありません。アプリケーションには、ローカルネットワーク上でWake-on-LANパケットを送信するためのホストネットワーク、データベースとcronデータを保存するための永続ストレージ、そして他のサービスでまだ使用されていないWebポートが必要です。

2026年1月のスレッドは、動作する構成のスナップショットとして役立ちますが、GPTWOLとZimaOSはどちらも進化しています。現在のGPTWOLドキュメントでもWake-on-LANにはホストネットワークが必要とされており、現在のZimaOSリリースでは、より高機能なYAMLワークフローが提供されています。ソースファイルは出発点として扱い、インポートする前に現在のアップストリームのオプションを確認してください。

コミュニティYAMLで設定されていた内容

共有されたアプリケーション定義では、misterbabou/gptwol:latestイメージ、network_mode: host、restart: unless-stoppedが使用されていました。また、ホスト上の2つのフォルダーを/app/dbと/etc/cron.dにマッピングし、GPTWOLの状態を永続化していました。

ソース構成では、GPTWOLのインターフェースをポート99で公開し、スケジュールされた起動ジョブ用のタイムゾーンを設定していました。これらの値は共通のものではありません。空いているホストポートを選び、コンテナを実行するマシンに合ったタイムゾーンを使用してください。

ZimaOSコミュニティユーザーが共有したGPTWOLのWake Machineインターフェース — 元の投稿では、GPTWOLがローカルネットワーク上のデバイス向けにシンプルなWake Machineインターフェースを提供している様子が示されています。

GPTWOLがホストネットワークを使用する理由

GPTWOLの現在のアップストリームドキュメントでは、LAN上でWake-on-LANコマンドを送信するために、コンテナでホストネットワークモードを使用する必要があると説明されています。これは、通常のWebアプリケーションがDockerのブリッジネットワークによる分離と単一の公開ポートで動作できる場合とは異なります。

ホストネットワークを使用すると、ポートの考え方も変わります。アプリケーションはZimaOSホストのネットワーク上で直接待ち受けるため、GPTWOLに選択したポートはあらかじめ空いていなければなりません。Webページが開かない場合は、無関係なルーター設定を変更する前に、設定したポートを確認し、別のサービスがそのポートで待ち受けていないか確認してください。

現在のGPTWOL Docker構成では、必要なネットワークモード、ストレージパス、認証オプション、スケジュール機能について説明されています。

サンプルのログイン認証情報を再利用しない

コミュニティYAMLではローカル認証が有効にされ、簡単なサンプル認証情報が使用されていました。これらは投稿者がアプリをどのように設定したかを示すものであり、新規インストールにそのままコピーする安全なデフォルト値ではありません。

ローカル認証を有効にする場合は、実際にデプロイする前に、公開されているサンプルのユーザー名とパスワードを変更してください。現在のGPTWOLはOIDCにも対応しています。いずれの場合も、適切な認証なしにサービスを直接パブリックインターネットへ公開しないよう、アップストリームプロジェクトは警告しています。

Wake-on-LANは通常、LAN内を制御する機能です。外出先から起動を実行する必要がある場合は、GPTWOLのWebインターフェースをパブリックポートに直接公開するのではなく、安全なリモートアクセス層を使用してください。

現在のZimaOSでYAMLをインポートまたは編集する

2026年1月のスレッドは、現在のApp Store 2.0のYAMLエクスペリエンスより前のものです。ZimaOS 1.7ではアプリケーションのネイティブYAML編集機能が導入され、ZimaOS 1.7.1ではYAML保存の互換性がさらに改善されました。そのため、元の投稿にあるスクリーンショットやボタンの位置は、現在のインターフェースと一致しない可能性があります。

Composeのサービス定義は、イメージ、ホストネットワーク、再起動ポリシー、必要な環境変数、永続ボリュームというシンプルな構成にしてください。エクスポートされたファイルに含まれていたという理由だけで、古いx-casaosメタデータを引き継がないでください。現在のZimaOSアプリワークフローで実際に必要な場合にのみ使用します。

ZimaOS 1.7.1リリースノートでは、現在のYAML互換性の改善について説明されています。

GPTWOLでは、対応していないターゲットでWOLを有効にできない

GPTWOLは起動パケットを送信するだけであり、互換性のないコンピューターをWake-on-LAN対応にすることはできません。ターゲットマシンでは、ファームウェアとオペレーティングシステムの両方でWake-on-LANを有効にする必要があり、目的の電源状態でもネットワークアダプターがマジックパケットを受信できる状態を維持していなければなりません。

コンテナを調査する前に、同じLAN上にある別の動作確認済みWOLツールでターゲットを起動できることを確認してください。それが成功したら、GPTWOLをテストします。どのツールでもターゲットを起動できない場合は、まずターゲットのBIOS、NIC、シャットダウン状態、ネットワーク経路を調査してください。