简介

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

---

准备工作

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

1. 操作系统：支持 Docker 20.x 以上版本的 Linux 系统（如 Ubuntu、CentOS、Debian 等）。

2. 权限：您需要具有 root 权限或能够执行 sudo 命令。

3. 网络：服务器可以连接到互联网，以便拉取 Docker 镜像和连接 AI 模型 API。

4. 硬件（推荐）：由于集成了多个服务（数据库、向量库、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 赋能的协作和创作平台。