ChatbotUI 零基础部署搭建实战指南
项目简介
ChatbotUI是一个开源的AI聊天界面,提供类似ChatGPT的用户体验,支持对接多种AI后端(如OpenAI API、LocalAI等)。
核心功能:
美观的聊天界面多会话管理支持Markdown渲染可自定义提示词库技术栈:
Next.js (React框架)TypeScriptTailwind CSSVercel AI SDKGitHub地址:
https://github.com/mckaywrigley/chatbot-ui (★12.4k)
云耀服务器配置选型
机型 | CPU | 内存 | 存储 | 带宽 | 适用场景 |
---|---|---|---|---|---|
HECS-L1 | 1核 | 2GB | 40GB | 2M | 测试/低负载 |
HECS-L2 | 2核 | 4GB | 80GB | 5M | 推荐配置 |
HECS-L4 | 4核 | 8GB | 160GB | 10M | 高并发/企业级 |
推荐选择HECS-L2机型,平衡性能与成本,可流畅运行ChatbotUI及配套服务。
通用部署流程
1. 运行环境准备
# 更新系统sudo apt update && sudo apt upgrade -y# 安装Node.js 18.xcurl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -sudo apt install -y nodejs# 验证安装node -vnpm -v
2. 获取项目代码
git clone https://github.com/mckaywrigley/chatbot-ui.gitcd chatbot-ui
3. 安装依赖
npm install
4. 配置环境变量
创建.env.local
文件:
OPENAI_API_KEY=your_api_key_hereNEXT_PUBLIC_DEFAULT_MODEL=gpt-4
5. 构建并启动服务
npm run buildnpm run start
服务默认运行在3000端口,访问http://your_server_ip:3000
即可使用。
Nginx完整配置
创建/etc/nginx/sites-available/chatbotui
配置文件:
server { listen 80; server_name your_domain.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_read_timeout 300s; proxy_send_timeout 300s; } # 启用gzip压缩 gzip on; gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript; # 静态资源缓存 location /_next/static { alias /path/to/chatbot-ui/.next/static; expires 365d; access_log off; }}
启用配置并重启Nginx:
sudo ln -s /etc/nginx/sites-available/chatbotui /etc/nginx/sites-enabledsudo nginx -tsudo systemctl restart nginx
安全加固建议
HTTPS配置(使用Let's Encrypt免费证书)
sudo apt install certbot python3-certbot-nginxsudo certbot --nginx -d your_domain.com
防火墙设置
sudo ufw allow 80sudo ufw allow 443sudo ufw enable
进阶配置
使用PM2进程管理
npm install -g pm2pm2 start "npm run start" --name chatbot-uipm2 savepm2 startup
多语言支持
修改src/utils/constants.ts
中的语言配置,添加新的语言包。
自定义主题
通过修改tailwind.config.js
和CSS变量可调整界面颜色和样式。
至此,ChatbotUI已成功部署并可通过域名访问。该方案提供完整的生产环境部署流程,包含性能优化和安全配置,适合长期稳定运行。