agent combo: 本地知识库问答（ollama + MaxKB）

Metadata

id	`combo-local-rag`	recorded	2026-09-01
members	2	status	verified

install script ↓

Members (2)

tool role version install guide

tool	role	version	install	guide
`ollama`	模型下载与运行底座	`>= 0.33.2（2026-08-29 实测版本；MaxKB 对接走 OpenAI 兼容 API，对版本不敏感）`	`curl -fsSL https://gh-proxy.com/https://github.com/ollama/ollama/releases/latest/download/install.sh \| sh # 或手动：下载 tar.zst 解压（需 tar --zstd 或 zstd 工具） curl -sL -o /tmp/ollama.tar.zst https://gh-proxy.com/https://github.com/ollama/ollama/releases/latest/download/ollama-linux-amd64.tar.zst mkdir -p /tmp/ollama-bin && tar --zstd -xf /tmp/ollama.tar.zst -C /tmp/ollama-bin /tmp/ollama-bin/bin/ollama --version`	guide
`MaxKB`	知识库问答台	`v2.10.5-lts（2026-08-06 发布，latest 标签）；需要 Docker（Compose 可选）；镜像 4.62GB（2026-09-01 daocloud 实测）`	`# 国内网络：走 daocloud 加速前缀（2026-09-01 实测可拉） docker run -d --name=maxkb --restart=always -p 8080:8080 \ -v ~/.maxkb:/opt/maxkb \ docker.m.daocloud.io/1panel/maxkb:latest # 官方原版（网络允许直连 Docker Hub 时） # docker run -d --name=maxkb --restart=always -p 8080:8080 -v ~/.maxkb:/opt/maxkb 1panel/maxkb`	—

ollama

模型下载与运行底座

>= 0.33.2（2026-08-29 实测版本；MaxKB 对接走 OpenAI 兼容 API，对版本不敏感）

curl -fsSL https://gh-proxy.com/https://github.com/ollama/ollama/releases/latest/download/install.sh | sh
# 或手动：下载 tar.zst 解压（需 tar --zstd 或 zstd 工具）
curl -sL -o /tmp/ollama.tar.zst https://gh-proxy.com/https://github.com/ollama/ollama/releases/latest/download/ollama-linux-amd64.tar.zst
mkdir -p /tmp/ollama-bin && tar --zstd -xf /tmp/ollama.tar.zst -C /tmp/ollama-bin
/tmp/ollama-bin/bin/ollama --version

guide

MaxKB

知识库问答台

v2.10.5-lts（2026-08-06 发布，latest 标签）；需要 Docker（Compose 可选）；镜像 4.62GB（2026-09-01 daocloud 实测）

# 国内网络：走 daocloud 加速前缀（2026-09-01 实测可拉）
docker run -d --name=maxkb --restart=always -p 8080:8080 \
  -v ~/.maxkb:/opt/maxkb \
  docker.m.daocloud.io/1panel/maxkb:latest
# 官方原版（网络允许直连 Docker Hub 时）
# docker run -d --name=maxkb --restart=always -p 8080:8080 -v ~/.maxkb:/opt/maxkb 1panel/maxkb

—

Install order

先 ollama（底座）——装完 ollama --version 冒烟，拉一个模型（国内网络此步最容易卡，见第 1 步卡住怎么办）。
再 MaxKB（知识库台）——Docker 起容器（默认 8080 端口），管理后台 → 模型设置 → 模型供应商选 ollama → 填 http://host.docker.internal:11434 → 选模型 → 建知识库 → 传文档 → 问答。

每步的"为什么 + 命令 + 装好确认 + 卡住怎么办"见「逐步教学」。

Dependency warnings

版本：ollama >= 0.33.2（实测）；MaxKB v2.10.5-lts（latest 标签）；Docker >= 20.10（compose 可选）。
环境：内存 >= 8GB（模型加载 + 向量化同时跑建议 16GB）；磁盘 MaxKB 镜像 4.62GB（实测）+ 模型 4-70GB；端口 11434（ollama）/8080（MaxKB）。
环境（实测坑）：snap/apt 版 ollama 默认只监听 127.0.0.1:11434，bridge 容器访问会被拒（connection refused，2026-09-01 实测）；解法 sudo snap set ollama host=0.0.0.0:11434（或 apt 版改启动参数）后重启，容器内经 172.17.0.1:11434 可达。注意 0.0.0.0 会暴露到局域网，按需配防火墙。
冲突：MaxKB×open-webui 若同机跑——两者都是「知识库问答」定位，功能重叠建议只留一个（possible-conflict，静态判定：端口不同但定位重叠）；ollama×MaxKB 为 compatible（MaxKB 只读 ollama API，无共享写面）；与本站其他工具无共享写面。
国内网络：ollama 二进制走 gh-proxy（实测）；模型走 ModelScope GGUF 导入（实测）或官方 registry（可能超时）；MaxKB 镜像走 daocloud 加速（实测）。

Linked problems

Evidence

Evidence details kept locally (2026-09-01)