Dockerデプロイ

1. 環境を準備する

• Git をインストールします。
• Windows / macOS：Docker Desktop をインストールして起動します。
• Linux：Docker と Docker Compose をインストールします。

2. プロジェクトをダウンロードする

書き込み権限のある通常のディレクトリを選んでください。Linux では /root や /etc などのシステムディレクトリを避け、/opt 配下を推奨します。これにより、安全規則によるサンドボックス機能の拒否を避けられます。

プロジェクトを保存したいディレクトリでターミナルを開き（Windows では PowerShell を使用できます）、1 行ずつ実行します：

git clone https://github.com/langbot-app/LangBot
cd LangBot/docker

中国本土：起動前にミラーへ変更する（任意）

Docker Hub からのダウンロードが遅い場合は、先に LangBot/docker/docker-compose.yaml を編集し、すべての rockchin/langbot:latest を次の値に置き換えてください：

docker.langbot.app/langbot-public/rockchin/langbot:latest

保存してから起動してください。ほかの設定変更は不要です。

3. LangBot を起動する

同じターミナルで実行します：

docker compose --profile all up -d

初回はコンテナイメージをダウンロードします。Windows / macOS では Docker Desktop を起動したままにしてください。

4. 管理画面を開く

• ローカルにインストールした場合：http://localhost:5300 を開きます。
• サーバーにインストールした場合：http://サーバーのIP:5300 を開きます。ファイアウォールで自分の端末からこのポートへのアクセスを許可してください。

画面の案内に従って初期設定を完了し、モデルとボットを追加してください。

Beta 版（任意）

上記の安定版の代わりに Beta を試す場合は、dev/4.11.x の Compose ファイルを別の書き込み可能なディレクトリに compose.yaml として保存します。すべての rockchin/langbot イメージを手動で rockchin/langbot:beta に変更してください。対象は Core（langbot）、プラグインランタイム（langbot_plugin_runtime）、Box（langbot_box がある場合）です。beta タグは Beta リリースごとに更新されます。そのディレクトリで次を実行して起動・更新します：

docker compose --profile all pull
docker compose --profile all up -d