飞牛NAS部署PandaWiki：自托管AI知识库与远程访问实战

2026-09-02 16:25 2 阅读

在数字化办公日益普及的今天，个人与团队的知识管理正面临前所未有的挑战。资料呈指数级增长，传统的文件夹分类、云盘存储或笔记软件往往难以应对海量信息的检索难题。明明记得某个问题曾写过，却不知答案藏在哪篇文档中，这种“信息过载”带来的焦虑感日益加剧。PandaWiki的出现，为这一痛点提供了全新的解决方案。它不仅仅是一个文档管理系统，更是一个基于大模型驱动的智能知识库平台，能够将Markdown、网页、RSS订阅等多种格式的内容整合，并赋予其AI搜索、AI问答及内容辅助生成的能力。

文章配图

本文将深入探讨如何在飞牛NAS（Nextcloud）环境中部署PandaWiki，构建一套完全自托管的AI知识库系统。我们将完成从环境初始化、模型配置、文档导入到公网远程访问的全流程实践。特别地，我们将利用cpolar内网穿透技术，突破局域网限制，实现全球任意地点的安全访问，并针对Wiki前台配置访问授权验证，确保数据隐私与资源安全。通过本文，你将掌握一套可复用的、具备生产级安全能力的本地化知识管理架构。

一、PandaWiki核心功能与价值

PandaWiki是一款开源的AI大模型驱动知识库搭建系统，其核心价值在于将静态文档转化为动态的智能知识源。它支持AI辅助创作、AI辅助问答以及AI辅助搜索，极大地提升了知识检索与利用的效率。

其核心功能特色包括：

AI驱动的智能交互：无论是复杂的代码调试、技术文档编写，还是日常FAQ解答，PandaWiki都能借助大模型提供精准的辅助。它不仅能回答“是什么”，还能解释“为什么”和“怎么做”，并自动标注引用来源。
强大的富文本编辑能力：系统兼容Markdown和HTML格式，支持导出为Word、PDF、Markdown等多种格式，完美适配各类办公场景。其编辑器直观易用，支持拖拽上传、在线预览及版本管理。
灵活的第三方集成：PandaWiki支持作为网页挂件嵌入现有网站，或转化为钉钉、飞书、企业微信等即时通讯工具中的智能机器人，实现知识服务的无缝嵌入。
多元化的内容导入：支持通过网页URL抓取、网站Sitemap自动同步、RSS订阅以及离线文件导入等多种方式，轻松汇聚全网或本地资源，构建庞大的知识库。

二、飞牛NAS环境下的PandaWiki部署

2.1 安装与初始化

部署的第一步是确保飞牛NAS具备SSH访问权限。登录飞牛NAS，进入设置界面，开启SSH服务选项。随后，使用FinalShell等SSH客户端工具连接飞牛服务器，切换到root用户（若已使用root则无需切换），执行以下命令进入PandaWiki的安装交互菜单：

bash -c "$(curl -fsSLk https://release.baizhi.cloud/panda-wiki/manager.sh)"

在交互式菜单中，选择安装选项（默认即可），指定安装目录（默认/data/pandawiki/，可直接回车），等待镜像拉取完成。安装成功后，系统会提示内网访问地址、用户名及密码，请妥善记录。

访问内网地址时，若出现浏览器安全警告，请点击“高级”并选择“继续前往”。登录成功后，即进入PandaWiki控制台首页。

2.2 管理员密码修改

为便于后续维护，建议修改默认安装密码。由于PandaWiki基于Docker Compose运行，可直接编辑安装目录下的.env文件进行修改：

vim /data/pandawiki/.env

在文件中找到管理后台登录密码字段，使用I键进入编辑模式，输入新密码，按Esc键退出编辑，输入:wq保存并退出。随后重启服务使配置生效：

docker compose -f /data/pandawiki/docker-compose.yml up -d

2.3 智能对话模型配置

PandaWiki的智能化能力依赖于后端大模型。在控制台首页点击“去添加”，选择模型供应商。本文以DeepSeek为例（也可使用本地Ollama部署的模型）。前往DeepSeek官网创建API Key，复制后填入PandaWiki的对应字段，点击“获取模型列表”，选择Reasoner模型（该模型具备更强的推理与思考能力）。

保存后，系统提示创建Wiki站点，填写知识库名称（如“技术文档库”），点击保存。若端口冲突，可调整端口号。配置完成后，点击“访问WIKI网站”进行测试，即可进入知识库首页，标志着基础部署成功。

三、知识库构建与AI问答验证

部署完成后，实际构建知识库是验证系统功能的关键步骤。

3.1 文档导入与发布

点击右上角“创建文档”，新建一个Markdown文件夹。将一篇Markdown文档（如本文内容）拖入或选择上传，点击“拉取数据”等待解析，随后选择该文件并点击“导入数据”。导入完成后，点击“去发布”，输入版本号及描述，确认发布。此时，左侧导航栏将显示新文档目录，点击即可查看Markdown源码。

3.2 AI检索与问答验证

进入Wiki首页，利用顶部的搜索框提问：“如何安装PandaWiki？”。系统会自动检索知识库中的文档内容，结合DeepSeek模型进行推理。由于使用了Reasoner模型，回答过程会展示详细的思考链，不仅给出步骤，还会解释关键操作背后的逻辑。回答末尾会附带引用列表，明确标注答案来源于哪篇文档，实现了真正的“有据可依”。

此过程验证了PandaWiki“文档导入 - 索引构建 - AI检索 - 智能问答 - 引用溯源”的完整链路已畅通无阻，内网访问功能运行正常。

四、基于cpolar的内网穿透与公网访问

尽管内网部署满足了基础需求，但在出差、远程办公或团队协作场景中，局域网访问的局限性日益凸显。此时，内网穿透技术成为连接本地资源与外部世界的桥梁。

4.1 cpolar工具简介

cpolar是一款轻量级、安全可靠的内网穿透工具，能够将局域网内的Web服务、SSH服务、远程桌面等映射至公网，无需配置路由器或购买云服务器。它支持Windows、macOS、Linux、树莓派及各类NAS设备，提供一键安装脚本，极大降低了远程访问的门槛。

4.2 安装与配置

在飞牛NAS的SSH终端执行安装命令：

sudo curl https://get.cpolar.sh | sh

安装完成后，通过浏览器访问飞牛IP加9200端口进入cpolar管理后台，使用注册账号登录。

4.3 隧道配置与公网访问

4.3.1 随机域名免费方案

在“隧道管理”中，找到指向PandaWiki WebUI（默认8080端口）的隧道，点击编辑。选择“随机域名”模式，系统会自动生成一个临时公网地址（HTTP与HTTPS）。访问该地址即可登录PandaWiki，验证文档显示正常。随后，配置Wiki前台（默认8088端口），创建另一条隧道。此时，无论身处何地，均可通过生成的随机链接访问知识库并进行AI问答，实现了“知识库随身携带”。

4.3.2 固定二级子域名方案

随机域名每24小时更换，不利于长期分享。为获得永久稳定的访问地址，可配置固定二级子域名。进入cpolar预留页面，申请保留二级域名（如pandawiki用于管理后台，indexwiki用于Wiki前台）。申请成功后，在隧道编辑页面将公网地址修改为二级域名.cpolar.run格式。更新后，访问固定地址即可，地址永久不变，分享链接无需更新，极大提升了协作效率。

五、Wiki首页访问授权与安全加固

公网暴露意味着安全风险。PandaWiki Wiki前台默认无需登录即可访问，这在家庭或团队环境中可能引发隐私泄露或API密钥滥用。利用cpolar的高级配置功能，可轻松实现访问授权验证。

在cpolar隧道编辑页面，点击“高级”选项，在HttpAuth栏输入用户名:密码（如admin:123456）。保存后，访问公网Wiki地址时，浏览器将弹出登录验证框。只有输入正确凭证的用户才能进入编辑器。这一措施既保留了远程访问的便捷性，又构建了第一道安全防线，有效防止未授权访问，保护了知识库内容与API资源的安全。

六、总结与展望

本文完整演示了从飞牛NAS部署PandaWiki，到构建自托管AI知识库，再到实现公网安全访问的全流程。通过实际案例，我们验证了文档导入、AI检索、问答生成及引用溯源等核心功能的高效运行。同时，结合cpolar内网穿透与访问授权技术，成功解决了远程访问难、数据安全性低等痛点，构建了一套具备生产级安全能力的本地化知识管理方案。