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

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

Dify 大语言模型私有化部署指南

1. 搭建 Linux 环境

私有化部署的第一步是搭建一个稳定可靠的操作系统环境。Linux 以其开源、稳定和安全性高的特点，成为部署的首选。选择一个合适的 Linux 发行版，如 CentOS 或 Ubuntu，进行安装和配置。本指南以 CentOS 7 为例。

2. 更新配置 yum 源

(1) 备份当前 yum 仓库文件

sudo cp /etc/yum.repos.d/CentOS-Base.repo /etc/yum.repos.d/CentOS-Base.repo.backup

(2) 下载新的仓库配置文件。推荐使用阿里云或清华大学镜像源。

sudo curl -o /etc/yum.repos.d/CentOS-Base.repo http://mirrors.aliyun.com/repo/Centos-7.repo

(3) 清除 YUM 缓存并生成新的缓存。

sudo yum clean all
sudo yum makecache

(4) YUM 更新

sudo yum -y update

3. Git 安装

(1) 确保包管理器是最新的

sudo yum update

(2) 安装 Git 包

sudo yum install git

(3) 验证安装

git --version

4. Docker 安装

(1) 更新软件包

sudo yum update

(2) 安装 Docker 依赖的软件包

sudo yum install -y yum-utils device-mapper-persistent-data lvm2

(3) 设置 Docker 的稳定仓库

sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo

(4) 安装 Docker CE (社区版)

sudo yum install -y docker-ce docker-ce-cli containerd.io

(5) 启动 Docker 服务

sudo systemctl start docker
sudo systemctl enable docker

5. 配置 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. 常见问题与安全建议

常见问题

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

安全建议

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

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