> ## Documentation Index
> Fetch the complete documentation index at: https://enterprise-docs.dify.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 個人 GitHub リポジトリへの公開

> Dify プラグインを自分の GitHub リポジトリから配布し、ユーザーがリポジトリ URL から直接インストールできるようにします。マーケットプレイスの審査は不要です

個人の GitHub リポジトリで公開すると、Dify マーケットプレイスの審査を経ずにプラグインを配布できます。ユーザーはリポジトリ URL を入力し、`.difypkg` アセットを含むリリースを選択することでプラグインをインストールします。

次のような場合に適しています。

* バージョン管理とリリースのペースを完全に管理したい場合。
* プラグインがオープンソースで、他のユーザーに閲覧、フォーク、貢献してもらいたい場合。
* プラグインをチームや組織の内部で利用するが、統一されたインストール URL を 1 つ用意したい場合。
* プラグインがマーケットプレイスの審査待ちで、暫定的な配布チャネルが必要な場合。

他の公開方法との比較については、[公開の概要](/ja/3.10.x/develop/plugins/publishing/marketplace-listing/release-overview) を参照してください。

## 前提条件

* パッケージ化されたプラグイン（`.difypkg` ファイル）。まだない場合は、[ローカルファイルとしてパッケージ化して共有する](/ja/3.10.x/develop/plugins/publishing/marketplace-listing/release-by-file) を参照してください。
* GitHub アカウント。
* あなた（またはユーザー）がプラグインをインストールする権限を持つ Dify ワークスペース。

## ステップ 1：GitHub リポジトリの作成

<Steps>
  <Step title="リポジトリを作成する">
    GitHub で新しいパブリックリポジトリを作成します。名前は通常、プラグイン名に合わせます（例：`dify-plugin-flomo`）。
  </Step>

  <Step title="プラグインのソースをプッシュする">
    プラグインプロジェクトで git を初期化し、ソースコードをプッシュします。

    ```bash theme={null}
    cd your_plugin_project
    git init
    git add .
    git commit -m "initial commit"
    git branch -M main
    git remote add origin https://github.com/<your-handle>/<repo-name>.git
    git push -u origin main
    ```
  </Step>

  <Step title="マニフェストを確認する">
    `manifest.yaml` および `provider/*.yaml` の `author` フィールドは、あなたの GitHub ハンドルと一致している必要があります。一致しない場合、ユーザーがインストールしようとしたときに `plugin_unique_identifier is not valid` が発生します。マニフェストの詳細については、[一般仕様](/ja/3.10.x/develop/plugins/features-and-specs/plugin-types/general-specifications) を参照してください。
  </Step>
</Steps>

## ステップ 2：プラグインパッケージのビルド

プラグインプロジェクトの **1 つ上** のディレクトリで、次を実行します。

```bash theme={null}
dify plugin package ./your_plugin_project
```

これにより、カレントディレクトリに `your_plugin_project.difypkg` が生成されます。

## ステップ 3：GitHub リリースの公開

Dify は GitHub リリースを通じて、プラグインのインストール可能なバージョンを検出します。

<Steps>
  <Step title="リリースにタグを付ける">
    リポジトリのページで **Releases** > **Draft a new release** をクリックします。セマンティックバージョニングを使って新しいタグを作成します（例：`v0.0.1`）。タグは `manifest.yaml` の `version` フィールドと一致させます。
  </Step>

  <Step title=".difypkg ファイルを添付する">
    リリースフォームで、`.difypkg` ファイルを **Assets** エリアにドラッグします。ユーザーがあなたのリポジトリからインストールする際、Dify はこのアセットを読み込みます。
  </Step>

  <Step title="公開する">
    変更内容を説明するリリースノートを追加し、**Publish release** をクリックします。
  </Step>
</Steps>

<Tip>
  新しいバージョンごとに、ステップ 2 とステップ 3 を繰り返します。まず `manifest.yaml` の `version` を上げ、再パッケージ化してから、新しいタグとリリースを作成します。
</Tip>

## ステップ 4：リポジトリからのインストール

リポジトリ URL をユーザーに共有します。ユーザーは Dify で次の手順でインストールします。

<Steps>
  <Step title="プラグインページを開く">
    Dify で、右上の **プラグイン** に移動します。
  </Step>

  <Step title="GitHub からインストールする">
    **プラグインをインストールする** > **GitHub からインストールする** をクリックします。
  </Step>

  <Step title="リポジトリ情報を入力する">
    リポジトリ URL を貼り付け（例：`https://github.com/<your-handle>/<repo-name>`）、ドロップダウンからバージョンを選択します。Dify はそのリリースから、一致する `.difypkg` アセットを取得します。
  </Step>

  <Step title="インストールを確認する">
    プラグインが要求する権限を確認し、**インストール** をクリックします。
  </Step>
</Steps>

<Check>
  **インストール** をクリックしてから数秒以内に、ユーザーのプラグインページにプラグインが表示されます。Dify は必要に応じて、あなたの GitHub リリースから `.difypkg` を取得します。
</Check>

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

* **`plugin_unique_identifier is not valid`**：`manifest.yaml`（および `provider/*.yaml`）の `author` フィールドが、リポジトリを所有する GitHub ハンドルと一致していません。フィールドを更新し、再パッケージ化して再リリースしてください。
* **インストールダイアログにバージョンが表示されない**：リリースに `.difypkg` アセットが添付されていないか、リポジトリにまだリリースがありません。GitHub でリリースを開き、アセットが **Assets** に表示されていることを確認してください。
* **署名検証エラー**：セルフホストの Dify インスタンスでは、署名検証が有効になっている場合があります。リリースに署名するには [サードパーティ署名検証](/ja/3.10.x/develop/plugins/publishing/standards/third-party-signature-verification) を、バイパスのオプションについては [FAQ](/ja/3.10.x/develop/plugins/publishing/faq/faq) を参照してください。

## 関連リソース

* [公開の概要](/ja/3.10.x/develop/plugins/publishing/marketplace-listing/release-overview)：公開方法を比較します。
* [ローカルファイルとしてパッケージ化して共有する](/ja/3.10.x/develop/plugins/publishing/marketplace-listing/release-by-file)：`.difypkg` パッケージをビルドします。
* [Dify マーケットプレイスへの公開](/ja/3.10.x/develop/plugins/publishing/marketplace-listing/release-to-dify-marketplace)：公式マーケットプレイスから提出します。
* [サードパーティ署名検証](/ja/3.10.x/develop/plugins/publishing/standards/third-party-signature-verification)：検証済みインストールのためにパッケージに署名します。
* [一般仕様](/ja/3.10.x/develop/plugins/features-and-specs/plugin-types/general-specifications)：マニフェストフィールドのリファレンス。

***

[Edit this page](https://github.com/langgenius/dify-docs/edit/main/en/develop-plugin/publishing/marketplace-listing/release-to-individual-github-repo.mdx) | [Report an issue](https://github.com/langgenius/dify-docs/issues/new?template=docs.yml)
