difyctl はランタイム依存のない単体のバイナリです。インストールスクリプトがお使いのプラットフォームを検出し、Dify の GitHub Releases から対応するビルドをダウンロードして、チェックサムを検証し、バイナリを配置します。
difyctl には Dify Enterprise 3.11.0 以降が必要です。
インストール
インストーラーの実行
difyctl のビルドは Dify の各リリースに同梱され、インストーラーはデフォルトで最新版を取得します。 macOS / Linux
Windows
手動ダウンロード
サポートするプラットフォーム：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>
Get-FileHash difyctl-v<version>-windows-x64.exe
-
バイナリを
PATH に配置します：
chmod +x difyctl-v<version>-<os>-<arch>
mv difyctl-v<version>-<os>-<arch> ~/.local/bin/difyctl
New-Item -ItemType Directory -Force "$env:LOCALAPPDATA\difyctl\bin" | Out-Null
Move-Item difyctl-v<version>-windows-x64.exe "$env:LOCALAPPDATA\difyctl\bin\difyctl.exe"
インストールをカスタマイズするには、インストールコマンドに次の環境変数を設定します。| 変数 | 説明 | 例 |
|---|
DIFY_VERSION | difyctl を取得する Dify リリースタグ。Dify Releases のタグと一致させる。
既定は最新リリース。サーバーが最新でない場合は、そのリリースタグを指定する。 | 1.15.0 |
DIFYCTL_VERSION | 特定の difyctl ビルドに固定する。DIFY_VERSION が未設定のときのみ使用される。 | 0.1.0-alpha |
DIFYCTL_PREFIX | インストール先ディレクトリ（既定は ~/.local）。バイナリは <prefix>/bin に配置される。 | /usr/local |
curl -fsSL https://raw.githubusercontent.com/langgenius/dify/main/cli/scripts/install-cli.sh | DIFY_VERSION=1.15.0 sh
# PowerShell にインライン形式はなく、設定はそのセッションの間ずっと有効です
$env:DIFY_VERSION = "1.15.0"
irm https://raw.githubusercontent.com/langgenius/dify/main/cli/scripts/install.ps1 | iex
インストールの確認
バージョンとプラットフォームを含む 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"
[Environment]::SetEnvironmentVariable('PATH', "$env:LOCALAPPDATA\difyctl\bin;$env:PATH", 'User')
アップデート
difyctl をアップデートするには、インストールスクリプトを再実行します。既存のバイナリがそのまま置き換わります。特定の Dify バージョンに切り替えるには、上記のとおり DIFY_VERSION を設定します。
アンインストール
Remove-Item -Recurse "$env:LOCALAPPDATA\difyctl"
difyctl auth logout を実行します。
次のステップ
difyctl をインストールしたら、dify.example.com へのサインイン方法に合ったパスを選びます：
アカウントユーザー
Dify アカウントにサインインします。メールアドレスとパスワード、または所属組織の SSO を使用します。
外部 SSO ユーザー
Dify アカウントなし：外部 SSO 経由でサインインし、許可された特定のアプリを実行します。
