本文档由 AI 自动翻译。如有任何不准确之处，请参考 英文原版。
difyctl 是一个独立的二进制文件，无任何运行时依赖。安装脚本会检测你的平台，从 Dify 的 GitHub Releases 下载匹配的构建版本，校验其校验和，并完成安装。
difyctl 需要 Dify 1.15.0 或更高版本。
运行安装程序
每个 Dify 发布版本都会随附一个 difyctl 构建版本，安装程序默认获取最新版本。 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 版本匹配的发布版本，并下载两个资源文件：
- 适用于你平台的二进制文件（
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
验证安装
你应当看到一个 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。
要在卸载前退出登录，运行 difyctl auth logout。
后续步骤
装好 difyctl 后，前往 快速开始 登录并运行你的第一个应用。
