PandaWiki：轻量级开源知识库系统部署与智能问答实践

1. PandaWiki 项目概述

PandaWiki 是一款轻量级的开源知识库系统，专注于文档管理和智能问答功能。作为一个长期关注 AI 技术落地的从业者，我发现很多企业在构建知识库时面临两难选择：要么选择功能全面但资源消耗大的企业级方案，要么选择需要大量定制开发的底层引擎。PandaWiki 恰好填补了中间地带，提供了开箱即用的知识库产品体验。

与 RAGFlow 这类全功能 RAG 引擎相比，PandaWiki 的优势在于：

• 更轻量的资源占用（实测单机 4GB 内存即可流畅运行）
• 更简单的部署流程（Docker 一键部署）
• 更友好的产品化界面（非技术人员也能快速上手）
• 更聚焦的使用场景（主要针对产品文档、技术文档、FAQ 等结构化内容）

2. 本地部署方案详解

2.1 部署环境准备

官方推荐 Linux 环境部署，但通过以下改造方案，Mac/Windows 用户也能顺利运行：

核心改造点解析：

1. 网络模式调整
   原方案使用 network_mode: host，在 Mac/Windows 的 Docker 虚拟机架构下无效。改造为 Bridge 网络 + 固定 IP 分配，确保容器间通信正常。

2. Socket 共享方案
   Mac 文件系统不支持直接挂载 Socket 文件，改用 Docker 命名卷方式实现容器间 Socket 共享。

3. 端口暴露机制
   原方案的自动端口暴露失效，改为手动预留 8081-8090 端口范围，通过显式端口映射提供服务。

2.2 具体部署步骤

环境要求：

bash复制# 最低配置
操作系统: macOS 10.15+/Windows 10+
Docker: 20.10.0+
内存: 4GB+
磁盘: 10GB+

部署流程：

1. 创建部署目录

   bash复制mkdir -p ~/pandawiki/deploy && cd $_
   

2. 配置环境变量

   bash复制cat > .env << 'EOF'
   TIMEZONE=Asia/Shanghai
   SUBNET_PREFIX=169.254.15
   POSTGR