Skip to content

赵月辉 / fastgpt-migrated

Go to a project
Commit 011e718b by Archer Committed by GitHub
Options

docs: add root password FAQ (#6921) 

* docs: add root password FAQ

* docs: remove FAQ heading numbers

* docs: run document update scripts
parent 88f967bb
Showing with 51 additions and 41 deletions
document/content/self-host/troubleshooting/faq.en.mdx
......@@ -3,7 +3,7 @@ title: General Troubleshooting
description: FastGPT Self-Hosting General Troubleshooting
---
### (1)Frontend Page Crash
### Frontend Page Crash
1. 90% of cases are due to incorrect model configuration: ensure that at least one model is enabled for each category; check if some `object` parameters in the model are abnormal (arrays and objects). If empty, try giving an empty array or empty object.
2. A small part is due to browser compatibility issues. Since the project contains some high-level syntax, lower version browsers may not be compatible. You can provide specific operation steps and error information in the console to the issue.
......@@ -11,14 +11,14 @@ description: FastGPT Self-Hosting General Troubleshooting
---
### (2)If deployed via sealos, are there no limitations of local deployment?
### If deployed via sealos, are there no limitations of local deployment?
![](../../../public/imgs/faq1.png)
This is the length limit of the indexing model. It is the same regardless of the deployment method, but the configuration of different indexing models is different, and parameters can be modified in the background.
---
### (3)How to mount the Mini Program configuration file
### How to mount the Mini Program configuration file
Mount the verification file to the specified location: /app/projects/app/public/xxxx.txt
......@@ -28,7 +28,7 @@ Then restart. For example:
---
### (4)Database port 3306 is occupied, service startup failed
### Database port 3306 is occupied, service startup failed
![](../../../public/imgs/faq3.png)
......@@ -36,21 +36,20 @@ Change the port mapping to 3307 or similar, for example 3307:3306.
---
### (5)Can it run purely locally?
### Can it run purely locally?
Yes. You need to prepare the vector model and LLM model.
---
### (6)Other models cannot perform question classification/content extraction
### Other models cannot perform question classification/content extraction
1. Check the logs. If it prompts JSON invalid, not support tool, etc., it means that the model does not support tool calling or function calling. You need to set `toolChoice=false` and `functionCall=false`, and it will default to the prompt mode. Currently, the built-in prompts are only tested for commercial model APIs. Question classification is basically usable, but content extraction is not very good.
2. If the configuration is normal and there are no error logs, it means that the prompt may not be suitable for the model. You can customize the prompt by modifying `customCQPrompt`.
---
### (7)Page Crash
### Page Crash
1. Turn off translation.
2. Check if the configuration file is loaded normally. If it is not loaded normally, system information will be missing, and it will cause a null pointer in some operations.
......@@ -62,21 +61,21 @@ Yes. You need to prepare the vector model and LLM model.
---
### (8)After enabling content completion, the response speed becomes slow
### After enabling content completion, the response speed becomes slow
1. Question completion requires a round of AI generation.
2. 3~5 rounds of queries will be performed. If the database performance is insufficient, there will be a significant impact.
---
### (9)Normal reply in the page, API error
### Normal reply in the page, API error
The page uses stream=true mode, so the API also needs to set stream=true for testing. Some model interfaces (mostly domestic) are a bit garbage in non-Stream compatibility.
Same as the previous question, curl test.
---
### (10)Knowledge base indexing has no progress/indexing is very slow
### Knowledge base indexing has no progress/indexing is very slow
First look at the log error information. There are several situations:
......@@ -86,10 +85,16 @@ First look at the log error information. There are several situations:
---
### (11)Connection error
### Connection error
Network exception. Domestic servers cannot request OpenAI, check whether the connection with the AI model is normal.
Or FastGPT cannot request OneAPI (not in the same network).
---
### How to change the root password
Modify the `DEFAULT_ROOT_PSW` environment variable, and then restart FastGPT.
---
document/content/self-host/troubleshooting/faq.mdx
......@@ -3,22 +3,22 @@ title: 通用问题排查
description: FastGPT 私有部署常见问题排查方式
---
### (1)前端页面崩溃
### 前端页面崩溃
1. 90% 情况是模型配置不正确：确保每类模型都至少有一个启用；检查模型中一些`对象`参数是否异常（数组和对象），如果为空，可以尝试给个空数组或空对象。
1. 90% 情况是模型配置不正确：确保每类模型都至少有一个启用；检查模型中一些 `对象` 参数是否异常（数组和对象），如果为空，可以尝试给个空数组或空对象。
2. 少部分是由于浏览器兼容问题，由于项目中包含一些高阶语法，可能低版本浏览器不兼容，可以将具体操作步骤和控制台中错误信息提供 issue。
3. 关闭浏览器翻译功能，如果浏览器开启了翻译，可能会导致页面崩溃。
---
### (2)通过sealos部署的话，是否没有本地部署的一些限制？
### 通过 sealos 部署的话，是否没有本地部署的一些限制？
![](../../../public/imgs/faq1.png)
这是索引模型的长度限制，通过任何方式部署都一样的，但不同索引模型的配置不一样，可以在后台修改参数。
---
### (3)怎么挂载小程序配置文件
### 怎么挂载小程序配置文件
将验证文件，挂载到指定位置：/app/projects/app/public/xxxx.txt
......@@ -28,7 +28,7 @@ description: FastGPT 私有部署常见问题排查方式
---
### (4)数据库3306端口被占用了，启动服务失败
### 数据库 3306 端口被占用了，启动服务失败
![](../../../public/imgs/faq3.png)
......@@ -36,67 +36,72 @@ description: FastGPT 私有部署常见问题排查方式
---
### (5)能否纯本地运行
### 能否纯本地运行
可以。需要准备好向量模型和LLM模型。
可以。需要准备好向量模型和 LLM 模型。
---
### (6)其他模型没法进行问题分类/内容提取
### 其他模型没法进行问题分类/内容提取
1. 看日志。如果提示 JSON invalid，not support tool 之类的，说明该模型不支持工具调用或函数调用，需要设置`toolChoice=false`和`functionCall=false`，就会默认走提示词模式。目前内置提示词仅针对了商业模型API进行测试。问题分类基本可用，内容提取不太行。
2. 如果已经配置正常，并且没有错误日志，则说明可能提示词不太适合该模型，可以通过修改`customCQPrompt`来自定义提示词。
1. 看日志。如果提示 JSON invalid，not support tool 之类的，说明该模型不支持工具调用或函数调用，需要设置 `toolChoice=false` 和 `functionCall=false`，就会默认走提示词模式。目前内置提示词仅针对了商业模型 API 进行测试。问题分类基本可用，内容提取不太行。
2. 如果已经配置正常，并且没有错误日志，则说明可能提示词不太适合该模型，可以通过修改 `customCQPrompt` 来自定义提示词。
---
### (7)页面崩溃
### 页面崩溃
1. 关闭翻译
2. 检查配置文件是否正常加载，如果没有正常加载会导致缺失系统信息，在某些操作下会导致空指针。
- 95%情况是配置文件不对。会提示 xxx undefined
- 提示`URI malformed`，请 Issue 反馈具体操作和页面，这是由于特殊字符串编码解析报错。
- 提示 `URI malformed`，请 Issue 反馈具体操作和页面，这是由于特殊字符串编码解析报错。
3. 某些api不兼容问题（较少）
3. 某些 API 不兼容问题（较少）
---
### (8)开启内容补全后，响应速度变慢
### 开启内容补全后，响应速度变慢
1. 问题补全需要经过一轮AI生成。
2. 会进行3~5轮的查询，如果数据库性能不足，会有明显影响。
1. 问题补全需要经过一轮 AI 生成。
2. 会进行 3~5 轮的查询，如果数据库性能不足，会有明显影响。
---
### (9)页面中可以正常回复，API 报错
### 页面中可以正常回复，API 报错
页面中是用 stream=true 模式，所以API也需要设置 stream=true 来进行测试。部分模型接口（国产居多）非 Stream 的兼容有点垃圾。
和上一个问题一样，curl 测试。
页面中是用 stream=true 模式，所以 API 也需要设置 stream=true 来进行测试。部分模型接口（国产居多）非 Stream 的兼容有点垃圾。和上一个问题一样，curl 测试。
---
### (10)知识库索引没有进度/索引很慢
### 知识库索引没有进度/索引很慢
先看日志报错信息。有以下几种情况：
1. 可以对话，但是索引没有进度：没有配置向量模型（vectorModels）
2. 不能对话，也不能索引：API调用失败。可能是没连上OneAPI或OpenAI
3. 有进度，但是非常慢：api key不行，OpenAI的免费号，一分钟只有3次还是60次。一天上限200次。
2. 不能对话，也不能索引：API 调用失败。可能是没连上 OneAPI 或 OpenAI
3. 有进度，但是非常慢：API key 不行，OpenAI 的免费号，一分钟只有 3 次还是 60 次。一天上限 200 次。
---
### (11)Connection error
### Connection error
网络异常。国内服务器无法请求OpenAI，自行检查与AI模型的连接是否正常。
网络异常。国内服务器无法请求 OpenAI，自行检查与 AI 模型的连接是否正常。
或者是FastGPT请求不到 OneAPI（没放同一个网络）
或者是 FastGPT 请求不到 OneAPI（没放同一个网络）
---
### (12)修改了 vectorModels 但是没有生效
### 修改了 vectorModels 但是没有生效
1. 重启容器，确保模型配置已经加载（可以在日志或者新建知识库时候看到新模型）
2. 记得刷新一次浏览器。
3. 如果是已经创建的知识库，需要删除重建。向量模型是创建时候绑定的，不会动态更新。
---
### 如何修改 root 密码
修改环境变量中的 `DEFAULT_ROOT_PSW`，然后重启 FastGPT。
---
document/data/doc-last-modified.json
......@@ -205,8 +205,8 @@
"content/self-host/migration/docker_mongo.mdx": "2026-04-26T21:08:47+08:00",
"content/self-host/troubleshooting/attention.en.mdx": "2026-04-26T21:08:47+08:00",
"content/self-host/troubleshooting/attention.mdx": "2026-04-26T21:08:47+08:00",
"content/self-host/troubleshooting/faq.en.mdx": "2026-04-26T21:08:47+08:00",
"content/self-host/troubleshooting/faq.mdx": "2026-04-26T21:08:47+08:00",
"content/self-host/troubleshooting/faq.en.mdx": "2026-05-12T16:38:31+08:00",
"content/self-host/troubleshooting/faq.mdx": "2026-05-12T16:38:31+08:00",
"content/self-host/troubleshooting/methods.en.mdx": "2026-04-26T21:08:47+08:00",
"content/self-host/troubleshooting/methods.mdx": "2026-04-26T21:08:47+08:00",
"content/self-host/troubleshooting/model-errors.en.mdx": "2026-04-26T21:08:47+08:00",
......@@ -272,7 +272,7 @@
"content/self-host/upgrading/4-14/4149.en.mdx": "2026-04-26T21:08:47+08:00",
"content/self-host/upgrading/4-14/4149.mdx": "2026-04-26T21:08:47+08:00",
"content/self-host/upgrading/4-15/4150.mdx": "2026-05-09T16:13:01+08:00",
"content/self-host/upgrading/4-15/41502.mdx": "2026-05-12T11:14:32+08:00",
"content/self-host/upgrading/4-15/41502.mdx": "2026-05-12T11:40:22+08:00",
"content/self-host/upgrading/outdated/40.en.mdx": "2026-04-26T21:08:47+08:00",
"content/self-host/upgrading/outdated/40.mdx": "2026-04-26T21:08:47+08:00",
"content/self-host/upgrading/outdated/41.en.mdx": "2026-04-26T21:08:47+08:00",
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or sign in to comment