Linux デプロイメントチュートリアル

このドキュメントでは、Linux システムに Nekro Agent をデプロイする方法を案内します。当社のインストールスクリプトは 2 つのデプロイメントモードを提供しています。ニーズに応じて選択してください。

🚀 方法 1：標準デプロイメント（推奨）

このモードでは、Nekro Agent コアサービスと Napcat プロトコルエンドポイントをワンクリックでデプロイし、ほとんどのユーザーにおすすめの完全なソリューションです。

警告！

1. NapCat のデフォルトパスワードを必ず変更してください：パブリック WebUI では強力なパスワードを使用する必要があります（12 文字以上の数字、文字、記号を含むことを推奨）
2. Token 認証を必ず使用してください：OneBot サービスは有効な Token を設定する必要があり、空の Token や弱いパスワードは避けてください
3. セキュリティ上の理由から、デフォルトポートの使用は避けてください

デプロイメントコマンド

# Githubから（推奨）
sudo -E bash -c "$(curl -fsSL https://raw.githubusercontent.com/KroMiose/nekro-agent/main/docker/install_i18n.sh)" - --with-napcat

Github からスクリプトをダウンロードする際にネットワークの問題が発生した場合は、NekroEndpointを使用してデプロイメントスクリプトにアクセスできます：

TIP

NekroEndpointは、Cloudflare Workers 上に構築されたエッジエンドポイントオーケストレーションプラットフォームで、静的コンテンツ返信、プロキシ転送、動的スクリプト実行の 3 種類のエンドポイントをサポートしています。権限グループやアクセスキーなどのきめ細やかな権限制御を提供し、300 以上のグローバルノードを通じてミリ秒単位の応答を実現します。API プロキシ集約や Webhook 処理などのシナリオで使用できます。

# NekroEndpointから（推奨）
sudo -E bash -c "$(curl -fsSL https://ep.nekro.ai/e/KroMiose/nekro-agent/main/docker/install_i18n.sh)" - --with-napcat

ヒント:

• 上記のコマンドの--with-napcatパラメータは、完全自動の標準デプロイメントを開始します。
• このパラメータを追加しない場合、スクリプトは対話モードで開始されます。その時、Napcat をインストールするためにYを選択してください。

デプロイメント完了後、プロトコル設定-Napcatドキュメントを参照して、後続の設定を完了してください。

🚀 方法 2：コアデプロイメント

このモードでは Nekro Agent コアサービスのみをデプロイし、他のアダプタープラットフォームを使用する必要がある場合や、OneBot V11 プロトコルエンドポイントを自分で設定する必要がある上級ユーザーに適しています。

デプロイメントコマンド

以下のコマンドを実行し、スクリプトが尋ねたときに Napcat サービスをインストールしないことを選択します。

# Githubから（推奨）
sudo -E bash -c "$(curl -fsSL https://raw.githubusercontent.com/KroMiose/nekro-agent/main/docker/install_i18n.sh)"

# NekroEndpointから（CloudFlareアクセラレーション）
sudo -E bash -c "$(curl -fsSL https://ep.nekro.ai/e/KroMiose/nekro-agent/main/docker/install_i18n.sh)"

スクリプトが尋ねたとき、nと入力します：

Do you want to use napcat service at the same time? [Y/n] n

デプロイメント完了後、Nekro Agent は以下のアドレスをリッスンします。ここに OneBot V11 プロトコルエンドポイントを接続してください：

ws://<あなたのサービスIP>:8021/onebot/v11/ws

📝 注意事項

• インストールディレクトリ：

  • デフォルトのインストールは~/srv/nekro_agentにあります。
  • カスタマイズする必要がある場合は、スクリプトを実行する前に環境変数を設定してください：export NEKRO_DATA_DIR=<あなたのディレクトリ>

• ポート開放：

  • クラウドサーバーを使用している場合、セキュリティグループで必要なポートを開けてください：
  • 8021/tcp：Nekro Agent メインサービス（すべてのモードで必須）。
  • 6099/tcp：Napcat サービス（標準デプロイメントの場合のみ必須）。

• 認証情報の保存：

  • インストールスクリプト実行後、管理者パスワードやOneBot アクセストークンなどの重要な情報が出力されます。必ず適切に保存してください。

⚙️ デプロイメント後の設定

• 標準デプロイメント：プロトコル設定ドキュメントに移動し、ドキュメントに従って設定を完了してください。
• コアデプロイメント：プロトコル設定ドキュメントに移動し、指示を参考に設定を続けてください。