宝塔面板部署

本教程包含 宝塔手动部署 和 宝塔Docker部署

统一前置准备

最低配置要求
CPU：≥2核（建议4核）
内存：≥4GB RAM（建议8GB）
存储：≥5GB 空闲空间

Git安装（如果已安装可跳过）

Ubuntu / Debian系统
sudo apt update
sudo apt install -y git
CentOS / AlmaLinux / RockyLinux / RHEL 系列安装git
sudo yum install -y git
验证是否安装
git --version
# 输出版本信息则介绍安装成功
# git version 2.xx.x

获取代码

打开www/wwwroot目录，打开宝塔终端，执行以下命令：
cd /www/wwwroot
# 将官方部署包上传并解压到 ./chatbuddy-ai
# 部署包可在官网控制台「部署包下载」中获取

配置环境变量

image.png
cd /www/wwwroot/chatbuddy-ai
cp .env.example .env # 方式一
vi .env
# 按 i 打开修改模式
# 接着根据自身配置修改 APP_DOMAIN 环境变量为准备部署的域名，比如https://example.com
# 修改完后记得按 ESC 接着输入 :wq 提交退出 # 方式二
# 手动双击.env文件执行同上对应修改并提交文件
如果前端需求其他域名，需修改 .env 中的 VITE_PRODUCT_APP_BASE_URL，只求本站则留空就能

开始安装

宝塔 Docker 部署

确保面板已安装 Docker 软件拉取代码和配置环境变量
image.png
docker -v
# 输出下面内容表示已安装
# Docker version 28.x.x
image.png
启动项目
cd /www/wwwroot/chatbuddy-ai
docker compose up -d
image.png
image.png
等待约1～2分钟完全拉取镜像后，等待项目构建，可执行以下命令浏览进度
docker logs chatbuddy-ai-nodejs
也可以通过宝塔可视化面板打开chatbuddy-ai-nodejs容器浏览日志
image.png
image.png
image.png
创建反代网站
image.png
image.png
image.png
恭喜你，Chatbuddy AI 已经成功部署且上线，你能够借助刚刚配置的域名访问 Chatbuddy AI 了！

宝塔手动部署

前置准备
PostgreSQL：17.x
Redis：8.x 或 7.x
NodeJS：22.20.x
前往软件商店分别安装 Redis 8或7 和 Node.js版本管理器
在Node.js 版本管理器中安装 22.x的版本，并配置命令行版本为改版本
按照下面流程安装 PostgreSQL：
cd /tmp
# 清华大学pgsql镜像源
wget https://mirrors.tuna.tsinghua.edu.cn/postgresql/source/v17.6/postgresql-17.6.tar.gz
# 或者
# 阿里镜像源
wget https://mirrors.aliyun.com/postgresql/source/v17.4/postgresql-17.4.tar.gz
# 下面以清华大学17.6镜像源举例
### 解压代码
```bash
tar -zxvf postgresql-17.6.tar.gz
cd postgresql-17.6
编译安装（启用 uuid 支持）
# 这里的/www/server/pgsql是你宝塔安装的pgsql的目录，一般是/www/server/pgsql
./configure --prefix=/www/server/pgsql --with-uuid=e2fs
make && make install
# 如果提示缺少uuid相关依赖则执行执行安装
sudo apt install -y uuid-dev
编译所有官方内置拓展
cd contrib
make && make install
安装第三方拓展
zhparser（中文分词）
cd /tmp
git clone https://github.com/amutu/zhparser.git
cd zhparser
make && make install
# 如果报scws有关的错那就先安装下面的scws依赖：
cd /tmp
wget https://www.xunsearch.com/scws/down/scws-1.2.3.tar.bz2
tar xjf scws-1.2.3.tar.bz2
cd scws-1.2.3
./configure --prefix=/usr/local/scws
make && make install
# 这里如果报No such file or directory，那就执行以下命令执行构建
make PG_CONFIG=/www/server/pgsql/bin/pg_config SCWS_HOME=/usr/local/scws
make install make PG_CONFIG=/www/server/pgsql/bin/pg_config
编译没错误之后重新打开zhparser执行编译
cd /tmp/zhparser
make PG_CONFIG=/www/server/pgsql/bin/pg_config SCWS_HOME=/usr/local/scws
pgvector（向量搜索）
cd /tmp
git clone https://github.com/pgvector/pgvector.git
cd pgvector
make && make install
激活拓展（统一在 chatbuddy-ai 数据库中执行）
切换到 psql 控制台
psql -U postgres -h localhost
创建 chatbuddy-ai 数据库（如果还没有）
CREATE DATABASE chatbuddy-ai;
切换到 fastbuild 数据库
\c chatbuddy-ai
激活需的拓展
-- 官方内置拓展
CREATE EXTENSION IF NOT EXISTS "uuid-ossp";
-- 中文分词
CREATE EXTENSION IF NOT EXISTS zhparser;
-- 向量搜索
CREATE EXTENSION IF NOT EXISTS vector;
到目前为止，环境已准备完毕
打开项目目录，执行预部署脚本
cd /www/wwwroot/chatbuddy-ai
pnpm predeploy
image.png
直到打印出Chatbuddy AI的logo和项目信息，说明环境准备完毕
打开到【站点】，切换到【Node项目】，选择【加入项目】
image.png
选择PM2项目，加入方式选择【从文件/内容加入】，选择www/wwwroot/chatbuddy-ai/scosystem.config.js配置文件
image.png
填写端口号为.env配置的APP_DOMAIN，运行用户选择为root，勾选【放行端口】，绑定域名为.env中配置的APP_DOMAIN。
选择提交，等待项目启动
image.png
image.png
可以在PM2监控中浏览项目状态和运行日志，状态为运行中介绍项目启动成功
image.png
image.png
image.png
上一篇🪤 部署教程下一篇Windows 环境下 Docker 部署

共 319 篇文档 · 内容同步自官方帮助中心