Linux环境Docker部署Dify教程：快速集成大模型API实战指南

环境

软件	版本
Dify	1.0.0
Ubuntu	20
Docker	24
Vmware	16

Docker 安装

下载源码

如果有安装了 git 工具，直接拉取官方仓库即可

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

如果没有则手工下载下载，然后上传到虚拟机里，然后解压

进入 docker 目录

cd dify-main/docker

配置环境

sudo cp .env.example .env

# 修改 NGINX_PORT 和 EXPOSE_NGINX_PORT 为其他端口（如 8080）
sudo vim .env

示例配置

# 知识库文件上传大小限制（单位：MB）
UPLOAD_FILE_SIZE_LIMIT=1024  # 示例：调整为 1GB（1024MB）

# 多模态文件上传限制（图片/视频/音频，单位：MB）
UPLOAD_IMAGE_FILE_SIZE_LIMIT=1000
UPLOAD_VIDEO_FILE_SIZE_LIMIT=10000
UPLOAD_AUDIO_FILE_SIZE_LIMIT=500

# Nginx 请求体大小限制（需匹配或大于上述值）
NGINX_CLIENT_MAX_BODY_SIZE=15000M  # 示例：15GB

修改 nginx 配置

vi /opt/dify/dify-main/docker/nginx/conf.d/default.conf

启动过程

启动，<font style="color:rgba(0, 0, 0, 0.88);">-d</font> 表示后台运行，首次启动会下载镜像，耗时约 5-10 分钟（取决于网络）

现在 docker 下载镜像貌似都要使用魔法上网了，使用网上的各种镜像配置都不行，我这里也是前前后后换了很多次配置都不行，最后还是通过代理网络才镜像下载成功的

sudo docker-compose up -d

# 应显示 running 的 dify-api 和 dify-web 容器
sudo docker ps

[root@ai:/opt/dify/dify-main/docker]# docker ps
CONTAINER ID   IMAGE                                       COMMAND                  CREATED              STATUS                        PORTS                                                                                      NAMES
f237db2fbb77   nginx:latest                                "sh -c 'cp /docker-e…"   About a minute ago   Up About a minute             0.0.0.0:443->443/tcp, :::443->443/tcp, 80/tcp, 0.0.0.0:9000->9000/tcp, :::9000->9000/tcp   docker-nginx-1
372963de958e   langgenius/dify-api:1.0.0                   "/bin/bash /entrypoi…"   About a minute ago   Up About a minute             5001/tcp                                                                                   docker-worker-1
e36b82bf08b5   langgenius/dify-api:1.0.0                   "/bin/bash /entrypoi…"   About a minute ago   Up About a minute             5001/tcp                                                                                   docker-api-1
2cb01a64fced   postgres:15-alpine                          "docker-entrypoint.s…"   About a minute ago   Up About a minute (healthy)   0.0.0.0:5432->5432/tcp, :::5432->5432/tcp                                                  docker-db-1
29fcf3975fdf   docker-web                                  "/bin/sh ./entrypoin…"   About a minute ago   Up About a minute             3000/tcp                                                                                   docker-web-1
ce18295b38c8   langgenius/dify-sandbox:0.2.10              "/main"                  About a minute ago   Up About a minute (healthy)                                                                                              docker-sandbox-1
d6a861ba124c   semitechnologies/weaviate:1.19.0            "/bin/weaviate --hos…"   About a minute ago   Up About a minute                                                                                                        docker-weaviate-1
c5b76c2c6642   ubuntu/squid:latest                         "sh -c 'cp /docker-e…"   About a minute ago   Up About a minute             3128/tcp                                                                                   docker-ssrf_proxy-1
b5b6b020b16d   langgenius/dify-plugin-daemon:0.0.3-local   "/bin/bash -c /app/e…"   About a minute ago   Up About a minute             0.0.0.0:5003->5003/tcp, :::5003->5003/tcp                                                  docker-plugin_daemon-1
8166cd436f3c   redis:6-alpine                              "docker-entrypoint.s…"   About a minute ago   Up About a minute (healthy)   6379/tcp                                                                                   docker-redis-1

访问 web

首次登录需要注册

重启命令

要在安装目录的 docker 目录下执行

docker-compose down
docker-compose up -d

docker logs dify-nginx  # 查看 Nginx 是否加载新配置

模型集成

打开设置

点击模型供应商

ollama 本地模型

如果电脑配置高的，并且对隐私数据有要求的，可以通过本地部署模型，然后集成到 dify 平台里面

首先已经有在 windows 安装

ollama list

找到 ollama，安装

输入模型名称，要和 ollama 安装的对应上名字，输入基础 URL：http://{ollama 服务所在IP}:11434，其他默认就行

添加 text embedding 模型

通义千问（推荐）

首先去阿里云的百炼模型注册一下，https://bailian.console.aliyun.com/#/home

可以看到模型广场有很多的模型，并且有参数高的，无需自己本地部署，非常的好用，耗费的 Token 也不算高，很划算，前期免费的资源够用很长一段时间了

点击右上角的 **<font style="color:rgb(38, 36, 76);">API-KEY</font>**

创建 API-KEY即可，复制这个秘钥

回到 Dify，在模式供应商里面找到通义千问进行安装

点击设置 API-KEY

深度求索 DeepSeek（推荐）

近期，AI领域迎来了一位备受瞩目的新星——DeepSeek。这款由深度求索公司开发的智能模型，凭借其卓越的能力，迅速在行业内引发了广泛讨论。尤其是在文本生成、对话交互以及创意创作方面，DeepSeek展现出了远超同类模型的水平。它在多模态处理方面表现出色。

无论是生成文字、图像，还是处理音频、视频，DeepSeek都能轻松应对，为用户提供全方位的服务体验。其次，它的对话能力非常自然，能够理解用户的意图并给出精准的回应，甚至在复杂问题上也能提供令人惊喜的答案。

此外，DeepSeek在创意创作方面也颇具亮点，无论是写故事、写诗，还是写邮件，它都能轻松完成，甚至还能模仿不同风格的写作风格。

点击安装深度求索插件

打开 DeepSeek 开放平台，https://platform.deepseek.com/api_keys，创建 API Key

回到 Dify，设置 API KEY，点击保存

如果是 1.0.0 版本，添加模型有时候会一直卡着，需要过一会再来尝试，bug 比较多

保存成功后可以看到 DeepSeek 的模型列表

Demo 示例

接下来打开首页，点击创建空白应用

选择聊天助手，填写标题，点击创建

简单写点提示词，选择 deepseek-r1模型

进行对话

点击发布，点击运行