飞牛 NAS 部署 PandaWiki本地 AI 知识库跑通后怎么用 cpolar 给团队临时验收团队文档最怕两件事一是散在群文件、网盘、Markdown 仓库里谁都记不住最新版本在哪二是好不容易搭了 AI 知识库自己本地问得挺顺发给同事验收时又卡在“你们怎么访问”这一步。这篇就按一个很实在的场景来走飞牛 NAS 或家用 x86 小主机上部署 PandaWiki把团队文档、FAQ、产品手册导进去先在局域网里验收问答和引用效果再用 cpolar 开一个短时 HTTPS 入口给同事看。划重点cpolar 在这里只做临时验收入口。不要开放飞牛 NAS 管理后台不要开放数据库端口不要开放模型服务端口也不要把这个方案写成长期公网服务。1 这篇要跑通什么PandaWiki 是一款 AI 驱动的开源知识库系统适合把产品文档、技术文档、FAQ、博客内容整理成一个可检索、可问答的知识库。它支持 AI 问答、AI 搜索、Markdown / HTML 内容编辑也支持通过离线文件、网页 URL、Sitemap、RSS 等方式导入内容。放在飞牛 NAS 上的好处很直接机器常开、硬盘空间够、局域网访问方便团队内部资料不用先丢到一堆外部平台里。这篇文章的目标不是把所有高级功能讲完而是把一条可复用的验收链路跑顺在飞牛 NAS 上部署 PandaWiki导入一批团队文档和 FAQ用脱敏问题检查回答、检索、引用效果用 cpolar 临时生成 HTTPS 地址让同事远程验收验收结束后关闭入口不留下长期暴露面。这里有个小提醒如果团队文档里有客户名称、合同金额、访问密钥、内网地址先脱敏再导入。知识库问答越方便敏感信息扩散也越快这一点别偷懒。2 环境准备先确认 NAS 能跑 DockerPandaWiki 官方给出的运行要求很清楚Linux、x86_64 架构Docker 20.10.14 以上Docker Compose 2.0.0 以上。推荐资源是 1 核 CPU、2GB 内存、10GB 磁盘最低资源是 1 核 CPU、1GB 内存、5GB 磁盘。飞牛 NAS 或家用小主机只要是 x86_64并且已经装好 Docker就可以按这条路线走。ARM 机器不要硬套这篇命令PandaWiki 官方要求里写的是 x86_64。先 SSH 登录飞牛 NAS。这里建议用 NAS 后台里专门开的 SSH 账号别把日常管理密码到处复制。ssh 用户名飞牛NAS的局域网IP登录后检查 Docker 和 Compose 版本docker --version docker compose version uname -m你需要看到类似结果Docker version 20.10.14 或更高版本 Docker Compose version v2.0.0 或更高版本 x86_64如果uname -m不是x86_64这篇就不要继续照抄了。架构不对后面镜像和脚本都会变成排错现场。另外建议提前建一个专门目录后面排查和备份都更清楚sudo mkdir -p /volume1/docker/pandawiki cd /volume1/docker/pandawiki飞牛 NAS 上实际存储路径按你的卷名来。如果你的 Docker 应用目录不是/volume1/docker就换成自己机器上的真实路径别为了和教程一致把数据放到一个找不到的位置。3 安装 PandaWiki让控制台先在局域网打开PandaWiki 官方 README 给出的安装方式是使用 root 权限执行安装脚本bash -c $(curl -fsSLk https://release.baizhi.cloud/pandawiki/manager.sh)这条命令会拉起 PandaWiki 所需服务。安装完成后控制台默认监听9998端口默认账号和密码会在安装输出里随机生成。这里别急着关终端。把安装输出里的账号、密码、访问端口先复制到自己的密码管理器里后面登录控制台要用。真关掉了也不是不能找但没必要给自己加一道排错题。安装完成后在同一局域网电脑上访问http://飞牛NAS的局域网IP:9998能看到 PandaWiki 登录页就说明第一段链路通了。如果页面打不开按这个顺序查不要一上来就怀疑 PandaWikiNAS 的 IP 是否写错9998端口是否被防火墙拦住Docker 容器是否正常运行安装脚本输出里有没有报错。常用检查命令docker ps curl -I http://127.0.0.1:9998docker ps能看到相关容器curl能拿到 HTTP 响应再去浏览器访问 NAS 局域网 IP。如果本机127.0.0.1:9998都不通先别折腾 cpolar问题还在本地服务。4 配置模型只填 PandaWiki 需要用的接口登录 PandaWiki 后右上角进入系统配置配置供 PandaWiki 使用的大模型。PandaWiki 支持 DeepSeek、OpenAI、Ollama、硅基流动、月之暗面以及兼容 OpenAI 接口的其他模型服务。这里建议先只接一个模型供应商先把知识库问答跑通。模型接口越多出问题时越难判断是网络、Key、模型名还是知识库本身没索引好。配置时重点检查这几项API Key 不要多复制空格接口地址按供应商文档填写模型名称前后一致如果使用本地 Ollama只让 PandaWiki 能访问 Ollama 服务不要把 Ollama 端口直接开放到公网。这一步不是为了追求“参数填满”而是确认 PandaWiki 能正常调用模型。填好后可以先用一段很短的测试文档做问答确认模型能返回内容再导入大批量资料。5 导入团队文档别一口气把垃圾资料全塞进去AI 知识库效果好不好很多时候不是模型决定的而是你导进去的资料够不够干净。我更推荐先准备三类内容产品 FAQ适合测试高频问题操作手册适合测试步骤型回答故障排查文档适合测试引用和定位能力。如果文档分散在 Markdown、HTML、PDF、网页里先挑 10 到 20 篇最常用的资料导入。别一上来导整个网盘重复文档、旧版本文档、临时会议纪要混在一起后面回答质量会很难看。导入前建议做一次小清洗mkdir -p ~/pandawiki-import/faq mkdir -p ~/pandawiki-import/manual mkdir -p ~/pandawiki-import/troubleshooting把文档按类型放好文件名也写清楚比如faq/account-login.md manual/device-bind.md troubleshooting/payment-callback-error.md这里的目的不是整理得多漂亮而是让你回头排查引用时能看懂来源。如果 PandaWiki 回答引用了payment-callback-error.md你马上知道它命中了哪份文档。在 PandaWiki 里创建一个知识库比如叫“团队验收知识库”。导入内容后等索引处理完成再开始问答测试。看到文档列表和处理状态正常再进入下一步。6 本地验收用 6 个问题检查回答和引用本地验收不要只问“公司介绍是什么”这种大而空的问题。真正能暴露问题的是那些同事平时会问、答案必须准确的问题。可以准备一组脱敏问题1. 新成员第一次登录后台失败应该检查哪些配置 2. 设备绑定后没有显示在线排查顺序是什么 3. 支付回调失败时日志里应该看哪个字段 4. 产品手册里提到的导出限制是什么 5. 如果客户忘记管理员密码标准处理流程是什么 6. 某个功能不支持时FAQ 里推荐的替代方案是什么每个问题都看三件事回答有没有编造文档里不存在的内容引用来源能不能对上原文步骤型答案有没有漏掉关键前置条件。如果答案看起来很顺但引用对不上原文这种不能算通过。团队知识库最怕“语气很确定内容没依据”。验收时宁愿回答短一点也要能追到来源。我习惯做一个简单表格记录结果问题编号 | 是否命中文档 | 引用是否正确 | 回答是否可执行 | 备注 Q1 | 是 | 是 | 是 | 通过 Q2 | 是 | 否 | 否 | 文档有旧版本需清理 Q3 | 否 | 否 | 否 | 缺少日志字段说明如果某个问题没答好先回到文档本身补资料不要只想着换模型。知识库没有喂进去的内容模型答得越自信越危险。7 用 cpolar 开短时 HTTPS只给团队验收 PandaWiki 页面本地问答没问题后才轮到远程验收。这里用 cpolar 的目的很单纯临时生成一个 HTTPS 访问地址把 PandaWiki 页面发给同事检查。安全边界先写死不开放飞牛 NAS 管理后台不开放 SSH不开放 PostgreSQL、Redis 等数据库端口不开放本地模型服务端口只映射 PandaWiki 的 Web 端口9998验收结束就关闭隧道。因为飞牛 NAS 已经有 Docker用 cpolar Docker 方式会比较顺手docker pull probezy/cpolar docker run -id --network host --name cpolar probezy/cpolar启动后在浏览器打开 cpolar 本地 Web UIhttp://飞牛NAS的局域网IP:9200登录 cpolar 账号后创建 HTTP 隧道隧道名称pandawiki-review 协议http 本地地址9998 域名类型随机域名 地区按页面可选项选择创建成功后到“状态 → 在线隧道列表”里复制 HTTPS 公网地址。把这个地址发给同事同时发 PandaWiki 的临时验收账号或临时密码。如果你更喜欢命令行临时启动 HTTP 隧道也可以在已安装并登录 cpolar 的环境里执行cpolar http 9998命令行会输出对应的公网访问地址。这个方式适合短时调试终端关闭后就不再作为稳定入口使用。这里别把9200发给同事。9200是 cpolar 的本地 Web UI不是 PandaWiki 验收页。也别为了省事把 NAS 后台端口映射出去验收知识库不需要别人进 NAS 管理后台。8 团队验收给同事一张问题清单而不是只发链接很多远程验收失败不是工具问题是大家拿到链接后不知道看什么。建议你发给同事三样东西1. PandaWiki 临时访问地址 2. 临时登录账号或临时密码 3. 验收问题清单和反馈格式反馈格式可以简单一点问题 期望答案 PandaWiki 实际回答 引用是否正确 需要补充的文档同事只要按这个格式回你就知道该改文档、改知识库结构还是改模型配置。验收期间建议只开一个短窗口比如当天 30 分钟到 2 小时。验收完成后关闭 cpolar 容器或停止隧道docker stop cpolar如果后面还要继续用可以再启动docker start cpolar如果这次只是一次性验收结束后直接删除容器也行docker rm cpolar注意删除容器前要先确认不再需要它。团队验收这种场景宁愿按需打开也不要让临时入口默默跑一整个月。9 常见坑别让“能访问”掩盖真正的问题9.1 公网地址能打开但问答效果不好这通常不是 cpolar 的问题。cpolar 只负责把9998映射出去问答质量还是看 PandaWiki 的文档、索引和模型配置。优先检查文档是否导入成功文档内容是不是旧版本问题是否能在原文里找到答案引用来源是否指向正确文档模型接口是否正常返回。9.2 同事打开链接后看到登录页但没有账号这说明网络链路已经通了卡在应用登录。给同事准备临时账号或临时密码验收结束后立刻回收。不要把自己的管理员密码直接发群里。哪怕只是临时验收也要给自己留一点安全余地。9.3 本地能打开cpolar 地址打不开按顺序查curl -I http://127.0.0.1:9998 docker ps | grep cpolar再打开http://飞牛NAS的局域网IP:9200确认 cpolar Web UI 里隧道在线并且本地地址写的是9998。如果误填成9200同事打开的就不是 PandaWiki而是 cpolar 管理界面这个要立刻改掉。9.4 想长期给团队用怎么办这篇只讲临时验收。长期使用要重新设计权限、访问控制、备份、域名、日志和更新策略不能把“临时公网入口”当正式生产方案。如果只是团队内网长期用优先让大家走公司网络或内网访问。如果确实需要长期外部访问至少要单独评估账号权限、HTTPS、固定域名、访问审计和数据脱敏不要直接沿用这篇的临时配置。10 总结到这里我们已经把 PandaWiki 在飞牛 NAS / 家用小主机上的本地知识库链路跑通了先部署服务再导入团队文档和 FAQ用脱敏问题检查回答与引用确认本地效果后再用 cpolar 短时生成 HTTPS 入口给同事验收。这条链路里有几个点别省本地9998端口先验收通过再开 cpolar文档先清洗、分组、脱敏再导入知识库cpolar 只映射 PandaWiki Web 页面不碰 NAS 管理面、数据库和模型端口。如果你只是想证明“这个知识库能不能给团队用”临时验收入口已经够了。等问答质量、引用效果、文档维护流程都被同事认可再考虑长期访问方案会比一开始就把所有端口暴露出去稳得多。