PandaWiki部署指南：本地服务器快速搭建教程-优快云博客

PandaWiki部署指南：本地服务器快速搭建教程

【免费下载链接】PandaWiki 项目地址: https://gitcode.com/gh_mirrors/pa/PandaWiki

1. 环境准备

1.1 系统要求

操作系统：Linux (推荐Ubuntu 20.04+/CentOS 8+)
Docker版本：20.10.x及以上
硬件配置：
- CPU：至少2核
- 内存：至少4GB RAM
- 硬盘：至少20GB可用空间
- 网络：可访问互联网（用于拉取镜像和依赖）

1.2 依赖检查

在开始部署前，请确认系统已安装Docker和Docker Compose：

# 检查Docker版本
docker --version

# 检查Docker Compose版本
docker compose version

若未安装，请执行以下命令安装依赖：

# Ubuntu/Debian系统
sudo apt update && sudo apt install -y docker.io docker-compose

# CentOS/RHEL系统
sudo yum install -y docker docker-compose
sudo systemctl enable --now docker

2. 项目获取

2.1 克隆代码仓库

使用以下命令克隆PandaWiki项目代码：

git clone https://gitcode.com/gh_mirrors/pa/PandaWiki.git
cd PandaWiki

2.2 目录结构说明

克隆完成后，项目主要目录结构如下：

PandaWiki/
├── backend/           # 后端服务代码
├── web/               # 前端Web界面
│   ├── admin/         # 管理控制台
│   └── app/           # 用户前台应用
├── images/            # 项目图片资源
└── LICENSE            # 开源许可证

3. 部署步骤

3.1 快速安装脚本

PandaWiki提供了一键安装脚本，执行以下命令启动部署流程：

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

3.2 安装过程配置

脚本执行后，将显示安装选项菜单：

PandaWiki 安装管理器
1) 全新安装
2) 升级现有安装
3) 卸载PandaWiki
4) 检查状态
请选择操作 [1-4]: 1

输入1选择"全新安装"，然后根据提示完成以下配置：

端口设置：默认使用2443端口，如需修改请输入自定义端口号
数据存储路径：建议使用默认路径/var/lib/panda-wiki
网络配置：选择适合的网络模式（默认桥接模式）

3.3 等待部署完成

安装过程将自动完成以下操作：

拉取Docker镜像
创建数据卷
配置服务容器
启动系统服务

部署完成后，终端将显示成功信息：

SUCCESS  控制台信息:
SUCCESS    访问地址(内网): http://192.168.1.100:2443
SUCCESS    用户名: admin
SUCCESS    密码: 6b8f4d2e9a7c3b5d

4. 系统访问与初始化

4.1 登录管理控制台

打开浏览器访问安装完成后显示的内网地址（如http://192.168.1.100:2443），将看到登录界面：

使用默认 credentials 登录：

用户名：admin
密码：安装完成时显示的随机密码

4.2 修改初始密码

首次登录后，系统会强制要求修改默认密码：

输入当前密码（安装时生成的随机密码）
设置新密码（建议包含大小写字母、数字和特殊符号）
确认新密码并提交

4.3 配置AI模型

PandaWiki核心功能依赖AI模型，需完成以下配置：

登录后点击左侧导航栏【系统设置】→【AI模型配置】
在"Chat模型"配置区域选择模型类型（如百智云、GPT等）
填写API密钥和相关参数
点击【测试连接】验证配置是否正确
保存配置

5. 服务管理

5.1 查看服务状态

使用安装脚本可快速检查服务运行状态：

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

选择菜单选项4查看状态，正常运行时将显示：

PandaWiki服务状态:
- panda-wiki-api: 运行中 (Up 2 hours)
- panda-wiki-web: 运行中 (Up 2 hours)
- panda-wiki-db: 运行中 (Up 2 hours)

5.2 启动/停止服务

通过Docker Compose命令管理服务：

# 进入项目目录
cd PandaWiki

# 启动服务
docker compose up -d

# 停止服务
docker compose down

# 重启服务
docker compose restart

5.3 日志查看

如需排查问题，可查看服务日志：

# 查看后端API日志
docker compose logs -f backend

# 查看前端Web日志
docker compose logs -f web

6. 常见问题解决

6.1 端口冲突

若提示端口已被占用，可修改docker-compose配置文件：

# 编辑配置文件
vi docker-compose.yml

# 修改端口映射（示例将2443改为8080）
services:
  web:
    ports:
      - "8080:80"

6.2 服务启动失败

若服务无法启动，通常是数据卷权限问题，执行以下命令修复：

sudo chown -R 1000:1000 /var/lib/panda-wiki
docker compose restart

6.3 忘记管理员密码

通过命令行重置管理员密码：

# 进入后端容器
docker exec -it panda-wiki-backend sh

# 执行密码重置命令
./panda-wiki reset-password admin

7. 部署架构说明

7.1 服务组件

PandaWiki部署后包含以下核心组件：

mermaid

7.2 数据流向

用户请求处理流程：

mermaid

8. 安全加固建议

8.1 防火墙配置

限制访问端口，仅开放必要服务端口：

# 设置防火墙规则
sudo ufw allow 2443/tcp   # PandaWiki服务端口
sudo ufw allow ssh        # 保留SSH访问
sudo ufw enable           # 启用防火墙

8.2 定期备份

设置定时任务备份数据：

# 创建备份脚本
cat > /usr/local/bin/backup-pandawiki.sh << 'EOF'
#!/bin/bash
BACKUP_DIR="/var/backups/pandawiki"
TIMESTAMP=$(date +%Y%m%d_%H%M%S)
mkdir -p $BACKUP_DIR

# 备份数据库
docker exec panda-wiki-db pg_dump -U postgres pandawiki > $BACKUP_DIR/db_$TIMESTAMP.sql

# 备份数据卷
tar -czf $BACKUP_DIR/data_$TIMESTAMP.tar.gz /var/lib/panda-wiki

# 保留最近30天备份
find $BACKUP_DIR -type f -mtime +30 -delete
EOF

# 添加执行权限并设置定时任务
chmod +x /usr/local/bin/backup-pandawiki.sh
echo "0 2 * * * /usr/local/bin/backup-pandawiki.sh" | crontab -

9. 升级与维护

9.1 版本升级

使用官方脚本进行版本升级：

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

选择菜单选项2进行升级，脚本将自动完成：

拉取最新代码
更新Docker镜像
执行数据库迁移
重启服务

9.2 定期维护

建议每周执行以下维护操作：

# 清理无用Docker资源
docker system prune -af

# 更新系统补丁
sudo apt update && sudo apt upgrade -y   # Ubuntu/Debian
# 或
sudo yum update -y                       # CentOS/RHEL

# 重启服务使更新生效
docker compose restart

10. 部署验证清单

部署完成后，请通过以下清单验证系统状态：

检查项	验证方法	预期结果
Web访问	浏览器访问部署地址	显示登录页面
登录功能	使用管理员账号登录	成功进入控制台
模型配置	测试AI生成功能	可正常生成内容
知识库创建	创建测试知识库	知识库创建成功
内容发布	发布一篇测试文档	前台可访问该文档
搜索功能	搜索测试文档内容	可正确返回搜索结果

总结

通过本教程，你已成功在本地服务器部署了PandaWiki系统。现在你可以：

创建和管理知识库
配置AI模型增强Wiki功能
发布和分享文档内容
对系统进行日常维护和升级

如有更多需求，可参考官方文档或社区讨论获取进阶配置指南。

【免费下载链接】PandaWiki 项目地址: https://gitcode.com/gh_mirrors/pa/PandaWiki

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考