difyctl のインストール

このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、英語版を参照してください。

difyctl はランタイム依存のない単体のバイナリです。インストールスクリプトがお使いのプラットフォームを検出し、Dify の GitHub Releases から対応するビルドをダウンロードして、チェックサムを検証し、バイナリを配置します。

difyctl には Dify 1.15.0 以降が必要です。

インストール

インストーラーの実行

difyctl のビルドは Dify の各リリースに同梱され、インストーラーはデフォルトで最新版を取得します。

サポートするプラットフォーム：macOS と Linux、x64 と arm64。

curl -fsSL https://raw.githubusercontent.com/langgenius/dify/main/cli/scripts/install-cli.sh | sh

スクリプトは ~/.local/bin/difyctl にインストールし、そのディレクトリが PATH に含まれていない場合は通知します。

サポートするプラットフォーム：x64。

irm https://raw.githubusercontent.com/langgenius/dify/main/cli/scripts/install.ps1 | iex

スクリプトは %LOCALAPPDATA%\difyctl\bin\difyctl.exe にインストールし、そのディレクトリがまだ PATH にない場合は、PATH に追加するコマンドを表示します。

Dify の GitHub Releases から、サーバーの Dify バージョンに合うリリースを選び、2 つのアセットをダウンロードします：
- お使いのプラットフォーム向けのバイナリ（difyctl-v<version>-<os>-<arch>）
- チェックサムマニフェスト（difyctl-v<version>-checksums.txt）
バイナリの SHA-256 ハッシュを計算し、checksums ファイル内の対応するエントリと比較します。値が一致しない場合、ダウンロードは破損しているか改ざんされています。削除して再度ダウンロードしてください。
shasum -a 256 difyctl-v<version>-<os>-<arch>

バイナリを PATH に配置します：

chmod +x difyctl-v<version>-<os>-<arch>
mv difyctl-v<version>-<os>-<arch> ~/.local/bin/difyctl

インストールをカスタマイズするには、インストールコマンドに次の環境変数を設定します。

変数	説明
`DIFY_VERSION`	`difyctl` を取得する Dify リリースタグ。既定は最新リリース。サーバーが最新でない場合は、そのリリースタグを指定する。
`DIFYCTL_VERSION`	特定の `difyctl` ビルドに固定する。`DIFY_VERSION` が未設定のときのみ使用される。
`DIFYCTL_PREFIX`	インストール先ディレクトリ（既定は `~/.local`）。バイナリは `<prefix>/bin` に配置される。

例：

curl -fsSL https://raw.githubusercontent.com/langgenius/dify/main/cli/scripts/install-cli.sh | DIFY_VERSION=<dify-version> sh

インストールの確認

difyctl version

バージョンとプラットフォームを含む Client: ブロックが表示されるはずです。代わりに command not found が表示される場合、インストールディレクトリが PATH に含まれていません。次のように追加します：

# add to ~/.zshrc or ~/.bashrc; running it inline only lasts until the session ends
export PATH="$HOME/.local/bin:$PATH"

difyctl をアップデートするには、インストールスクリプトを再実行します。既存のバイナリがそのまま置き換わります。特定の Dify バージョンに切り替えるには、上記のとおり DIFY_VERSION を設定します。

rm ~/.local/bin/difyctl

アンインストール前にサインアウトするには、difyctl auth logout を実行します。

difyctl をインストールしたら、クイックスタートに進んでサインインし、最初のアプリを実行します。