手把手教你用Docker-Compose安装Dify社区版（含国内镜像加速配置）

手把手教你用Docker-Compose安装Dify社区版含国内镜像加速配置如果你正在探索大模型和Agent技术想在本地搭建一个开发环境Dify社区版是个不错的选择。作为一个开源的AI应用开发平台Dify让开发者能够快速构建和部署基于大语言模型的应用。不过在国内网络环境下安装可能会遇到一些挑战特别是镜像拉取速度慢、DNS解析失败等问题。本文将详细介绍如何通过Docker-Compose安装Dify社区版并针对国内网络环境进行优化配置。1. 环境准备在开始安装Dify之前我们需要确保系统满足最低配置要求并安装必要的工具。Dify社区版推荐的最低配置是2核CPU和4GB内存这个配置足以支持基本的开发和测试需求。首先我们需要安装Docker和Docker-Compose。这两个工具是容器化部署的基础也是Dify官方推荐的安装方式。对于Ubuntu系统可以通过以下命令安装最新版本的Docker# 更新软件包索引 sudo apt-get update # 安装必要的依赖包 sudo apt-get install -y \ apt-transport-https \ ca-certificates \ curl \ gnupg-agent \ software-properties-common # 添加Docker官方GPG密钥 curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add - # 添加Docker仓库 sudo add-apt-repository \ deb [archamd64] https://download.docker.com/linux/ubuntu \ $(lsb_release -cs) \ stable # 安装Docker引擎 sudo apt-get update sudo apt-get install -y docker-ce docker-ce-cli containerd.io安装完成后验证Docker是否正常运行sudo docker run hello-world接下来安装Docker-Compose。建议安装V2版本因为Dify官方文档中的命令使用的是V2语法# 下载Docker-Compose V2 sudo curl -L https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m) -o /usr/local/bin/docker-compose # 添加执行权限 sudo chmod x /usr/local/bin/docker-compose # 创建符号链接 sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose # 验证安装 docker-compose --version注意如果系统已安装旧版Docker-Compose建议先卸载旧版本再安装新版避免版本冲突。2. 配置国内镜像加速在国内网络环境下直接从Docker Hub拉取镜像可能会非常缓慢甚至失败。为了提高下载速度我们需要配置国内镜像源。以下是推荐的配置步骤首先创建或修改Docker的配置文件sudo vi /etc/docker/daemon.json将以下内容添加到配置文件中可以根据实际情况选择一个或多个镜像源{ registry-mirrors: [ https://mirror.aliyuncs.com, https://docker.mirrors.ustc.edu.cn, https://hub-mirror.c.163.com, https://mirror.baidubce.com ] }保存后重启Docker服务使配置生效sudo systemctl daemon-reload sudo systemctl restart docker验证镜像加速是否生效docker info | grep Registry Mirrors -A 5如果输出中显示了配置的镜像地址说明配置成功。此外DNS解析问题也可能导致镜像拉取失败。我们可以修改系统的DNS配置sudo vi /etc/resolv.conf添加或修改为以下内容nameserver 8.8.8.8 nameserver 8.8.4.4保存后可能需要重启网络服务或系统使配置生效。3. 下载并配置Dify现在我们可以开始准备Dify的安装文件了。首先创建一个工作目录并进入mkdir dify cd dify从GitHub克隆Dify社区版的官方仓库如果网络不稳定可以考虑使用GitHub的国内镜像git clone https://github.com/langgenius/dify.git cd dify/docker-composeDify的Docker-Compose配置文件已经包含了所有必要的服务组件。我们可以直接使用官方提供的配置但建议先检查一下版本号是否是最新的cat docker-compose.yml | grep image如果需要修改某些配置参数可以编辑.env文件。这个文件包含了Dify运行时的环境变量设置。常见的需要修改的参数包括APP_PORT: 应用访问端口API_PORT: API服务端口CONSOLE_PORT: 控制台端口DB_PASSWORD: 数据库密码提示生产环境部署时务必修改默认的数据库密码和管理员账号密码。4. 启动Dify服务一切准备就绪后就可以启动Dify服务了。使用以下命令启动所有容器docker-compose up -d这个命令会在后台启动所有服务容器。启动过程可能需要一些时间特别是第一次运行时需要下载所有依赖的镜像。可以通过以下命令查看容器状态docker-compose ps如果一切正常你应该看到类似下面的输出Name Command State Ports ---------------------------------------------------------------------------------- dify-backend /entrypoint.sh python manage ... Up 0.0.0.0:5001-5001/tcp dify-frontend /docker-entrypoint.sh ngin ... Up 0.0.0.0:80-80/tcp dify-mysql docker-entrypoint.sh --def ... Up 3306/tcp, 33060/tcp dify-redis docker-entrypoint.sh redis ... Up 6379/tcp dify-worker /entrypoint.sh celery -A ap ... Up启动完成后可以通过浏览器访问Dify的Web界面。默认情况下前端服务运行在80端口所以直接在浏览器中输入服务器IP地址即可访问。首次访问时需要完成初始化设置包括创建管理员账号等。按照页面提示完成设置后就可以开始使用Dify了。5. 常见问题排查在安装过程中可能会遇到一些问题这里列出几个常见问题及其解决方法问题1镜像拉取失败如果看到类似Error response from daemon: Get https://registry-1.docker.io/v2/: net/http: request canceled的错误可能是网络连接问题。可以尝试确认镜像加速配置是否正确检查DNS设置尝试手动拉取镜像docker pull registry.cn-hangzhou.aliyuncs.com/langgenius/dify-backend:latest问题2端口冲突如果启动时提示端口已被占用可以修改.env文件中的端口配置然后重新启动服务docker-compose down docker-compose up -d问题3数据库初始化失败如果数据库服务启动失败可以检查日志docker-compose logs dify-mysql常见原因是磁盘空间不足或权限问题。可以尝试删除旧的数据库卷并重新启动docker-compose down -v docker-compose up -d问题4内存不足Dify运行需要足够的内存资源。如果系统内存不足可以尝试增加系统交换空间调整Docker的内存限制关闭不必要的服务释放内存6. 日常维护与管理Dify安装完成后还需要进行一些日常维护工作更新Dify版本当有新版本发布时可以按照以下步骤更新# 停止当前服务 docker-compose down # 拉取最新代码 git pull origin main # 重新构建并启动服务 docker-compose up -d --build备份数据Dify的数据主要存储在MySQL数据库中可以通过以下命令备份docker exec dify-mysql sh -c exec mysqldump --all-databases -uroot -p$MYSQL_ROOT_PASSWORD dify_backup.sql监控服务状态可以使用以下命令查看各服务的运行状态和资源使用情况# 查看容器状态 docker-compose ps # 查看资源使用情况 docker stats # 查看日志 docker-compose logs -f性能优化对于生产环境可以考虑以下优化措施增加MySQL和Redis的资源限制配置Nginx缓存启用Gzip压缩优化Celery worker配置7. 进阶配置对于有特定需求的用户Dify还支持一些高级配置选项配置SMTP邮件服务要启用邮件通知功能需要在.env文件中配置SMTP服务器信息MAIL_SERVERsmtp.example.com MAIL_PORT587 MAIL_USE_TLStrue MAIL_USERNAMEyour_emailexample.com MAIL_PASSWORDyour_password MAIL_DEFAULT_SENDERyour_emailexample.com集成第三方存储默认情况下Dify使用本地文件系统存储上传的文件。可以配置使用S3兼容的存储服务STORAGE_TYPEs3 S3_ENDPOINThttps://s3.amazonaws.com S3_BUCKET_NAMEyour-bucket-name S3_ACCESS_KEYyour-access-key S3_SECRET_KEYyour-secret-key自定义域名和HTTPS要为Dify配置自定义域名和HTTPS可以在Nginx反向代理后面部署或者使用Lets Encrypt自动获取证书server { listen 443 ssl; server_name dify.yourdomain.com; ssl_certificate /path/to/cert.pem; ssl_certificate_key /path/to/key.pem; location / { proxy_pass http://dify-frontend:80; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } }扩展功能Dify支持通过插件扩展功能。要安装插件通常需要将插件代码放入指定目录修改配置文件启用插件重启相关服务具体步骤可以参考各个插件的安装说明。