实战记录：如何使用 Docker 一键部署长亭 PandaWiki 智能知识库

简介

PandaWiki（长亭科技出品）是一款革命性的开源知识库搭建系统，它结合了传统 Wiki 的强大功能与大语言模型（LLM）的智能。通过集成 AI 辅助创作、智能问答和高级搜索，PandaWiki 帮助团队快速构建智能化的产品文档、FAQ 和博客。本指南将详细介绍如何使用官方推荐的 Docker 一键脚本，在几分钟内完成 PandaWiki 的完整部署和配置。

准备工作

在开始部署之前，请确保您的服务器满足以下基本要求：

操作系统 ：支持 Docker 20.x 以上版本的 Linux 系统（如 Ubuntu、CentOS、Debian 等）。
权限：您需要具有 root 权限或能够执行 sudo 命令。
网络：服务器可以连接到互联网，以便拉取 Docker 镜像和连接 AI 模型 API。
硬件（推荐） ：由于集成了多个服务（数据库、向量库、AI 逻辑），建议至少具有 2GB 内存 和 4GB+ 磁盘空间。

第 1 步：执行官方一键安装脚本

PandaWiki 团队提供了一个极其丝滑的一键安装脚本，大大简化了部署过程。

在服务器的终端中，使用以下命令下载并执行安装脚本：

Bash

复制代码

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

步骤说明： 此脚本会自动检查您的系统环境，并启动交互式安装程序。

第 2 步：自动化部署和容器管理

在脚本的引导下，安装程序将开始从 Docker 镜像仓库拉取 PandaWiki 的所有组件。

系统将自动执行以下操作：

拉取包括前端、后端（PandaWiki API 和 APP）、消费者、PostgreSQL、Redis、Caddy、Minio、Nats 和 Qdrant 向量库在内的所有必要镜像。
生成配置文件和变量。
使用 Docker Compose 启动并关联所有容器服务。

安装完成后，终端将输出 SUCCESS 信息，包括访问地址和初始管理员凭据。

第 3 步：访问网络控制台

部署成功后，您可以使用浏览器打开终端输出中的访问地址（通常是 http://你的服务器IP:2443）。

您将看到一个现代化的登录界面：

默认凭据（首次登录后建议更改）：

用户名 ：admin
密码：（请参见脚本执行完毕后的输出。不要忘记更改默认密码！）

第 4 步：初始配置和 AI 模型设置

PandaWiki 的灵魂在于其 AI 能力，因此首次登录后，系统会自动启动配置向导。

由于 PandaWiki 集成了向量库（RAG），AI 功能依赖于一个连接的 LLM。配置向导将指导您完成新 Wiki 站点的设置，包括模型连接。

在"模型配置"步骤中，您可以选择 自动配置 。系统会自动检测并验证模型。百智云模型广场 是官方推荐的、可免费注册并快速获得额度的模型连接选项。

第 5 步：获取和验证 API 密钥

如果您选择连接到特定的大模型平台（如百智云），向导会重定向您去生成一个 API Key。

你需要去百智云平台创建一个新 Token：

将生成的 Key 回填到配置向导的 API Key 输入框中。系统将验证它，以确保 PandaWiki 可以通过 RAG 协议连接到 LLM。

第 6 步：完成配置并启动站点

验证完成并在配置向导中设置其他选项后，您将看到最终的确认页面：

点击 "访问 Wiki 网站" 按钮。恭喜，您现在可以开始向您的智能知识库添加文档和发布内容了！

结论：启用 AI 驱动的交互

通过完成这些步骤，您现在已经部署了一个完整的 Chaitin PandaWiki 智能知识库。

您可以访问您的公共用户站点（默认路径），并立即开始从您上传的文档中提取智能。在首页上，您可以针对您的文档进行 AI 提问和高级搜索。

您的知识库不仅是一个文档管理工具，而且是一个由 AI 赋能的协作和创作平台。