小白教程：3 分钟搭建私有 AI 聊天机器人（支持 ChatGPT / Claude / 本地模型）

当下各类大模型 AI 工具使用需求越来越高，常规在线 AI 工具存在诸多限制：ChatGPT 需要特殊网络环境、Claude 需单独注册账号、本地模型手动部署门槛高、对话数据存在第三方收集风险。

借助开源项目 Open WebUI，零基础也能快速搭建私有化 AI 聊天面板，一站式整合主流大模型服务。

支持接入 ChatGPT、Claude、Gemini 等云端接口，同时兼容 Ollama 本地离线模型，自带中文界面、对话记录、文件解析、语音交互等功能，全程容器化一键部署，三分钟即可完成搭建，适合个人私有 AI 助手部署使用。

整套部署基于云服务器完成，新手可选用、腾讯云轻量等主流机型搭建，低配置即可满足基础使用。

一、效果预览

部署完成即可拥有私有化 AI 服务：

✅ 仿 ChatGPT 精美网页聊天界面

✅ 完整中文适配，使用无门槛

✅ 自动保存对话历史、收藏对话记录

✅ 支持图片识别、文档文件上传解析

✅ 内置语音输入，解放双手

✅ 数据本地私有化存储，杜绝信息泄露

二、准备工作

2.1 服务器配置要求

表格

补充说明：

仅对接云端 API（ChatGPT、Claude），2G 内存即可流畅运行；

如需部署 Ollama 本地离线大模型，建议内存 8GB 以上，保证推理流畅。

2.3 必备条件

• 一台正常运行的云服务器
• 域名可选（仅用于 HTTPS 域名访问，IP 直连可不用）

三、Docker 一键极速部署

3.1 远程连接服务器

Windows 打开 PowerShell，Mac 打开终端，执行连接命令：

ssh root@你的服务器IP

输入服务器 root 密码，出现命令行标识即连接成功。

3.2 一键安装 Docker

curl -fsSL https://get.docker.com | sh
systemctl start docker && systemctl enable docker

等待脚本自动完成安装，全程无需额外操作。

3.3 Docker Compose 一键部署 Open WebUI

mkdir -p open-webui && cd open-webui

cat > docker-compose.yml << 'EOF'
version: "3.9"

services:
  open-webui:
    image: ghcr.io/open-webui/open-webui:main
    container_name: open-webui
    restart: always
    ports:
      - "3000:8080"
    volumes:
      - ./data:/app/backend/data
    environment:
      - OLLAMA_BASE_URL=http://localhost:11434
EOF

docker compose up -d

3.4 放行端口访问

防火墙放行 3000 端口：

ufw allow 3000/tcp

同时前往云服务商控制台，在安全组 / 防火墙中放行 3000 端口，避免访问拦截。

3.5 部署完成

浏览器直接访问：

http://你的服务器IP:3000

即可进入私有化 AI 聊天面板，首次注册管理员账号即可使用。

四、多类型 AI 模型配置教程

4.1 接入云端 API 模型（简单高效）

适合不想占用本地资源、快速使用优质大模型的用户：

1. 进入 Open WebUI 右上角设置，找到接口配置
2. 选择 OpenAI 通用接口，填写对应参数
3. 填入第三方代理地址或官方接口地址、专属密钥，保存生效

通用主流接口参考：

• 通用 OpenAI 接口：适配各类国内中转聚合平台
• Claude 官方接口：对接 Anthropic 系列大模型
• 统一聚合 OneAPI：集中管理多品牌模型渠道

4.2 部署本地离线模型（完全免费无网络限制）

借助 Ollama 部署本地大模型，断网也能使用，数据完全本地化：

安装 Ollama

curl -fsSL httpsollama.com/install.sh | sh
systemctl enable ollama && systemctl start ollama

拉取轻量化中文模型

# 轻量中文模型，低配服务器推荐
ollama pull qwen2.5:3b

# 高清中文大模型，效果更好（推荐8G内存以上）
ollama pull qwen2.5:7b

# 查看已安装本地模型
ollama list

面板关联本地模型

设置 - 接口配置中填写 Ollama 本地地址：

http://localhost:11434

保存后，聊天界面即可自由切换云端模型与本地离线模型。

五、域名与 HTTPS 配置（可选）

5.1 域名解析

在域名管理平台添加 A 记录解析，雨云、阿里云、腾讯云解析操作逻辑一致：

• 主机记录：ai /chat 自定义前缀
• 记录类型：A
• 记录值：填写服务器公网 IP

5.2 Nginx 反向代理

apt install nginx -y

cat > /etc/nginx/sites-available/open-webui << 'EOF'
server {
    listen 80;
    server_name ai.yourdomain.com;
    client_max_body_size 100M;
    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}
EOF

ln -s /etc/nginx/sites-available/open-webui /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx

5.3 自动申请免费 SSL 证书

apt install certbot python3-certbot-nginx -y
certbot --nginx -d ai.yourdomain.com

配置完成后，自动实现 HTTPS 加密访问，提升访问安全性。

六、实用进阶使用技巧

6.1 自定义专属 AI 助手

在工作区配置中新建聊天机器人，针对不同场景定制：

• 写作助手：调高创造性参数
• 代码助手：强化逻辑与精准度
• 翻译 / 办公助手：优化文案规整能力

6.2 私有知识库问答

支持上传 PDF、TXT、文档资料，绑定知识库后，AI 可基于私有文档精准回答，适合学习、办公、资料问答场景。

6.3 语音交互

内置语音输入按钮，支持语音实时转文字，日常聊天、快速提问更便捷。

七、常见问题排查

面板无法访问

1. 检查容器运行状态：docker compose ps
2. 确认服务器防火墙、安全组已放行 3000 端口
3. 查看服务日志排查异常：docker compose logs -f

本地模型加载卡顿

1. 优先使用 3B 轻量化小模型，降低内存占用
2. 关闭服务器多余后台进程，释放资源
3. 配置模型后台常驻，减少重复加载耗时

服务版本更新

cd open-webui
docker compose pull
docker compose up -d

一键拉取最新镜像，无缝升级功能。

八、项目总结

整体私有化 AI 搭建流程极简，零基础也能快速上手：

1. 远程连接云服务器
2. 一键安装 Docker 环境
3. Compose 脚本秒级部署面板
4. 按需配置云端接口或本地离线模型
5. 绑定域名 + HTTPS，长期稳定使用

Open WebUI 兼容性强、功能完善，兼顾云端高速模型与本地离线需求，个人日常 AI 聊天、文案创作、代码辅助、资料问答都能满足，全程私有化部署，隐私性更强。