常见问题
部署
Q:最少需要什么配置?
CPU 服务器 4C8G 起步即可运行全栈(Milvus 内存占用较大,推荐 8G 以上内存)。使用 MinerU GPU 解析时另需一块 8G+ 显存的显卡。
Q:支持离线 / 内网环境吗?
支持。所有服务均可私有化部署,镜像可离线导入,模型可替换为内网部署的开源模型,全程不依赖外部网络。
Q:如何升级?
拉取新版本镜像后,需执行数据库迁移再重启服务(docker compose exec server ./ollmo migrate,或本地 make migrate)。生产环境升级前建议备份 MySQL 与 MinIO 数据。
Q:支持 HTTPS 与自定义域名吗?
支持。在 Web / API 前方挂 Nginx 或 Caddy 反代并配置证书即可,同时修改 .env 中的 CORS_ORIGINS。
模型与检索
Q:必须使用 SiliconFlow 吗?
不是。任何 OpenAI 兼容端点都可以接入,也支持 Ollama、vLLM 等自托管推理服务。安装向导只是提供一条开箱即用的默认路径。
Q:检索效果不好怎么办?
- 检查 Rerank 模型是否配置(对精度影响最大);
- 在「检索测试」页对比关键词与语义权重的平衡;
- 调整分块大小(复杂文档用父子分块);
- 为高频问题添加标注问答,命中即返回标准答案。
Q:支持哪些文件格式?
常见格式均可:PDF、DOCX、Markdown、TXT 等。使用 MinerU 解析时对复杂版面(表格、公式、扫描件)支持更好。
Q:回答会胡说八道吗?
ollmo 的回答基于检索到的片段并附出处引用。检索置信度不足时,标准 Agent 模板会走「直接回复」分支如实告知未找到内容,而不是强行编造。
数据与安全
Q:我的文档数据存在哪里?
全部在你的服务器:MySQL(元数据)、Milvus(向量)、MinIO(原始文件与解析产物),由你完全掌控。
Q:多租户之间数据隔离吗?
隔离。所有数据表携带 tenant_id,MySQL、Milvus、MinIO 全链路逻辑隔离,团队之间互不可见。
Q:有审计与用量管理吗?
有。管理控制台提供审计日志、用量与费用统计、团队配额管理(免费版 / 专业版 / 企业版)。
许可与支持
Q:可以商用吗?
可以。企业内部使用、商业应用开发、私有化交付均免费;运营与 ollmo 类似的多租户 SaaS 需商业授权。详见许可证。
Q:遇到问题去哪反馈?
GitHub Issues。商务与授权咨询:contact@ollmo.com。