Linux系统部署Dify教程【详细版】

参考文档：https://docs.dify.ai/zh-hans/getting-started/install-self-hosted/docker-compose
以下是基于Linux系统通过Docker和Docker Compose安装Dify的详细步骤：

1. 安装依赖工具

• 安装Git和Docker
  确保已安装Git和Docker，若未安装可参考以下命令（以Ubuntu和CentOS为例）：

  # 安装Git
  sudo apt update && sudo apt install git -y  或者 sudo yum -y update && sudo yum -y install git 
  
  # 安装Docker
  sudo apt install docker* -y  或者 sudo yum -y install docker*
  
  # 安装Docker Compose（需注意版本兼容性）
  sudo apt install docker-compose -y   或者 sudo yum -y install docker-compose
  # 或使用Docker Compose V2（需验证命令格式差异）
  

Docker版本要19.03以上
Docker Compose版本要1.28以上

2. 获取Dify源码

• 克隆Dify仓库
  使用Git下载Dify项目到本地：

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

3. 配置环境变量

• 生成环境变量文件
  根据示例文件创建.env文件并修改配置：

  cp .env.example .env
  vi .env  # 修改数据库密码、端口等参数（可选）
  

  • 关键参数示例（可以忽略这个步骤）：

    DB_PASSWORD=your_password
    PORT=3000  # Web服务端口
    

4. 启动Dify服务

• 使用Docker Compose部署
  根据Docker Compose版本执行对应命令：

  # Docker Compose V1（旧版）
  docker-compose up -d
  
  # Docker Compose V2（新版，需检查版本）
  docker compose up -d
  

  • 首次运行会自动拉取镜像并启动容器，过程可能耗时几分钟。

5. 验证安装

• 访问Dify Web界面
  浏览器打开：

  http://<服务器IP>:3000
  

  • 默认无需登录，可直接使用本地LLM服务。

• 查看日志
  若服务异常，可通过以下命令排查：

  docker logs dify-web  # 查看Web服务日志
  docker logs dify-api   # 查看API服务日志
  

6. 常见问题与注意事项

1. Docker Compose版本冲突

   • 若提示docker-compose命令不存在，尝试使用docker compose（V2语法）。
   • 检查版本：

     docker compose version
     

2. 资源限制

   • Dify最低要求：2核CPU、4GB内存、10GB存储空间。若资源不足可能导致容器崩溃。

3. 端口冲突

   • 若3000端口被占用，修改.env文件中的PORT参数并重启服务。

4. 内网穿透（可选）

   • 需要公网访问时，可使用cpolar等工具配置隧道：

     cpolar http 3000
     

附：关键文件结构

dify/
├── .env            # 环境变量配置
├── docker-compose.yml  # 服务编排文件
└── Dockerfile      # Docker镜像构建文件

通过以上步骤，您应能成功在Linux系统中部署Dify本地知识库服务。具体配置可参考官方文档或社区教程进一步优化。