Chatbot UI 零基础部署搭建实战指南

1. 项目简介与GitHub地址

Chatbot UI 是一个开源的聊天机器人界面项目，它提供了一个美观且功能完整的AI聊天界面，可以对接多种大型语言模型(如OpenAI的GPT系列)。该项目设计简洁现代，支持多会话管理、消息历史记录和Markdown渲染等特性。

GitHub地址: https://github.com/mckaywrigley/chatbot-ui
GitHub趋势: 该项目长期位居GitHub趋势榜前列，获得超过20k星标

2. 云服务器配置选型

推荐使用云服务器(https://cloud.ciuic.com)进行部署，以下是建议配置：

基础配置(适合个人/小规模使用):

CPU: 2核内存: 4GB存储: 50GB SSD带宽: 5Mbps系统: Ubuntu 22.04 LTS

进阶配置(适合团队/生产环境):

CPU: 4核内存: 8GB存储: 100GB SSD带宽: 10Mbps系统: Ubuntu 22.04 LTS

选择建议：如果仅用于演示或个人使用，基础配置足够；如需对接正式API或有大量用户访问，建议选择进阶配置。

3. 通用部署流程

3.1 服务器基础环境准备

# 更新系统sudo apt update && sudo apt upgrade -y# 安装必要工具sudo apt install -y git curl wget# 安装Node.js环境(推荐使用nvm)curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bashsource ~/.bashrcnvm install 18nvm use 18# 安装PNPMnpm install -g pnpm

3.2 项目下载与配置

# 克隆项目git clone https://github.com/mckaywrigley/chatbot-ui.gitcd chatbot-ui# 安装依赖pnpm install# 复制环境变量文件cp .env.example .env.local# 编辑环境变量nano .env.local

在.env.local中配置必要的环境变量，如：

NEXT_PUBLIC_DEFAULT_MODEL=gpt-4NEXT_PUBLIC_DEFAULT_SYSTEM_PROMPT=You are ChatGPT...OPENAI_API_KEY=your_api_key_here

3.3 构建与运行

# 构建项目pnpm build# 运行项目pnpm start

此时项目会在3000端口运行，可以通过http://服务器IP:3000访问。

4. Nginx配置

为了安全性和更好的性能，建议使用Nginx作为反向代理。

4.1 安装Nginx

sudo apt install -y nginx

4.2 配置反向代理

创建配置文件：

sudo nano /etc/nginx/sites-available/chatbot-ui

添加以下内容：

server {    listen 80;    server_name yourdomain.com; # 替换为你的域名    location / {        proxy_pass http://localhost:3000;        proxy_http_version 1.1;        proxy_set_header Upgrade $http_upgrade;        proxy_set_header Connection 'upgrade';        proxy_set_header Host $host;        proxy_cache_bypass $http_upgrade;        proxy_set_header X-Real-IP $remote_addr;        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;    }}

启用配置：

sudo ln -s /etc/nginx/sites-available/chatbot-ui /etc/nginx/sites-enabledsudo nginx -tsudo systemctl restart nginx

4.3 HTTPS配置(可选但推荐)

使用Let's Encrypt免费SSL证书：

sudo apt install -y certbot python3-certbot-nginxsudo certbot --nginx -d yourdomain.com

证书会自动配置并设置自动续期。

5. 项目维护与管理

建议使用PM2管理Node进程：

npm install -g pm2pm2 start "pnpm start" --name chatbot-uipm2 savepm2 startup

设置开机自启：

sudo env PATH=$PATH:/home/ubuntu/.nvm/versions/node/v18.16.0/bin /home/ubuntu/.nvm/versions/node/v18.16.0/lib/node_modules/pm2/bin/pm2 startup systemd -u ubuntu --hp /home/ubuntu

至此，Chatbot UI已成功部署并可通过域名访问。如需进一步定制，可以参考项目文档修改前端界面或对接不同的AI模型API。

打赏