安装 difyctl

difyctl 是一个独立的二进制文件，无任何运行时依赖。安装脚本会检测你的平台，从 Dify 的 GitHub Releases 下载匹配的构建版本，校验其校验和，并完成安装。

每个 difyctl 构建都对应特定的 Dify 版本，安装与服务器匹配的构建（见下文 DIFY_VERSION）。

安装

运行安装程序

每个 Dify 发布版本都会随附一个 difyctl 构建版本。Dify Enterprise 3.12.x 运行的是 Dify 1.16.1，安装对应构建：

macOS / Linux
Windows
手动下载

支持的平台：macOS 和 Linux，x64 和 arm64。

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

脚本会安装到 ~/.local/bin/difyctl，并在该目录不在你的 PATH 中时提示你。

支持的平台：x64。

$env:DIFY_VERSION = "1.16.1"
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>
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.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 ends
export 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 后，选择与你登录 dify.example.com 的方式相匹配的路径：

账户用户

登录你的 Dify 账户，可使用邮箱和密码，或所在组织的 SSO。

外部 SSO 用户

没有 Dify 账户：通过外部 SSO 登录，运行管理员授权给你的特定应用。

入门

账户用户

外部 SSO 用户

集成你的 Agent

命令参考

故障排查

安装

更新

卸载

后续步骤

账户用户

外部 SSO 用户

​安装

​更新

​卸载

​后续步骤

账户用户

外部 SSO 用户

安装

更新

卸载

后续步骤