主机资讯与使用指南

Dify Docker Compose 部署：环境配置、初始化与模型接入

按官方 Compose 目录部署 Dify，修改环境文件，完成管理员初始化与模型提供方设置。

Dify 要同时运行多个服务

Dify 包含应用、任务处理、数据库和相关组件，不能按单个 API 容器的配置购买服务器。官方起步要求至少 2 核 CPU、4GiB 内存，磁盘还要容纳镜像、数据库和上传文件。准备已安装 Docker 与 Compose 的 Linux VPS。

打开 Dify 官方 Releases，选择要部署的正式版本并记录标签。下列 TAG 必须换成所选版本，不能把占位符原样运行。

git clone --branch TAG https://github.com/langgenius/dify.git
cd dify/docker
cp .env.example .env

如果服务器没有 Git，先用系统软件包管理器安装。保留版本标签和 .env，后续更新与恢复都会用到。

编辑 .env 中的密码、密钥和对外地址。服务器已有网站占用 80 或 443 时，调整官方配置的 EXPOSE_NGINX_PORT 等入口参数，或接入现有反向代理，不要让两个服务争用端口。

sudo docker compose config --quiet
sudo docker compose up -d
sudo docker compose ps

初始化相关的一次性服务完成后退出可能是预期行为；持续运行的组件报错，则查看对应服务日志。不要仅凭所有行都出现过容器名就认定安装正常。

通过部署入口打开 /install，创建管理员。进入工作区后配置模型提供方和凭据，先用一个简单聊天应用确认模型调用可用，再增加知识库和复杂工作流。

如果界面能打开但模型调用失败，查看提供方地址、模型名称、凭据与额度。上传文档后的处理还涉及后台任务，前端能登录并不表示文档处理组件已经正常。

备份 Compose 的持久化数据、数据库和 .env。文件和数据库之间有关联，恢复时应来自同一轮备份。版本升级遵循官方迁移说明，先保存旧版本数据再切换。

同一台机器计划运行更多应用时，观察内存、任务队列和磁盘增长，再决定扩容；不要把官方起步配置当成所有工作流的固定上限。