diff --git a/zh_CN/getting-started/faq/install-faq.md b/zh_CN/getting-started/faq/install-faq.md index 1f22b5c..8db938a 100644 --- a/zh_CN/getting-started/faq/install-faq.md +++ b/zh_CN/getting-started/faq/install-faq.md @@ -1,7 +1,5 @@ # 本地部署相关 - - ### 1. 本地部署初始化后,密码错误如何重置? 若使用 docker compose 方式部署,可执行以下命令进行重置 @@ -66,7 +64,7 @@ FileNotFoundError: File not found * 本地调试(默认策略) - 开发模式同域策略。 支持 HTTP/HTTPS 协议,但需要保证前端页面和接口同域。 + 开发模式同域策略。 支持 HTTP/HTTPS 协议,但需要保证前端页面和接口同域。
WEB_API_CORS_ALLOW_ORIGINS: '*'
     CONSOLE_CORS_ALLOW_ORIGINS: '*'
@@ -76,7 +74,7 @@ FileNotFoundError: File not found
     
* 跨域策略(请勿应在生产) - 服务端与 web 客户端跨域,服务端必须为 https。 由于 SameSite=None 必须配合 Secure=true,因此服务端必须为 `https` 协议才能实现跨域访问,可以用在服务端在远程并且提供 `https` 协议支持,或者本地单独启动服务端和前端项目(localhost,但不同端口,实测可用,虽然提示 warning)。 + 服务端与 web 客户端跨域,服务端必须为 https。 由于 SameSite=None 必须配合 Secure=true,因此服务端必须为 `https` 协议才能实现跨域访问,可以用在服务端在远程并且提供 `https` 协议支持,或者本地单独启动服务端和前端项目(localhost,但不同端口,实测可用,虽然提示 warning)。 ``` WEB_API_CORS_ALLOW_ORIGINS: 'https://your-domain-for-web-app' @@ -87,7 +85,7 @@ FileNotFoundError: File not found ``` * 生产策略 - 严格模式。 由于部分第三方集成需要支持回调并带着 cookie 信息,因此不能使用最高的 Strict 策略,因此需要严格限制 CORS 域名,以及设置 cookie 策略为 SameSite=Lax, Secure=true。 + 严格模式。 由于部分第三方集成需要支持回调并带着 cookie 信息,因此不能使用最高的 Strict 策略,因此需要严格限制 CORS 域名,以及设置 cookie 策略为 SameSite=Lax, Secure=true。 ``` WEB_API_CORS_ALLOW_ORIGINS: 'https://your-domain-for-web-app' @@ -105,11 +103,7 @@ FileNotFoundError: File not found 这可能是由于切换了域名/网址,导致前端和服务端跨域,请将 `docker-compose.yml` 中所有的以下配置项改为新的域名: -`CONSOLE_API_URL:` 控制台 API 的后端 URL。 -`CONSOLE_WEB_URL:` 控制台网页的前端 URL。 -`SERVICE_API_URL:` 服务 API 的 URL。 -`APP_API_URL:` WebApp API 的后端 URL。 -`APP_WEB_URL:` WebApp 的 URL。 +`CONSOLE_API_URL:` 控制台 API 的后端 URL。 `CONSOLE_WEB_URL:` 控制台网页的前端 URL。 `SERVICE_API_URL:` 服务 API 的 URL。 `APP_API_URL:` WebApp API 的后端 URL。 `APP_WEB_URL:` WebApp 的 URL。 更多信息,请查看:[环境变量](../install-self-hosted/environments.md) @@ -117,6 +111,10 @@ FileNotFoundError: File not found 如果你是通过镜像启动,请重新拉取最新镜像完成升级。 如果你是通过源码启动,请拉取最新代码,然后启动,完成升级。 +源码部署更新时,需要进入 api 目录下,执行以下命令将数据库结构迁移至最新版本: + +`flask db upgrade` + ### 6. 使用 Notion 导入时如何配置环境变量 **问: Notion 的集成配置地址是什么?** @@ -131,3 +129,23 @@ FileNotFoundError: File not found 2. **`NOTION_CLIENT_SECRET`** : Notion OAuth 客户端密钥(用于公共集成类型)。 3. **`NOTION_CLIENT_ID`** : OAuth 客户端ID(用于公共集成类型)。 4. **`NOTION_INTERNAL_SECRET`** : Notion 内部集成密钥,如果 `NOTION_INTEGRATION_TYPE` 的值为 **internal**,则需要配置此变量。 + +### 7. 本地部署版,如何更改空间的名称? + +答:在数据库 `tenants` 表里修改。 + +### 8. 想修改访问应用的域名,在哪里修改? + +答:在 `docker_compose.yal` 里面找到 APP\_WEB\_URL 配置域名。 + +### 9. 如果发生数据库迁移,需要备份哪些东西? + +答:需要备份数据库、配置的存储以及向量数据库数据,若为 docker compose 方式部署,可直接备份 `dify/docker/volumes` 目录下所有数据内容。 + +### 10. 为什么 Docker 部署 Dify,本地启动 OpenLLM 用 127.0.0.1 却无法访问本地的端口? + +答:127.0.0.1 是容器内部地址, Dify 配置的服务器地址需要宿主机局域网 IP 地址。 + +### 11. 本地部署版如何解决数据集文档上传的大小限制和数量限制。 + +答:可参考官网环境变量说明文档去配置:https://docs.dify.ai/v/zh-hans/getting-started/install-self-hosted/environments