NekroAgent ドキュメント

日本語

简体中文
English

日本語

简体中文
English

Appearance

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

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

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

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

警告！

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

デプロイメントコマンド ​

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

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

TIP

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

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

ヒント:

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

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

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

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

デプロイメントコマンド ​

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

bash
# Githubから（推奨）
sudo -E bash -c "$(curl -fsSL https://raw.githubusercontent.com/KroMiose/nekro-agent/main/docker/install.sh)"
bash
# GitCodeから（国内アクセラレーション）
sudo -E bash -c "$(curl -fsSL https://raw.gitcode.com/gh_mirrors/ne/nekro-agent/raw/main/docker/install.sh)"

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

text
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アクセストークンなどの重要な情報が出力されます。必ず適切に保存してください。

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

  • 標準デプロイメント：プロトコル設定ドキュメントに移動し、ドキュメントに従って設定を完了してください。
  • コアデプロイメント：プロトコル設定ドキュメントに移動し、指示を参考に設定を続けてください。
ドキュメントに問題がありますか？問題を報告