Dify Docker#

生成式 AI 应用创新引擎

开源的 LLM 应用开发平台。提供从 Agent 构建到 AI workflow 编排、RAG 检索、模型管理等能力，轻松构建和运营生成式 AI 原生应用。比 LangChain 更易用。

Docker Compose#

git clone https://github.com/langgenius/dify.git
cd dify/docker
cp .env.example .env
docker-compose up -d

访问 Dify#

更新 Dify#

# 1. Back up your customized docker-compose YAML file (optional)
cd dify/docker
cp docker-compose.yaml docker-compose.yaml.$(date +%s).bak
# 2. Get the latest code from the main branch
git checkout main
git pull origin main
# 3. Stop the service, Command, please execute in the docker directory
docker compose down
# 4. Back up data
tar -cvf volumes-$(date +%s).tgz volumes
# 5. Upgrade services
docker compose pull
docker compose up -d

同步环境变量配置 (重要！)#

如果 .env.example 文件有更新，请务必同步修改你本地的 .env 文件。

自定义配置#

编辑 .env 文件中的环境变量值。然后重新启动 Dify：

docker compose down
docker compose up -d

完整的环境变量集合可以在 docker/.env.example 中找到。

单独启动前端 Docker 容器#

当单独开发后端时，可能只需要源码启动后端服务，而不需要本地构建前端代码并启动

docker run -it -p 3000:3000 -e CONSOLE_API_URL=http://127.0.0.1:5001 -e APP_API_URL=http://127.0.0.1:5001 langgenius/dify-web:latest

MCP#

MCP 为 LLM 与外部应用之间构建了双向通信通道，就像是 AI 的“USB-C”接口，帮助模型发现、理解并安全调用各种外部工具或 API

Plugins#

安装 Dify 插件开发脚手架 (CLI)#

下载: 访问 Dify Plugin CLI Releases

本地运行与调试#

cp .env.example .env
python -m main

打包插件#

dify plugin package ./your_plugin_project
dify-plugin-windows-amd64.exe plugin package ./your_plugin_project

hjlarry/database#

可以用来连接现有数据库，并执行SQL语句和自然语言转SQL Usage

mysql+pymysql://root:123456@localhost:3306/test
postgresql+psycopg2://postgres:123456@localhost:5432/test
sqlite:///test.db
mssql+pymssql://<username>:<password>@<freetds_name>/?charset=utf8
oracle+oracledb://user:pass@hostname:port[/dbname][?service_name=<service>[&key=value&key=value...]]

密码中有 @ 怎么办？@ 是URL中的保留字符，需要使用 %40 代替，例如 123%40456

bowenliang123/md_exporter#

导出 Markdown 为 DOCX, PPTX, XLSX, PDF, HTML, MD, CSV, JSON, XML, LaTex 文件, 并将代码块导出为各类脚本文件(Python, JS, Bash等)

git clone https://github.com/bowenliang123/md_exporter.git
pip install -r requirements.txt

stvlynn/DOC-Dify-Plugin#

Markdown to DOCX Converter

Tips#

环境变量配置#

vi .env

LOG_TZ=Asia/Shanghai
FILES_ACCESS_TIMEOUT=300
NGINX_CLIENT_MAX_BODY_SIZE=500M
UPLOAD_FILE_SIZE_LIMIT=500
TOP_K_MAX_VALUE=20
FORCE_VERIFYING_SIGNATURE=true
PLUGIN_MAX_EXECUTION_TIMEOUT=2400
PIP_MIRROR_URL=https://pypi.tuna.tsinghua.edu.cn/simple

备份#

需要备份数据库、配置的存储以及向量数据库数据，若为 docker compose 方式部署，可直接备份 dify/docker/volumes 目录下所有数据内容。

dify-sandbox config error#

cd volumes/sandbox/conf
wget https://github.com/langgenius/dify/blob/main/docker/volumes/sandbox/conf/config.yaml

dify-sandbox ModuleNotFoundError#

cd volumes/sandbox/dependencies
vi python-requirements.txt

weaviate组件缺失问题#

docker-compose up weaviate -d

Dify Docker

Contents