你的知识存在哪里？PandaWiki + cpolar把本地知识库体验拉满

前言云笔记用了好几年该踩的坑基本踩遍了。印象最深的一次半夜赶方案需要调一份之前整理过的资料结果云端同步抽风笔记点开是一片空白。重启、重登、换网络能试的都试了最后是从缓存里勉强捞回来半份内容。内容存在别人服务器上这种事儿出一次就够让人长记性了。云端工具方便是方便但说到底你的笔记、你的知识、你的思考结晶放在别人那里就是放在别人那里。同步抽风、会员涨价、隐私协议悄悄改这种事情谁用谁知道。真正需要那篇笔记的时候它在不在、能不能打开不取决于你。换过好几个方案备忘录、笔记软件、文档协作平台最后发现真要解决把知识管起来这件事还是得自己搭。本地跑一个 PandaWiki文档全部存在自己 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文档全部存在自己 NAS 上大模型接进去做检索和问答配合 cpolar 打通外网访问在公司、在路上都能直接查。这套跑通之后用下来的实际感受是知识终于在自己手上了。