difyctl のインストール

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

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

Note

difyctl は Dify 1.15.0 で導入されました。各ビルドは特定の Dify バージョンに対応しているため、お使いのサーバーに合うものをインストールしてください（下記の DIFY_VERSION を参照）。

インストール#

インストーラーの実行

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>
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-NullMove-Item difyctl-v<version>-windows-x64.exe "$env:LOCALAPPDATA\difyctl\bin\difyctl.exe"

Tip

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

変数	説明	例
`DIFY_VERSION`	`difyctl` を取得する Dify リリースタグ。Dify Releases のタグと一致させる。既定は最新リリース。サーバーが最新でない場合は、そのリリースタグを指定する。	`1.16.1`
`DIFYCTL_VERSION`	特定の `difyctl` ビルドに固定する。`DIFY_VERSION` が未設定のときのみ使用される。	`0.2.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.16.1 sh

# PowerShell にインライン形式はなく、設定はそのセッションの間ずっと有効です$env:DIFY_VERSION = "1.16.1"irm https://raw.githubusercontent.com/langgenius/dify/main/cli/scripts/install.ps1 | iex

インストールの確認

difyctl version

バージョンとプラットフォームを含む Client: ブロックが表示されるはずです。

代わりに command not found が表示される場合、インストールディレクトリが PATH に含まれていません。次のように追加します：

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

[Environment]::SetEnvironmentVariable('PATH', "$env:LOCALAPPDATA\difyctl\bin;$env:PATH", 'User')

アップデート#

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

アンインストール#

rm ~/.local/bin/difyctl

Remove-Item -Recurse "$env:LOCALAPPDATA\difyctl"

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

次のステップ#

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