常见问题

1. 长时间未收到密码重置邮件应如何处理？

你需要在 .env 文件内配置 Mail 参数项，详细说明请参考 《环境变量说明：邮件相关配置》。

修改配置后，运行以下命令重启服务。

docker compose down
docker compose up -d

如果依然没能收到邮件，请检查邮件服务是否正常，以及邮件是否进入了垃圾邮件列表。

2. 如果 workflow 太复杂超出节点上限如何处理？

在社区版你可以在web/app/components/workflow/constants.ts 手动调整 MAX_TREE_DEPTH 单条分支深度的上限，我们的默认值是 50，在这里要提醒自部署的情况下过深的分支可能会影响性能。

3. 如何指定工作流各节点的运行时间？

你可以在 .env 文件内修改 TEXT_GENERATION_TIMEOUT_MS 变量，调整各节点的运行时间，防止因某些进程运行超时而导致整体应用服务不可用。

4. 如何重置管理员密码？

如果你通过 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: [e-mail]
New password: newpassword4567
Password confirm: newpassword4567
Password reset successfully.

5. 如何修改页面端口？

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

你需要修改 Nginx 相关配置：

EXPOSE_NGINX_PORT=80
EXPOSE_NGINX_SSL_PORT=443

其他相关的部署问题请参考本地部署相关。

6. docker-api-1 出现数据库连接报错如何处理？

问题详情：访问 http://localhost 时提示 Internal Server Error 错误；且 docker-api-1 的日志中出现了类似错误：

FATAL:  no pg_hba.conf entry for host "172.19.0.7", user "postgres", database "dify", no encryption

解决办法：修改 db 容器下的 /var/lib/postgresql/pgdata/pg_hba.conf，将报错提示中所对应的网段添加至授权名单，例如：

docker exec -it docker-db-1 sh -c "echo 'host all all 172.19.0.0/16 trust' >> /var/lib/postgresql/data/pgdata/pg_hba.conf"
docker-compose restart

7. 如何修改知识库文件上传大小限制？

请修改 .env 文件中的 UPLOAD_FILE_SIZE_LIMIT 参数默认限制，同时还需要同步修改 NGINX_CLIENT_MAX_BODY_SIZE 参数的值以避免潜在异常。