使用文档常见问题

常见问题

处理安装、访问、MCP 连接和知识检索过程中最常见的问题。

本机可以访问,团队成员无法访问

默认应用只绑定 127.0.0.1:3000。远程成员应通过配置好的 HTTPS 反向代理访问。检查域名解析、TLS、代理上游和防火墙,见生产部署。

Compose 提示缺少数据库密码

确认在包含 compose.yaml 的部署目录运行,且 .env 中存在非空的 DB_PASSWORD。只在其他终端中使用 export 不会为新会话提供持久配置。

首次拉取镜像很慢

首次部署需要下载应用和数据库镜像。可用 docker compose pull 查看进度,并检查网络和磁盘空间。预构建镜像无需在本机编译产品;源码构建是可选的开发流程。

MCP 能连接,却看不到项目

检查令牌所属账号是否是项目成员,令牌白名单是否包含该项目,以及令牌档位、IP 和有效期限制。先列出可访问项目,再读取明确的目标。

Agent 修改后结果不明确

先重新读取工作项、文档或计划的实际数据。网络超时不代表写入失败,避免不加判断地重复创建或更新。检查实际状态与审计记录,再决定是否重试。

知识助手找不到文档

确认当前账号可以直接打开该文档,并核对会话项目范围。检查嵌入供应商、检索状态和模型配置。没有检索结果时,先直接打开原文,确认内容是否存在。

通知或流式答案延迟

检查反向代理是否启用响应缓冲,以及事件流连接是否被短超时中断。Caddy 可配置 flush_interval -1,nginx 应关闭相应响应的缓冲。

上传附件失败

核对应用附件限制、代理请求体限制、数据卷容量和写入权限。代理限制应为请求额外开销留出空间。

如何切换语言和外观

在 Feronavi 的个人偏好中切换中文或英文,以及明暗主题。

输入关键词,搜索全部使用文档。