Dify 大语言模型私有化部署指南：Linux 环境搭建与 Docker 配置

(1) 编辑 Docker 的配置文件

vi /etc/docker/daemon.json

(2) 设置 registry-mirrors 的镜像源地址 添加以下内容到文件中：

{
  "registry-mirrors": ["https://docker.m.daocloud.io"]
}

(3) 重启 Docker 服务以使更改生效

sudo systemctl daemon-reload
sudo systemctl restart docker

6. Docker Compose 安装

(1) 下载 Docker Compose 二进制文件

sudo curl -L "https://github.com/docker/compose/releases/download/v2.24.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

(2) 修改二进制文件的执行权限

sudo chmod +x /usr/local/bin/docker-compose

(3) 验证安装是否成功

docker-compose --version

7. 获取 Dify 源代码

使用 Git 克隆 Dify 官方仓库到本地目录。

git clone https://github.com/langgenius/dify.git
cd dify

8. 配置环境变量

复制环境变量模板文件。

cp .env.example .env

根据实际需求修改 .env 文件中的配置。关键变量说明如下：

• DB_USERNAME: 数据库用户名，默认为 postgres。
• DB_PASSWORD: 数据库密码，建议设置为强密码。
• REDIS_PASSWORD: Redis 密码，用于缓存安全。
• SECRET_KEY: 应用密钥，用于加密敏感信息，首次运行后请勿随意更改。 注意不要将敏感信息提交到公共仓库。

9. 启动 Dify 服务

进入项目根目录，使用 Docker Compose 启动所有服务。

docker compose up -d

等待服务初始化完成，可通过以下命令查看日志：

docker compose logs -f

10. 访问与验证

默认情况下，Dify Web 界面运行在 80 端口。在浏览器中访问 http://<服务器 IP> 即可开始使用。如果使用了反向代理或修改了端口，请相应调整访问地址。

11. 常见问题与安全建议

常见问题

1. 容器无法启动：检查 .env 文件配置是否正确，特别是数据库密码和 Redis 密码。
2. 镜像拉取失败：确保 Docker 镜像源配置正确，网络通畅。
3. 端口冲突：确认 80 端口未被占用，如有冲突可修改 .env 中的 PORT 变量。

安全建议

1. 修改默认密码：首次登录后立即修改管理员账户密码。
2. 限制访问 IP：在生产环境中，建议通过防火墙限制对 80 端口的访问来源。
3. 定期备份：定期备份数据库文件和配置文件，防止数据丢失。