> ## 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 つ用意したい場合。
* プラグインがマーケットプレイスの審査待ちで、暫定的な配布チャネルが必要な場合。

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

## 前提条件

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

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

**1. リポジトリを作成する**

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

**2. プラグインのソースをプッシュする**

プラグインプロジェクトで 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
```

**3. マニフェストを確認する**

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

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

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

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

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

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

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

**1. リリースにタグを付ける**

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

**2. .difypkg ファイルを添付する**

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

**3. 公開する**

変更内容を説明するリリースノートを追加し、**Publish release** をクリックします。

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

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

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

**1. プラグインページを開く**

Dify で、右上の **プラグイン** に移動します。

**2. GitHub からインストールする**

**プラグインをインストールする** > **GitHub からインストールする** をクリックします。

**3. リポジトリ情報を入力する**

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

**4. インストールを確認する**

プラグインが要求する権限を確認し、**インストール** をクリックします。

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

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

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

## 関連リソース

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.