Dify

Dify：安装说明

这个工具包里只有安装说明，由 Mindket 编写。Dify 本身、它的 Docker 镜像和命令行工具来自 LangGenius 自己的仓库：https://github.com/langgenius/dify

这些说明不是 LangGenius 写的，也没有得到它的认可。它的 README 把 Dify 称为 "an open-source LLM app development platform"，意思是一个开源的大模型应用开发平台。文档从 https://docs.dify.ai 开始。

这些说明来自 README 和每个文件里列出的文档页面。它们没有对照源代码检查过，Mindket 也没有运行这些命令。

许可证

Dify 使用自己的许可证，即 Dify Open Source License。GitHub 把它列为 "Other"，没有 SPDX 标识。LICENSE 文件（https://github.com/langgenius/dify/blob/HEAD/LICENSE）说 Dify "is licensed under a modified version of the Apache License 2.0, with the following additional conditions"，意思是在 Apache License 2.0 的修改版下授权，并附有额外条件。

• 商业使用：文件说 Dify 可以商用，"including as a backend service for other applications or as an application development platform for enterprises"，也就是可以作为其他应用的后端服务，或作为企业的应用开发平台。它列出了下面两个条件，并说这两个条件适用时，"a commercial license must be obtained from the producer"，即必须向制作方取得商业许可。
• 多租户服务："Unless explicitly authorized by Dify in writing, you may not use the Dify source code to operate a multi-tenant environment."，意思是除非 Dify 书面明确授权，否则不得用 Dify 的源代码运营多租户环境。一个租户就是一个工作区。
• 标志和版权：使用 Dify 的前端时，不得删除或修改 Dify 控制台或应用里的标志和版权信息。文件说这一条不适用于不涉及前端的使用，并把前端定义为 web/ 目录或 "web" 镜像。
• 贡献者：制作方 "can adjust the open-source agreement to be more strict or relaxed as deemed necessary"，即可以按需要把开源协议调得更严或更松。贡献的代码 "may be used for commercial purposes, including but not limited to its cloud business operations"，即可以用于商业目的，包括但不限于它的云业务。
• 其余部分："all other rights and restrictions follow the Apache License 2.0"，其他权利和限制都按 Apache License 2.0。文件还写了 "The interactive design of this product is protected by appearance patent."，即这个产品的交互设计受外观专利保护。

这些说明不解释许可证。如果你打算为其他客户运行 Dify，或者发布修改过的版本，请阅读这个文件，并去问 LangGenius。

这些说明涵盖什么

Dify 是一个网页平台，背后有服务器。README 和文档给出了下面这些运行或使用它的方式：

• setup/docker-compose.md：Docker Compose，README 称它是最简单的方式，会启动整套服务。
• setup/cloud-and-other-deployments.md：LangGenius 托管的 Dify Cloud、Dify Enterprise，以及仓库的高级设置页面列出的其他部署方式。
• setup/local-source-code.md：从源代码运行 API、worker 和 web 服务。
• setup/models-and-first-app.md：添加模型提供方，以及 Workflow、Chatflow 和 Agent 分别是什么。
• setup/difyctl.md：安装命令行工具 difyctl 并登录。
• setup/claude-code.md：给 Claude Code 装上 difyctl 技能。
• setup/codex-cursor-and-other-agents.md：给 Codex、Cursor、Gemini CLI、GitHub Copilot、OpenCode 和其他智能体装同样的技能。
• setup/mcp-server.md：把 Dify 应用发布成 MCP 服务器，供 Claude Desktop 和 Cursor 使用。

事先需要准备

• 走 Docker Compose 这条路：运行着守护进程的 Docker、Docker Compose v2.35.0 或更高版本，以及 OpenSSL。README 给出的最低配置是 2 个 CPU 核心和 4 GiB 内存。来源见 https://github.com/langgenius/dify/blob/HEAD/README.md
• 至少一个模型提供方，配上它的 API 密钥和它要求的其他凭据。页面说每个 Dify 应用都需要一个。来源见 https://docs.dify.ai/en/self-host/use-dify/workspace/model-providers

主安装命令

Compose 这条路要先有源代码，所以先克隆。Docker Compose 文档页给出下面这一行，它通过 GitHub API 找到最新的发布标签。需要 git、curl 和 jq。

git clone --branch "$(curl -s https://api.github.com/repos/langgenius/dify/releases/latest | jq -r .tag_name)" https://github.com/langgenius/dify.git

然后 README 在仓库根目录运行这些命令：

cd docker
cp .env.example .env
openssl rand -hex 32

打开 .env，把 DIFY_AGENT_LOCAL_SANDBOX_AUTH_TOKEN 设成生成的值。COMPOSE_PROFILES 保持默认值。然后在同一个 docker 目录里：

docker compose up -d
docker compose ps --all

打开 http://localhost/install 完成首次设置。一次性的 init_permissions 服务按预期会以退出码 0 结束。

来源见 https://github.com/langgenius/dify/blob/HEAD/README.md 和 https://docs.dify.ai/en/self-host/deploy/quick-start/docker-compose

各平台的说明

每个文件都写明了它的步骤和命令出自哪个页面。README 和文档页面不一致的地方，文件里也会说明。

更新或卸载

Compose 文档页说，升级步骤因版本而异，所以请阅读 Releases 页面上目标版本的升级指南。升级之后，把每个 .env.example 和对应的 .env 比较一下，看有没有新增或变化的变量。FAQ 页面说升级前要先备份，并给出下面这一行来复制 dify 文件夹：

cp -r dify "dify.bak.$(date +%Y%m%d%H%M%S)"

来源见 https://docs.dify.ai/en/self-host/deploy/quick-start/docker-compose 和 https://docs.dify.ai/en/self-host/deploy/quick-start/faqs

这里用到的页面没有给出卸载步骤。

使用数据和对外连接

模型提供方页面警告说，API 密钥会给出整个工作区使用模型的权限，并向密钥背后的提供方账户计费。来源见 https://docs.dify.ai/en/self-host/use-dify/workspace/model-providers

环境变量页面列出了自托管 Dify 的这些对外连接。来源见 https://docs.dify.ai/en/self-host/deploy/configuration/environments

• CHECK_UPDATE_URL 默认是 https://updates.dify.ai。控制台用它检查新版本，设为空就关掉这项检查。
• MARKETPLACE_ENABLED 默认是 true，MARKETPLACE_API_URL 默认是 https://marketplace.dify.ai。插件从这里来，FORCE_VERIFYING_SIGNATURE 默认是 true，所以未签名的插件包会被拒绝。
• NEXT_TELEMETRY_DISABLED 默认是 0。页面说，除非你把它设成 1，否则 Compose 部署会让 Next.js 的匿名遥测保持开启。
• WEAVIATE_DISABLE_TELEMETRY 默认是 false，所以除非设成 true，Weaviate 的遥测保持开启。
• ENABLE_CHECK_UPGRADABLE_PLUGIN_TASK 默认是 true：每 15 分钟检查一次市场里有没有更新版本的插件。
• Sentry 的 DSN 设置默认为空，页面说 API_SENTRY_DSN 为空就会关闭后端的 Sentry。OpenTelemetry 在 ENABLE_OTEL 设为 true 之前保持关闭。

来源

• README：https://github.com/langgenius/dify/blob/HEAD/README.md
• 许可证：https://github.com/langgenius/dify/blob/HEAD/LICENSE
• Docker 部署：https://github.com/langgenius/dify/blob/HEAD/docker/README.md
• 高级设置：https://github.com/langgenius/dify/blob/HEAD/docs/ADVANCED_SETUP.md
• 部署 Dify：https://docs.dify.ai/en/self-host/deploy/overview
• Docker Compose：https://docs.dify.ai/en/self-host/deploy/quick-start/docker-compose
• FAQ：https://docs.dify.ai/en/self-host/deploy/quick-start/faqs
• 本地源代码：https://docs.dify.ai/en/self-host/deploy/advanced-deployments/local-source-code
• 环境变量：https://docs.dify.ai/en/self-host/deploy/configuration/environments
• 模型提供方：https://docs.dify.ai/en/self-host/use-dify/workspace/model-providers
• Workflow 和 Chatflow：https://docs.dify.ai/en/self-host/use-dify/build/workflow-chatflow
• Agent：https://docs.dify.ai/en/self-host/use-dify/build/new-agent/overview
• MCP 服务器：https://docs.dify.ai/en/self-host/use-dify/publish/publish-mcp
• difyctl 概览：https://docs.dify.ai/en/cli/overview
• difyctl 快速开始：https://docs.dify.ai/en/cli/get-started
• difyctl 登录：https://docs.dify.ai/en/cli/manage-sign-in