Files
FastGPT/document/content/docs/self-host/troubleshooting/s3-issues.en.mdx
T
zjj-225 f057a2ae19 docs(faq): 更新常见问题文档并新增注意事项页面 (#6465)
* docs(faq): 更新常见问题文档并新增注意事项页面

- 在 error.mdx 中调整问题序号并新增 OCR 配置问题
- 新增 attention.mdx 页面,提供问题排查步骤和技术支持指引
- 重构 dataset.mdx 内容结构,使用数字序号并补充知识库闪烁问题

* docs: 重构私有部署故障排查文档结构并新增详细指南

将原有的 FAQ 文档拆分为多个专题文档,包括通用问题排查、S3问题、OneAPI错误、模型可用性问题和排查方法。更新了导航菜单和目录结构,使文档组织更清晰,便于用户快速定位和解决特定问题。

新增了详细的故障排查步骤、CURL测试示例和具体错误解决方案,特别是针对对象存储连接、签名错误和模型调用失败等常见问题提供了更全面的指导。

* docs: 移除已弃用的 OneAPI 错误排查文档

移除 `oneapi-errors` 相关文档文件,因其内容已过时或合并至其他章节。同步更新中英文文档目录和元数据文件中的引用。

* docs: 更新文档FAQ内容,移除过时条目并重新编号

- 删除关于OneAPI官网的过时FAQ条目
- 重新编号故障排除FAQ章节,使序号连续
- 同步更新中英文文档内容保持一致

---------

Co-authored-by: Archer <545436317@qq.com>
2026-03-17 14:44:54 +08:00

37 lines
1007 B
Plaintext

---
title: S3 Issues Troubleshooting
description: FastGPT Self-Hosting Common S3 Issues Troubleshooting
---
## 1. Log shows ERR level "Failed to ensure external public/private bucket exists", resulting in inability to connect to object storage
### 1.1 Error Stack Display
- error: Error: getaddrinfo ENOTFOUND
Example
- ![](/imgs/faq4.png)
### Possible Errors
- STORAGE_S3_FORCE_PATH_STYLE configuration error
### Solution
- Turn on the STORAGE_S3_FORCE_PATH_STYLE option to `true`, otherwise the client cannot find the target service
---
## 2. Upload conversation file / knowledge base file error
Example
- ![](/imgs/faq5.png)
### 2.1 SignatureDoesNotMatched
- Signature inconsistency, mostly due to Nginx configuration error
### Possible Errors
- Necessary request headers (such as Headers, Host) were not passed during Nginx forwarding
### Solution
- Configure proxy_set_header Host $http_host, do not set to $host, Nginx's $host built-in variable will remove the port, set to $http_host
---