メインコンテンツへスキップ
このセクションでは、WSL 2、Ubuntu、Docker Desktop、Ayakaleaf Toolkit を使用して、Windows 上でローカルに Ayakaleaf Pro を実行します。このガイドでは http://localhost:8080 を使用し、データを Ubuntu のホームディレクトリに保存し、サンドボックスコンパイルを有効にします。 アプリケーション、MongoDB、Redis、TeX Live は、Docker Desktop が管理する Linux コンテナ内で実行されます。Toolkit のコマンドは Ubuntu で実行し、アプリケーションは Windows のブラウザーで開きます。ステップ 0 では、Windows と Linux の各部分がどのように連携するかを説明し、WSL のインストールから始めます。 Windows はローカルインスタンスとして使用することも、ステップ 6 の可用性の設定によって継続的に稼働させることもできます。共有サーバーや本番サーバーには、HTTPS、バックアップ、アクセス制御を備えた Linux ガイドをおすすめします。Windows のスリープ、Docker Desktop のシャットダウン、WSL のシャットダウンにより、このローカルインスタンスは中断されます。インスタンスを利用可能な状態に保つを参照してください。

始める前に

必要なもの:
  • Docker Desktop for Windows がサポートする Windows のバージョンとプロセッサーで、ハードウェア仮想化が有効になっていること。このガイドでは x86-64 上の Windows 11 を使用します。
  • WSL を有効にし、ソフトウェアをインストールする権限。WSL はバージョン 2.1.5 以降で、Ubuntu が WSL 2 モードで実行されている必要があります。
  • Windows とコンテナに十分なメモリ。小規模なローカルインスタンスの場合、Docker で利用可能な 4 CPU と 8 GB は推奨される出発点であり、測定された最小要件ではありません。
  • WSL と Docker のデータを保存する Windows のディスクの空きストレージ。フル TeX Live 構成とプロジェクトデータ用に少なくとも 40 GB を確保してください。ステップ 5 の basic イメージはより小さく、最初のデプロイテストに適しています。イメージのバージョンを追加するには、追加の容量が必要です。
  • Toolkit のクローンとイメージのダウンロードのための、GitHub、GitHub Container Registry(ghcr.io)、Docker Hub へのネットワークアクセス。
PowerShell のブロックは Windows で実行します。Bash のブロックと bin/ のコマンドは、特に記載がない限り Ubuntu で実行します。Toolkit のスクリプトを PowerShell や Windows の Git Bash で実行しないでください。

手順

0. WSL 2 と Docker Desktop のセットアップ

1. Toolkit をダウンロードする

2. Toolkit に慣れる

3. 設定の初期化

4. Ayakaleaf Pro イメージの取得

5. インスタンスのカスタマイズ

6. インストール後のタスク

最終更新日 2026年11月8日