前言资料越来越多很多人都有同一种烦恼。工作文档放在电脑里学习笔记散落在各种笔记软件中收藏的网页躺在浏览器书签里下载的PDF又堆在网盘和NAS里。平时觉得都保存好了真正需要的时候却怎么也找不到。刚开始还能靠搜索硬撑。时间一长文档越来越多关键词越来越模糊经常出现一种情况明明记得自己看过甚至还认真整理过可就是找不出来。最无奈的是同样的问题隔几个月又要重新搜索、重新学习一次。很多人选择把资料全部塞进云笔记。确实方便但新的问题又来了。容量限制、会员功能、平台绑定、隐私顾虑一个都不少。尤其是一些工作资料、技术文档或者内部知识长期放在第三方平台上总会让人觉得少了点安全感。PandaWiki给出的思路完全不同。它不是单纯存放资料而是把这些文档变成一个能够理解内容、回答问题的本地AI知识库。无论是Markdown、PDF、网页资料还是技术文档都可以统一管理并借助大模型能力进行搜索、问答和知识整理。再结合飞牛NAS和cpolar即使人在外面也能随时访问属于自己的知识中心。1 PandaWiki是什么PandaWiki 是一款 AI 大模型驱动的开源知识库搭建系统帮助你快速构建智能化的产品文档、技术文档、FAQ、博客系统借助大模型的力量为你提供AI 创作、AI 问答、AI 搜索等能力。主要功能和特色包括AI 驱动智能化AI 辅助创作、AI 辅助问答、AI 辅助搜索。强大的富文本编辑能力兼容 Markdown 和 HTML支持导出为 word、pdf、markdown 等多种格式。轻松与第三方应用进行集成支持做成网页挂件挂在其他网站上支持做成钉钉、飞书、企业微信等聊天机器人。通过第三方来源导入内容根据网页 URL 导入、通过网站 Sitemap 导入、通过 RSS 订阅、通过离线文件导入等。2 在飞牛NAS 上部署 PandaWiki2.1 安装PandaWiki首先登录到飞牛NAS,然后打开设置将ssh这一栏的选项打开ssh功能打开后使用shell工具进行远程登录连接这里以finalshell为例填写飞牛的相关ssh信息连接上ssh,然后切换至root用户如果已经是用的root用户连接则无需切换,输入如下命令会提示输入密码输入不会提示sudo-i然后执行如下命令进入pandawiki的交互式菜单页面bash-c$(curl-fsSLkhttps://release.baizhi.cloud/panda-wiki/manager.sh)选择安装默认在安装选项然后回车选择安装的目录不修改的话默认直接回车即可等待拉取镜像安装完成会有如下提示记住其中的内网访问地址以及用户名和密码信息访问给的内网访问地址如果出现如下不安全提示点击高级然后点击继续前往即可然后就可以正常到登录页面啦输入控制台中的用户名和密码信息进行登录:成功登录到PandaWiki首页2.2 修改管理员密码为了方便下次登录这里进行修改一下密码鼠标上移到修改密码栏目可以看到如下提示前面我们设置的安装位置是/data/pandawiki/,所以我们可以用命令直接修改该目录下的.env文件vim/data/pandawiki/.env进入文件后键盘按I进入编辑模式然后修改管理后台登录密码栏的密码修改完成后按Esc输入英文的:wq回车即可保存退出然后执行如下命令进行刷新(/data/pandawiki为安装目录,安装位置不同则需要替换该部分):dockercompose-f/data/pandawiki/docker-compose.yml up-d2.3 配置智能对话模型在首页点击去添加按钮然后在左侧选择您要添加的对话模型的供应商这里以DeepSeek为例如果您本地有部署AI也可以使用Ollama本地模型官网推荐使用DeepSeek模型提示需要API Key,我们来到DeepSeek的官网创建一个API Keyhttps://platform.deepseek.com/api_keys创建好后点击复制粘贴到PandaWiki的DeepSeekAPI Key栏目中然后点击获取模型列表获取到后选择一个模型这里选择Reasoner保存后会提示需要创建一个Wiki站需要填写知识库名称这里以测试为例然后直接点击保存如果提示端口可能已被其他程序占用将80端口换一个即可配置完成后点击右上角的访问WIKI网站进行测试测试wiki页面:成功进入到了知识库页面PandaWiki就已经配置好啦3 使用PandaWiki在前面已经配置好啦PandaWiki,接下来我们使用一下PandaWiki首先点击右上角的创建文档参考如下图这里创建了一个Markdown文件夹接下来导入一个markdown文件以当前文章为例点击通过离线导入,拖拽或点击选择文件进来即可点击拉取数据后等待一会然后选择该文件点击导入数据即可导入完成提示点击完成接着点击去发布按钮发布新版本输入版本号和版本描述也可以使用默认生成的版本信息点击确认提示发布成功后点击右上角的访问WIKI网站可以看到左侧已经目录已经显示了创建的Markdown文件目录和导入的Markdown文件点击文件还可以显示markdown内容我们可以点击右上角的搜索输入框进行提问或者点击左上角的logo图标回到首页,进行提问这里以如下问题进行提问如何安装PandaWiki可以看到DeepSeek检索到了我的文档然后进行分析和思考了官方推荐使用的是Chat模型这里用的Reasoner因为输出会带思考可以更详细的看到模型思考的内容可以看到本文章中写的图片也能正常的显示出来将完整的步骤呈现出来了。在结尾的部分还有引用列表,引用了当前提供的这篇文章至此PandaWiki 的部署与基础使用已经跑通你已经完成了安装、初始配置、模型接入、文档导入与发布AI 检索问答也能正常工作本地内网访问一切 OK。4 使用cpolar穿透PandaWiki以支持公网访问通过前面的步骤你已经成功搭建了一个功能强大的本地 AI 知识库PandaWiki。但是你是否遇到过这样的困扰当你在公司、咖啡厅或者出差时想要远程访问家里的 PandaWiki却发现只能通过局域网访问或者当同事/朋友想要体验你的知识库与 AI 问答时却因为网络限制而无法分享这些场景正是内网穿透技术要解决的核心痛点。本章将带你使用 cpolar 内网穿透工具让 PandaWiki 突破局域网限制实现全球任意地点的安全远程访问真正实现“知识库随身携带”的终极体验。4.1 什么是cpolar?cpolar 是一款内网穿透工具可以将你在局域网内运行的服务如本地 Web 服务器、SSH、远程桌面等通过一条安全加密的中间隧道映射至公网让外部设备无需配置路由器即可访问。广泛支持 Windows、macOS、Linux、树莓派、群晖 NAS 等平台并提供一键安装脚本方便部署。4.2 安装cpolar首先在finalshell的命令窗口中执行如下命令(非root用户需要输入飞牛云nas的密码)sudocurlhttps://get.cpolar.sh|sh安装完成后执行下方命令查看cpolar服务状态sudosystemctl status cpolarcpolar安装和成功启动服务后在浏览器上输入飞牛云主机IP加9200端口访问Cpolar管理界面使用官网注册的账号登录,登录后即可看到配置界面,接下来在web界面配置即可4.3 穿透PandaWiki项目的WebUI界面4.3.1 随机域名方式(免费方案)随机域名方式适合预算有限的用户。使用此方式时系统会每隔24 小时左右自动更换一次域名地址。对于长期访问的不太友好但是该方案是免费的如果您有一定的预算可以查看大纲4.3.2的固定域名方式且访问更稳定。点击左侧菜单栏的隧道管理展开进入隧道列表页面页面下默认会有 2 个隧道ssh隧道指向22端口tcp协议website隧道指向8080端口http协议http协议默认会生成2个公网地址一个是http另一个https免去配置ssl证书的繁琐步骤点击编辑website的隧道修改成我们PandaWiki需要的信息接着来到在线隧道列表可以看到名称为PandaWiki-2443隧道的两条记录信息一条协议为http,另一条协议为https:以https为例访问测试成功访问到了登录界面让我们使用前面修改后的密码进行登录测试一下登录成功且正常显示了上传的Markdown文档接下来我们还需要穿透一下知识库搜索页面即WIKI网站点击设置页面查看端口可以看到配置的端口为8088即前面手动配置的端口默认为80接下来回到cpolar后台点击创建隧道:创建成功后来到在线隧道列表里面可以看到名称为wiki-index-8088隧道的两条记录信息一条协议为http,另一条协议为https:以https为例访问测试一下访问成功且可以正常进行提问恭喜你已经成功实现了 PandaWiki 的远程访问现在无论你身在何处只要有网络就能随时访问你的专属AI本地知识库了真正实现了”AI知识库随身携带”的终极体验。记得免费方案每24小时会更新域名地址及时获取新地址即可持续享受远程访问的便利。4.3.2 固定域名方式升级任意套餐皆可通过前面的配置我们已经成功实现了PandaWiki 的远程访问但免费随机域名方案的局限性也逐渐显现每24小时自动更换域名地址意味着你需要频繁更新书签、重新分享链接甚至可能因为忘记更新而无法访问。固定域名方案正是为了解决这些痛点而生让你拥有一个永久不变的专属地址真正实现稳定可靠的远程AI本地知识库。好啦接下来开始固定保留二级子域名教程首先进入官网的预留页面:https://dashboard.cpolar.com/reserved选择预留菜单即可看到保留二级子域名项填写其中的地区、名称、描述可不填项然后点击保留按钮操作步骤图如下列表中显示了两条已保留的二级子域名记录地区显示为China Top。二级域名显示为pandawiki用来设置知识库管理页面的。二级域名显示为indexwiki用来设置知识库首页提问页面。注二级域名是唯一的每个账号都不相同请以自己设置的二级域名保留的为主接着进入侧边菜单栏的隧道管理下的隧道列表可以看到名为PandaWiki-2443的隧道点击编辑按钮进入编辑页面来到状态菜单下的在线隧道列表可以看到隧道名称为PandaWiki-2443的公网地址已经变更为二级子域名固定域名主体及后缀的形式了这里以https协议做访问测试访问成功接着来配置知识库首页的固定子域名回到隧道列表编辑wiki-index-8088隧道填写好二级子域名相关的信息然后点击更新再次来到状态菜单下的在线隧道列表可以看到隧道名称为wiki-index-8088的公网地址已经变更为二级子域名固定域名主体及后缀的形式了以https协议进行访问测试(修改为deepseek-chat模型效果,不进入思考直接简洁回答)访问成功至此两个固定二级子域名均已生效PandaWiki 管理后台与WIKI 首页都可通过固定的 HTTPS 公网地址稳定访问分享与远程协作更省心。5 给Wiki首页添加访问授权验证在完成公网部署后我们发现Wiki首页默认无需登录即可访问这在家庭或团队环境中可能存在安全隐患。为了确保只有授权用户才能使用我们的本地AI知识库cpolar提供了便捷的访问授权验证功能。5.1 为什么需要访问授权隐私保护防止他人随意访问你的创作内容资源安全避免AI API密钥被恶意使用访问控制确保只有团队成员或指定人员可以使用成本控制防止API调用量被恶意消耗5.2 配置访问授权验证首先打开cpolar管理界面进入隧道管理→隧道列表找到wiki-index-8088隧道点击编辑按钮在编辑页面中点击高级按钮展开高级配置选项按照下图进行设置在HttpAuth这一栏输入admin:123456 其中【admin】为你想要设置的账号中间的冒号是英文的不是中文【123456】为想要给admin用户设置的密码5.3 验证授权效果重新访问你的公网地址会发现浏览器弹出登录验证框输入刚才设置的用户名和密码即可正常访问编辑器。这样你的Wiki首页就具备了基础的安全防护既保持了便捷的远程访问能力又确保了内容与资源的安全。总结PandaWiki真正解决的并不是文档存储问题而是知识利用问题。过去资料虽然保存下来了但真正需要的时候依然要自己翻找、筛选和整理。而在接入大模型之后这些静态文档开始具备理解和回答能力让知识从“存着”变成了“能用”。本文完成了PandaWiki在飞牛NAS上的部署并结合DeepSeek模型实现了知识检索、智能问答以及文档管理功能。从文档导入、版本发布到AI问答已经形成了一套完整的本地知识库工作流。通过cpolar配置公网访问之后这套知识库也突破了局域网限制。无论是在办公室、出差途中还是移动设备上都能够随时访问自己的资料库让过去分散在各个平台中的知识重新集中起来。如果你也正在被各种笔记软件、网盘和资料夹折磨那么PandaWiki值得尝试。毕竟知识最有价值的时候不是存进去的那一刻而是需要的时候能够立刻找到答案的时候。