Skip to main content
このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、英語版 を参照してください。
リモートデバッグは、プラグインを反復開発する最も速い方法です。プラグインのプロセスを手元のノート PC で実行すると、Dify はそれをワークスペースにインストールされたプラグインとして扱います。編集を保存してプロセスを再起動すれば、変更がすぐに反映されます。

​
前提条件

  • 右上で プラグイン にアクセスできる Dify ワークスペース。
  • 雛形を作成済みのプラグインプロジェクト（未作成の場合は CLI を参照してください）。
  • Python 3.12 とプラグインの依存関係がインストール済みであること（pip install -r requirements.txt）。

​
ステップ 1：デバッグ URL と Key を取得する

Dify で プラグイン ページを開き、デバッグアイコン（プラグインをインストール の隣にある小さな虫のアイコン）をクリックします。ダイアログに リモートインストール用の host:port と API key が表示されます。
リモートデバッグプラグイン
host は debug-plugin.dify.dev:5003 のような形式です。Key はワークスペースごとに固有で、これを持つ人は誰でもプラグインを接続できるため、共有しないでください。

​
ステップ 2：プラグインの .env を設定する

プラグインプロジェクトで .env.example を .env にコピーし、値を入力します。 
INSTALL_METHOD=remote
REMOTE_INSTALL_URL=debug-plugin.dify.dev:5003
REMOTE_INSTALL_KEY=********-****-****-****-************
REMOTE_INSTALL_URL はステップ 1 の host:port を結合したものであり、2 つの別々の変数ではありません。

​
ステップ 3：プラグインを実行する

プラグインプロジェクトのディレクトリで実行します。 
pip install -r requirements.txt
python -m main
プロセスはフォアグラウンドで実行され続け、受信した呼び出しをログに記録します。コードを編集したらプロセスを再起動して変更を適用します。

​
ステップ 4：インストールを確認する

Dify の プラグイン ページに戻ります。プラグインが一覧に表示され、デバッグマーカーが付きます。ワークスペースの他のメンバーもこれを確認して使用できます。
ワークスペースにインストールされたプラグイン
プラグインのタイルにデバッグインジケーターが表示され、ローカルのターミナルに最初の登録ハンドシェイクがログ出力されます。接続完了です。
他のプラグインと同じようにトリガーします。ワークフローノードから呼び出す、Agent 内でツールとして実行する、またはエンドポイント URL にアクセスします。呼び出しはローカルのプロセスに届き、デバッガーを接続できます。

​
トラブルシューティング

デーモンが REMOTE_INSTALL_URL に指定したアドレスでリッスンしていません。セルフホスト構成では、デーモンコンテナに PLUGIN_REMOTE_INSTALLING_ENABLED=true が設定され、ポート 5003 が公開されていることを確認してください。クラウドでは、コピーした host:port がデバッグダイアログに表示されたものと完全に一致しているか再確認してください。
最も多い原因は、REMOTE_INSTALL_KEY が古いか誤っていることです。デバッグダイアログから Key を再生成し、python -m main を再実行してください。また、デーモンのログに受信した登録が記録されているか確認してください。
manifest.yaml または provider/*.yaml の author フィールドが、デーモンが受け付ける値と一致していません。自分の GitHub ハンドルに設定してから再起動してください。
プラグインのプロセスは編集のたびに再起動が必要で、ホットリロードはありません。Ctrl+C で停止し、python -m main を再実行してください。

​
関連リソース

Last modified on June 25, 2026