跳转到主要内容
⚠️ 本文档由 AI 自动翻译。如有任何不准确之处，请参考英文原版。

​
身份验证与访问

​
重置管理员密码

对于 Docker Compose 部署： 
docker exec -it docker-api-1 flask reset-password
在提示时输入账户邮箱和新密码。 对于源代码部署，在 api 目录下运行相同命令。

​
登录后出现 401 错误

这通常发生在更改域名之后。请更新以下环境变量：
  • CONSOLE_CORS_ALLOW_ORIGINS - 控制台 CORS 策略
  • WEB_API_CORS_ALLOW_ORIGINS - WebApp CORS 策略
  • CONSOLE_API_URL - 控制台 API 的后端 URL
  • CONSOLE_WEB_URL - 控制台 Web 的前端 URL
  • SERVICE_API_URL - 服务 API URL
  • APP_API_URL - WebApp API 后端 URL
  • APP_WEB_URL - WebApp URL
更新配置后重启服务。

​
配置

​
更改默认端口

修改 .env 配置： 
EXPOSE_NGINX_PORT=80
EXPOSE_NGINX_SSL_PORT=443
如需更改 API 服务端口，请更新 docker-compose.yaml 中的 nginx 配置。

​
增加文件上传限制

在 .env 中更新：
  • UPLOAD_FILE_SIZE_LIMIT - 最大文件大小
  • NGINX_CLIENT_MAX_BODY_SIZE - 必须匹配以避免问题

​
工作流复杂度限制

在 web/app/components/workflow/constants.ts 中调整 MAX_TREE_DEPTH（默认值：50）。 注意：过大的深度会影响性能。

​
节点执行超时

在 .env 中设置 TEXT_GENERATION_TIMEOUT_MS 以控制每个节点的运行时间。

​
邮件配置

收不到密码重置邮件？请在 .env 中配置邮件设置：
  1. 设置邮件参数（SMTP 设置）
  2. 重启服务：
docker compose down
docker compose up -d
如果邮件仍未到达，请检查垃圾邮件文件夹。

​
在没有邮件服务的情况下邀请成员

在没有配置邮件的本地部署中，邀请页面在发送后会显示一个链接。手动复制并转发此链接给用户。

​
数据库问题

​
pg_hba.conf 连接错误

如果你看到： 
FATAL: no pg_hba.conf entry for host "172.19.0.7", user "postgres", database "dify", no encryption
允许来自错误中网络段的连接： 
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

​
加密密钥文件未找到错误

此错误发生在更改部署方法或删除 api/storage/privkeys 之后： 
FileNotFoundError: File not found
File "/www/wwwroot/dify/dify/api/libs/rsa.py", line 45, in decrypt
重置加密密钥对： Docker Compose： 
docker exec -it docker-api-1 flask reset-encrypt-key-pair
源代码（在 api 目录下）： 
flask reset-encrypt-key-pair
警告：此操作不可逆 - 现有加密数据将丢失。

​
工作空间管理

​
重命名工作空间

直接修改数据库中的 tenants 表。

​
更改应用程序访问域名

在 docker-compose.yaml 中更新 APP_WEB_URL。