Python
悠悠
2025年10月23日

这个开源知识库太香了!PandaWiki搭建全过程,踩坑经验全分享

最近公司要搭建一个内部知识库,领导让我调研几个方案。说实话,市面上的知识库产品真的是五花八门,什么Confluence、Notion、语雀啥的,但要么收费贵得离谱,要么功能不够用。

偶然间发现了PandaWiki这个开源项目,试用了一下发现还真不错。界面简洁,功能够用,关键是免费!今天就把我搭建的整个过程分享给大家,希望能帮到有需要的朋友。

什么是PandaWiki

项目地址:https://github.com/chaitin/PandaWiki

演示体验demo:https://192.168.198.133:2443/doc/editor/019a131f-12df-759c-a1a9-194d3c5ae47c

PandaWiki是一个基于Go语言(好多项目都是go开发的,看来确实得学go了!!!)开发的轻量级知识库系统,支持Markdown编辑,有着不错的用户体验。相比其他重量级的知识库系统,它的部署和维护都相对简单。

我之前用过MediaWiki,那个配置起来真的是要命,光是数据库配置就能折腾半天。PandaWiki就不一样了,基本上几个命令就能跑起来。

环境准备

在开始之前,我们需要准备一台Linux服务器。我这里用的是Debian 13(老演员了!),配置是2核4G,对于小团队使用完全够了。

首先更新一下系统:

apt update && apt upgrade -y

然后安装一些必要的工具:

apt install -y wget curl git vim

开始部署PandaWiki

一条命令搞定安装!!舒服!

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

选择安装还是升级!会让你确认安装目录,无脑回车就行,也是通过docker部署

image-20251023213114270

image-20251023213208688

(最喜欢看这种安装界面了哈哈哈哈)

image-20251023220217387

还有交流群二维码!!哈哈哈

image-20251023220459889

初始化配置

打开浏览器访问 http://你的服务器IP:8080,应该能看到PandaWiki的初始化页面。

image-20251023220530719

第一次访问会要求你创建管理员账户。我建议用户名不要用admin这种太常见的,密码也要设置复杂一点。

初始化完成后,你就能看到一个干净的知识库界面了。界面还是挺清爽的,左侧是目录树,右侧是内容区域。

让你配置大模型

image-20251023220558965

很丰富

image-20251023220635404

注册靠谱白嫖一个(不是广告!)

image-20251023220924635

image-20251023221144428

基本使用

新手文档:https://192.168.198.133:2443/doc/editor/019a131f-12da-76b3-bafe-3cfbe1069e69

创建文档

点击"新建文档"按钮,可以选择创建普通文档或者文件夹。PandaWiki支持Markdown语法,写起来还是很顺手的。

我试着创建了几个测试文档,发现它的Markdown渲染效果还不错,代码高亮、表格、图片都支持得挺好。

我这里直接通过rss来导入自己博客的文档!通过rss订阅可以直接拉取很多地方的操作文档!

image-20251023221230727

这是拉取到的博客文章:

image-20251023221349903

image-20251023221514687

去发布

image-20251023221559297

导入本地文本

image-20251023221748656

这就是财富!!!

image-20251023221817409

发布!!!

image-20251023221844078

使用统计!

image-20251023221912162

常用配置

image-20251023221955508

使用体验

用了一段时间下来,感觉PandaWiki还是挺不错的。界面简洁,功能够用,性能也还可以。我们团队大概20多个人在用,响应速度还是很快的。

当然也有一些不足的地方,比如权限管理相对简单,插件生态也不够丰富。但对于大多数中小团队来说,这些功能已经够用了。

最重要的是它是开源免费的,不用担心突然收费或者服务停止。而且代码托管在GitHub上,如果有需要还可以自己修改。

我感觉很nice!!

image-20251023222249616

image-20251023222300079

会给出具体的引用,我准备用这个来替代我的博客搜索了哈哈哈

写在最后

PandaWiki作为一个轻量级的知识库解决方案,确实有它的优势。部署简单,维护方便,功能够用,关键是免费开源。

虽然在一些高级功能上可能不如商业产品,但对于大多数团队来说已经足够了。特别是对于预算有限的小团队,这绝对是个不错的选择。

如果你也在寻找知识库解决方案,不妨试试PandaWiki。反正是免费的,试试又不会怀孕。

部署过程中如果遇到问题,可以查看官方文档或者GitHub上的issue。社区虽然不大,但还是比较活跃的。

好了,今天的分享就到这里。如果这篇文章对你有帮助,记得点个赞转发一下。有问题的话也可以在评论区留言,我看到会回复的。


如果这篇文章对你有帮助,别忘了点赞转发支持一下!想了解更多运维实战经验和技术干货,记得关注微信公众号@运维躬行录,领取学习大礼包!!!我会持续分享更多接地气的运维知识和踩坑经验。让我们一起在运维这条路上互相学习,共同进步!

公众号:运维躬行录

个人博客:躬行笔记

文章目录

博主介绍

热爱技术的云计算运维工程师,Python全栈工程师,分享开发经验与生活感悟。
欢迎关注我的微信公众号@运维躬行录,领取海量学习资料

微信二维码