> ## Documentation Index
> Fetch the complete documentation index at: https://dify-6c0370d8-docs-new-agent-experience.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 常见问题

> 本文档由 AI 自动翻译。如有任何不准确之处，请参考 [英文原版](/en/self-host/deploy/troubleshooting/common-issues)。

## 身份验证与访问

### 重置管理员密码

对于 Docker Compose 部署：

```bash theme={null}
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. 重启服务：

```bash theme={null}
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
```

允许来自错误中网络段的连接：

```bash theme={null}
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：

```bash theme={null}
docker exec -it docker-api-1 flask reset-encrypt-key-pair
```

源代码（在 `api` 目录下）：

```bash theme={null}
flask reset-encrypt-key-pair
```

<Warning>
  此操作不可逆。所有工作区的 LLM 凭据和工具凭据（内置、自定义、MCP 工具）将一并清除，需重新录入。
</Warning>

## 工作空间管理

### 重命名工作空间

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

### 更改应用程序访问域名

在 `docker-compose.yaml` 中更新 `APP_WEB_URL`。