本文档由 AI 自动翻译。如有任何不准确之处，请参考 英文原版。
difyctl 是一个独立的二进制文件，无任何运行时依赖。安装脚本会检测你的平台，从 Dify 的 GitHub Releases 下载匹配的构建版本，校验其校验和，并完成安装。
difyctl 随 Dify 1.15.0 首次发布。每个构建版本对应特定的 Dify 版本，请安装与你的服务器相匹配的版本（见下文的 DIFY_VERSION）。
安装#
运行安装程序
每个 Dify 发布版本都会随附一个 difyctl 构建版本，安装程序默认获取最新版本。
支持的平台：macOS 和 Linux，x64 和 arm64。
脚本会安装到 ~/.local/bin/difyctl，并在该目录不在你的 PATH 中时提示你。
支持的平台：x64。
脚本会安装到 %LOCALAPPDATA%\difyctl\bin\difyctl.exe，如果该目录尚未加入 PATH，会打印将其加入 PATH 的命令。
-
从 Dify 的 GitHub Releases 中，选择与服务器 Dify 版本匹配的发布版本，并下载两个资源文件：
- 适用于你平台的二进制文件（
difyctl-v<version>-<os>-<arch>） - 校验和清单（
difyctl-v<version>-checksums.txt）
- 适用于你平台的二进制文件（
-
计算二进制文件的 SHA-256 哈希值，并与 checksums 文件中对应的条目比对。
如果两者不一致，说明下载文件已损坏或被篡改；删除它并重新下载。
-
将二进制文件加入
PATH：
如需自定义安装，可在运行安装命令时设置以下环境变量。
| 变量 | 说明 | 示例 |
|---|---|---|
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 |
例如：
验证安装
你应当看到一个 Client: 区块，其中包含版本和平台信息。
如果你看到的是 command not found，说明安装目录不在你的 PATH 中。将它加入：
更新#
要更新 difyctl，重新运行安装脚本即可，它会原地替换二进制文件。要切换到特定的 Dify 版本，按上文设置 DIFY_VERSION。
卸载#
要在卸载前退出登录，运行 difyctl auth logout。
后续步骤#
装好 difyctl 后，前往 快速开始 登录并运行你的第一个应用。