ubuntu16.04如何部署dify? 在Linux上安装部署Dify的技巧

发布时间：2025-05-13 11:35:21 作者：taojianglong

随着云计算和容器技术的快速发展，Docker已经成为现代软件开发和部署的重要工具之一，Dify作为一款优秀的云原生应用，通过Docker容器化部署可以带来更高的灵活性和可扩展性，本文将详细介绍在Ubuntu系统上部署Dify的步骤和注意事项，帮助读者快速完成Dify的部署

Dify 是一个基于 Docker 的工作流管理工具，旨在简化机器学习和数据科学领域的多步骤工作流。它通过容器化每个步骤，确保工作流的可复现性和环境一致性。Dify 支持自动化执行、日志记录和结果管理，适用于数据处理、模型训练和部署等场景。

Dify 主要支持以下三种模式：

Agent 模式：Dify 作为一个代理，通过配置和管理多种工作流，进行任务调度和执行。
知识库模式：用于存储和管理工作流相关的知识、数据库和模型，方便复用和共享。
工作流模式：Dify 通过定义工作流的各个步骤，自动化执行数据处理、模型训练、测试等任务，确保工作流的一致性和高效性。

安装 Dify 之前, 请确保机器已满足最低安装要求：

CPU >= 2 Core
RAM >= 4 GiB

1、克隆 Dify 源代码至本地环境

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

也可以手动下载到本地https://github.com/langgenius/dify/archive/refs/heads/main.zip，解压后移动到服务器上。

2、加速Dify镜像文件下载

详情见：https://github.com/imashen/docker-aio/tree/main

安装脚本使用：curl -fsSL https://docker.13140521.xyz/install | bash -s docker --mirror Aliyun
Docker加速源使用：
编辑Docker配置文件：打开Docker的配置文件（通常位于/etc/docker/daemon.json）：sudo vim /etc/docker/daemon.json
添加或修改镜像源：添加或修改配置文件中的registry-mirrors字段：

{
  "registry-mirrors": [
    "https://docker.13140521.xyz"
  ]
}

重启Docker服务: 保存配置文件并重启Docker服务：

sudo systemctl daemon-reload
sudo systemctl restart docker

3、启动 Dify

进入 Dify 源代码的 Docker 目录cd dify/docker

复制环境配置文件cp .env.example .env

启动 Docker 容器

根据你系统上的 Docker Compose 版本，选择合适的命令来启动容器。你可以通过docker compose version命令检查版本，详细说明请参考 Docker 官方文档：

如果版本是 Docker Compose V2，使用以下命令：

docker compose up -d

如果版本是 Docker Compose V1，使用以下命令：

docker-compose up -d

运行命令后，你应该会看到类似以下的输出，显示所有容器的状态和端口映射：

[+] Running 11/11
 ✔ Network docker_ssrf_proxy_network  Created                                                                 0.1s 
 ✔ Network docker_default             Created                                                                 0.0s 
 ✔ Container docker_redis_1           Started                                                                 2.4s 
 ✔ Container docker_ssrf_proxy_1      Started                                                                 2.8s 
 ✔ Container docker_sandbox_1         Started                                                                 2.7s 
 ✔ Container docker_web_1             Started                                                                 2.7s 
 ✔ Container docker_weaviate_1        Started                                                                 2.4s 
 ✔ Container docker_db_1              Started                                                                 2.7s 
 ✔ Container docker_api_1             Started                                                                 6.5s 
 ✔ Container docker_worker_1          Started                                                                 6.4s 
 ✔ Container docker_nginx_1           Started                                                                 7.1s

最后检查是否所有容器都正常运行：

docker compose ps

[+] Running 11/11
 ✔ Network docker_ssrf_proxy_network  Created                                                                 0.1s 
 ✔ Network docker_default             Created                                                                 0.0s 
 ✔ Container docker_redis_1           Started                                                                 2.4s 
 ✔ Container docker_ssrf_proxy_1      Started                                                                 2.8s 
 ✔ Container docker_sandbox_1         Started                                                                 2.7s 
 ✔ Container docker_web_1             Started                                                                 2.7s 
 ✔ Container docker_weaviate_1        Started                                                                 2.4s 
 ✔ Container docker_db_1              Started                                                                 2.7s 
 ✔ Container docker_api_1             Started                                                                 6.5s 
 ✔ Container docker_worker_1          Started                                                                 6.4s 
 ✔ Container docker_nginx_1           Started                                                                 7.1s

4、访问 Dify

你可以先前往管理员初始化页面设置管理员账户：

本地环境

http://localhost/install

服务器环境

http://your_server_ip/install

Dify 主页面：

本地环境

http://localhost

服务器环境

http://your_server_ip

5、更新 Dify

进入 dify 源代码的 docker 目录，按顺序执行以下命令：

# 注意：以下方法只针对git clone方式下载的小伙伴
cd dify/docker
docker compose down
git pull origin main
docker compose pull
docker compose up -d

同步环境变量配置 (重要！)
如果 .env.example 文件有更新，请务必同步修改你本地的 .env 文件。

检查 .env 文件中的所有配置项，确保它们与你的实际运行环境相匹配。你可能需要将 .env.example 中的新变量添加到 .env 文件中，并更新已更改的任何值。
如果是通过下载dify压缩文件到本地的小伙伴，请重新下载最新的dify压缩文件并移动到服务器覆盖当前dify目录。接着进入 api 目录下，执行以下命令将数据库结构迁移至最新版本flask db upgrade。接着，运行docker-compose up -d即可。

6、常见问题及解决方案

（1）容器restarting

通过docker compose ps，如果出现个别容器一直restarting，使用docker logs -f查看容器日志，如果日志中出现如下错误：

- OpenBLAS blas_thread_init: pthread_create failed for thread 47 of 48: Operation not permittedOpenBLAS blas_thread_init: RLIMIT_NPROC -1 current, -1 max

修改docker-compose.yaml文件，在每个镜像下增加privileged: true # 启用特权模式，如：

api:
    image: langgenius/dify-api:0.13.1
    restart: always
    environment:
      # Use the shared environment variables.
      <<: *shared-api-worker-env
      # Startup mode, 'api' starts the API server.
      MODE: api
    depends_on:
      - db
      - redis
    volumes:
      # Mount the storage directory to the container, for storing user files.
      - ./volumes/app/storage:/app/api/storage
    networks:
      - ssrf_proxy_network
      - default
    privileged: true

通过docker-compose down停止所有正在运行的容器，然后docker-compose up -d重新启动所有dify镜像即可解决。

（2）日志文件上限

当前docker日志文件没有设置上限，会导致日志文件占用内存持续增长，可通过以下方式设置单个日志文件的上限：

api:
    image: langgenius/dify-api:0.13.1
    restart: always
    environment:
      # Use the shared environment variables.
      <<: *shared-api-worker-env
      # Startup mode, 'api' starts the API server.
      MODE: api
    depends_on:
      - db
      - redis
    volumes:
      # Mount the storage directory to the container, for storing user files.
      - ./volumes/app/storage:/app/api/storage
    networks:
      - ssrf_proxy_network
      - default
    privileged: true
    logging:
      driver: "json-file"
      options:
        max-size: "10m"     # 每个日志文件最大 10MB
        max-file: "3"

（3）重置管理员密码

如果你通过 Docker Compose 部署，你可以运行以下 Docker Compose 命令行重置密码。

docker exec -it docker_api_1 flask reset-password

请按照提示输入邮箱地址和新密码，例如：

dify@my-pc:~/hello/dify/docker$ docker compose up -d
[+] Running 9/9
 ✔ Container docker_web_1         Started                                                              0.1s 
 ✔ Container docker_sandbox_1     Started                                                              0.1s 
 ✔ Container docker_db_1          Started                                                              0.1s 
 ✔ Container docker_redis_1       Started                                                              0.1s 
 ✔ Container docker_weaviate_1    Started                                                              0.1s 
 ✔ Container docker_ssrf_proxy_1  Started                                                              0.1s 
 ✔ Container docker_api_1         Started                                                              0.1s 
 ✔ Container docker_worker_1      Started                                                              0.1s 
 ✔ Container docker_nginx_1       Started                                                              0.1s 
dify@my-pc:~/hello/dify/docker$ docker exec -it docker-api-1 flask reset-password
None of PyTorch, TensorFlow >= 2.0, or Flax have been found. Models won't be available and only tokenizers, configuration and file/data utilities can be used.
sagemaker.config INFO - Not applying SDK defaults from location: /etc/xdg/sagemaker/config.yaml
sagemaker.config INFO - Not applying SDK defaults from location: /root/.config/sagemaker/config.yaml
Email: hello@dify.ai
New password: newpassword4567
Password confirm: newpassword4567
Password reset successfully.

（4）修改页面端口

如果你使用 Docker Compose 部署，你可以通过修改.env配置来自定义 Dify 的访问端口。

你需要修改 Nginx 相关配置：

EXPOSE_NGINX_PORT=80
EXPOSE_NGINX_SSL_PORT=443

常见问题及解决方案

1. Docker引擎无法启动

问题描述：在执行Docker命令时，提示Docker引擎无法启动。
解决方案：首先检查Docker引擎是否已经正确安装并配置。如果安装过程中出现问题，可以重新安装Docker引擎。此外，还需要检查服务器上的系统资源是否足够，如内存、CPU等。

2. Dify容器无法正常运行

问题描述：在运行Dify容器时，容器无法正常启动或运行。
解决方案：首先查看Docker容器的日志信息，了解容器启动失败的原因。可能是Dify镜像存在问题，可以尝试重新拉取镜像。此外，还需要检查容器的配置是否正确，如端口映射、环境变量等。

Tag：Linux Dify Ubuntu16.04 Ubuntu

ubuntu系统使用官方操作命令升级Dify指南
Dify支持自动化执行、日志记录和结果管理，适用于数据处理、模型训练和部署等场景，今天我们就来看看ubuntu系统中使用官方操作命令升级Dify的方法
2025-05-13
ubuntu如何部署Dify以及安装Docker? Dify安装部署指南
Dify 是一个开源的大模型应用开发平台，允许用户快速构建和部署基于大语言模型的应用，ubuntu如何部署Dify呢？详细请看下文介绍
2025-05-13
ubuntu系统怎么修改ollama模型下载位置?
ollama下载和安装都比较简单，容易上手操作，但在ubuntu系统中下载ollama并且修改ollama中模型的保存路径设置起来比较麻烦，详细请看下文介绍
2025-05-13
Rust 组件全面上位! Ubuntu 25.10 将全面采用基于Rust 的 sudo-rs
anonical宣布自 Ubuntu 25.10 发行版开始，取代原有的 sudo，默认使用基于 Rust 的内存安全工具 sudo-rs，并计划在 Ubuntu 26.04 LTS版本中进一步部署推广
2025-05-13
新特性抢先看! Ubuntu 25.04 Beta 发布:Linux 6.14 内核
Canonical公司近日发布了Ubuntu 25.04 Beta版，这一版本被赋予了一个活泼的代号——“Plucky Puffin”（勇敢的海雀），据悉，正式的稳定版预计将在2025年4月17日与广大用户
2025-03-29
如何让 Ubuntu 居中显示窗口? 3种方法实现Ubuntu窗口居中显示
个人习惯不管打开终端窗口还是文件管理器窗口，都希望居中显示，不太喜欢Linux下自动随意的摆放位置，下面我们就来看看详细设置方法
2025-03-11
Ubuntu 24.04.2 LTS 正式发布: 带来全新硬件支持启用堆栈HWE
buntu 24.04 LTS 的第 2 个小版本Ubuntu 24.04.2 LTS 正式发布，出了修复漏洞以外，它还带来了全新的硬件支持启用堆栈（HWE），让系统性能和硬件兼容性更上一层楼
2025-02-25
怎么关闭Ubuntu无人值守升级? Ubuntu禁止自动更新的技巧
Ubuntu Linux系统禁止自动更新的时候，提示“无人值守升级在关机期间，请不要关闭计算机进程”，该怎么解决这个问题？详细请看下文介绍
2025-01-20
如何配置Ubuntu无人值守升级? 手动操作实现Ubuntu自动升级技巧
无人值守升级是一个用于自动更新 Debian 和 Ubuntu 系统的开源项目,该项目的主要目的是确保系统能够定期自动安装安全更新，从而保持系统的安全性和稳定性
2025-01-20
Ubuntu系统怎么安装Warp? 新一代AI 终端神器安装使用方法
Warp是一款使用Rust开发的现代化AI 终端工具，该怎么再Ubuntu系统中安装使用呢？下面我们就来看看详细教程
2025-01-20

ubuntu16.04如何部署dify? 在Linux上安装部署Dify的技巧

1、克隆 Dify 源代码至本地环境

2、加速Dify镜像文件下载

3、启动 Dify

4、访问 Dify

5、更新 Dify

6、常见问题及解决方案

常见问题及解决方案

相关文章

最新评论

文章分类

大家感兴趣的内容

最近更新的内容