一、环境准备

1.docker
2.docker compose

二、下载Dify

• 将Dify代码从github下载至服务器，或者通过http的方式下载Dify的代码的zip文件后，上传至服务器解压缩。

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

三、启动Dify

• 加快拉取镜像的速度，在docker-compose.yaml文件里面加一个前缀源
  • 例如：image: mysql:8.0 替换为 image: docker.1ms.run/mysql:8.0

cd dify/docker
cp .env.example .env
docker compose up -d

• 注意：如果您的系统安装了 Docker Compose V2 而不是 V1，请使用 docker compose 而不是 docker-compose

四、访问Dify

• http://localhost

出现异常：
dify Setup failed: PermissionDenied (persistent) at write => permission denied Context: service: fs path: privkeys/e4c12d52-1c20-4753-a3c0-45ebed0575d6/private.pem Source: Permission denied (os error 13)
解决办法：
chmod 777 dify/docker/volumes/app/storage

五、常用场景

1.修改Dify访问端口

• 修改配置文件地址：在 Dify 的安装目录中找到 .env 文件（通常位于 docker/ 子目录下）。此文件定义了 Docker 容器的环境变量，包括端口配置。
• http的方式修改

# Docker 容器内部 Nginx 监听的端口（默认80）
NGINX_PORT=6060  
# 对外映射的 HTTP 端口（必须与内部端口一致或不同）
EXPOSE_NGINX_PORT=6060  

• https的方式修改

# SSL 端口（默认443）
NGINX_SSL_PORT=6443  
EXPOSE_NGINX_SSL_PORT=6443  

2.修改数组长度

• 使用“代码执行”节点，将入参 json 提取为新的 json 返回。但在执行“代码执行”节点时报错：The length of output variable xxx_list must be less than 30 elements
• 原因：在 Dify 环境变量文件 dify/docker/.env中，沙箱服务对代码执行添加了一定的限制。与数组相关的限制如下：

CODE_MAX_STRING_LENGTH：String最大长度
CODE_MAX_STRING_ARRAY_LENGTH：Array[String] 最大长度
CODE_MAX_OBJECT_ARRAY_LENGTH：Array[Object] 最大长度
CODE_MAX_NUMBER_ARRAY_LENGTH：Array[Number] 最大长度

• 修改完要重启dify

cd dify/docker
docker compose down
docker compose up -d

3.修改dify上传文件最大限制

• 在 Dify 环境变量文件 dify/docker/.env中，修改：

FORCE_VERIFYING_SIGNATURE=false
PLUGIN_MAX_PACKAGE_SIZE=524288000
NGINX_CLIENT_MAX_BODY_SIZE=500M

• 修改完要重启dify

4.沙盒环境异常

报错信息：Failed to execute code, which is likely a network issue, please check if the sandbox service is running.（Error: [Errno 113] No route to host）

• 解决办法，在docker-compose.yaml里面修改参数