Skip to main content
本文档由 AI 自动翻译。如有任何不准确之处,请参考 英文原版。
个人访问令牌需要 Dify 1.20.0 及以上版本。
有了个人访问令牌,difyctl 不用登录也能以你的身份操作。它和登录的区别在于能用多久、能运行什么: 如果 CI 任务或编码 Agent 要运行应用或配置集成,就交给它一个令牌,这样它能一直工作,不用有人去续期登录。 需要修改应用时,例如通过 DSL 文件更新或发布应用,改为给任务一个 登录令牌,编码 Agent 则照旧 以你自己的登录身份 工作。

选择账户和访问范围

每个任务单独用一个个人访问令牌,这样修改、替换或删除某个令牌时,不会牵连其他任务。 团队依赖的任务,用自动化专用的账户创建令牌。这样即使你自己的权限有变,任务也能照常运行,而且它的运行记录很容易和你的区分开。把这个账户加入任务操作的每个工作空间,角色按任务在该工作空间中要运行的命令来定。 在 账户页面 创建令牌时,只启用任务需要的访问范围。之后也可修改:改动从令牌执行下一条命令时生效,不用给任务换新令牌。
下面每条命令还需满足 命令索引 中列出的使用条件,例如角色要求,或应用已开启服务 API 访问。

允许令牌运行应用

任务要做以下任何一件事时,为令牌启用 资源 范围:

允许令牌配置集成

任务要做以下任何一件事时,为令牌启用 管理工作空间 范围:

把令牌交给 difyctl

1

查找工作空间 ID

任务要列出应用或配置集成时,需要它所操作的每个工作空间的 ID。运行 difyctl get workspace,复制每个工作空间的 id。编码 Agent 可自行查到这些 ID。
2

设置环境变量

  • DIFY_SERVER:你打开 Dify 时用的地址,例如 https://dify.example.com。
  • DIFY_TOKEN:令牌。
  • DIFY_WORKSPACE_ID:上一步查到的工作空间 ID(如有)。 如果任务要操作多个工作空间,改为用 --workspace-id 给每条命令传入对应工作空间的 ID。
具体怎么设置,取决于由谁来运行 difyctl:设置了 DIFY_TOKEN 时,命令会改用这些变量,不再使用你已保存的登录信息。
3

检查令牌

在设置了这些变量的 Shell 中,确认令牌能访问任务要用的应用和工作空间:
  • 如果令牌能运行应用,按 ID 查看任务用到的一个应用:
    应用的 ID 可从它在工作室中的地址(/app/<app-id>/…)复制。如果设置了 DIFY_WORKSPACE_ID,也可运行 difyctl get console_app 列出它。
  • 如果令牌只能管理工作空间,运行 difyctl describe account 列出它可管理的工作空间,确认任务要操作的工作空间都在其中。
如果检查失败,到 故障排查 中查找对应的错误信息。

故障排查

其他错误详见「结果、错误与退出码」中的 故障排查。
Last modified on November 18, 2026