本文档由 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 的后端 URLCONSOLE_WEB_URL - 控制台 Web 的前端 URLSERVICE_API_URL - 服务 API URLAPP_API_URL - WebApp API 后端 URLAPP_WEB_URL - WebApp URL
更新配置后重启服务。
更改默认端口
修改 .env 配置：
EXPOSE_NGINX_PORT=80
EXPOSE_NGINX_SSL_PORT=443
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 中配置邮件设置：
- 设置邮件参数（SMTP 设置）
- 重启服务：
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 exec -it docker-api-1 flask reset-encrypt-key-pair
api 目录下）：
flask reset-encrypt-key-pair
此操作不可逆。所有工作区的 LLM 凭据和工具凭据（内置、自定义、MCP 工具）将一并清除，需重新录入。
工作空间管理
重命名工作空间
直接修改数据库中的 tenants 表。
更改应用程序访问域名
在 docker-compose.yaml 中更新 APP_WEB_URL。
