Open WebUI 是一个功能丰富的自托管 AI 平台，支持完全离线运行。通过 老张API，您可以在 Open WebUI 中集成各种主流大语言模型。

​
快速部署

​
Docker 快速启动

docker run -d -p 3000:8080 \
  --add-host=host.docker.internal:host-gateway \
  -v open-webui:/app/backend/data \
  --name open-webui \
  --restart always \
  ghcr.io/open-webui/open-webui:main

​
Docker Compose 部署

version: '3.6'

services:
  open-webui:
    image: ghcr.io/open-webui/open-webui:main
    container_name: open-webui
    ports:
      - "3000:8080"
    volumes:
      - open-webui:/app/backend/data
    environment:
      - OPENAI_API_BASE_URL=https://api.laozhang.ai
      - OPENAI_API_KEY=您的老张API密钥
    restart: unless-stopped

volumes:
  open-webui:

​
配置 老张API

​
方法一：环境变量配置

在部署时设置环境变量： 
docker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL=https://api.laozhang.ai \
  -e OPENAI_API_KEY=您的老张API密钥 \
  -v open-webui:/app/backend/data \
  --name open-webui \
  ghcr.io/open-webui/open-webui:main

​
方法二：界面配置

  1. 访问 Open WebUI 管理界面
  2. 进入 Settings > Connections
  3. 在 OpenAI API 部分配置：
    • API Base URL: https://api.laozhang.ai/v1
    • API Key: 输入您的 老张API 密钥
  4. 点击保存配置
配置要点
  • API Base URL 需要包含 /v1 后缀
  • API Key 可在 老张API控制台 获取
  • 建议使用环境变量方式，便于管理和更新

​
支持的模型

Open WebUI 通过 老张API 支持以下模型系列：

​
推荐模型

模型系列模型 ID特点
GPT-4 Turbogpt-4-turbo-2024-04-09最新 GPT-4，性能均衡
Claude Sonnetclaude-sonnet-4-20250514长文本处理，创意写作
Gemini Progemini-2.5-pro多模态能力，快速响应
GPT-3.5 Turbogpt-3.5-turbo经济实用，日常对话

​
特色功能模型

功能推荐模型说明
视觉理解gpt-4-vision-preview图片分析和理解
代码生成gpt-4-turbo编程辅助和代码优化
思维推理claude-sonnet-4-20250514-thinking显示思考过程

​
核心功能

​
RAG (检索增强生成)

Open WebUI 支持文档上传和知识库功能：
  1. 文档上传
    • 支持 PDF、TXT、DOCX 等格式
    • 自动向量化存储
    • 支持多语言文档
  2. 知识库管理
    • 创建专项知识库
    • 文档分类和标签
    • 智能检索匹配

​
OpenAI 兼容 API

Open WebUI 提供完整的 OpenAI 兼容 API： 
# 聊天完成
curl -X POST "http://localhost:3000/api/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer 您的老张API密钥" \
  -d '{
    "model": "gpt-4-turbo",
    "messages": [
      {"role": "user", "content": "Hello, world!"}
    ]
  }'

​
工具集成

支持外部工具和插件：
  • 网络搜索
  • 代码执行
  • 图像生成
  • 文档处理

​
高级配置

​
多模型配置

在 docker-compose.yml 中配置多个模型源： 
environment:
  - OPENAI_API_BASE_URL=https://api.laozhang.ai
  - OPENAI_API_KEY=您的老张API密钥
  - ENABLE_OPENAI_API=true
  - ENABLE_OLLAMA_API=false

​
用户权限管理

environment:
  - ENABLE_SIGNUP=false
  - DEFAULT_USER_ROLE=user
  - WEBHOOK_URL=您的webhook地址

​
数据持久化

volumes:
  - open-webui:/app/backend/data
  - ./uploads:/app/backend/data/uploads
  - ./vector_db:/app/backend/data/vector_db

​
API 集成示例

​
Python 集成

import requests

# Open WebUI API 端点
api_url = "http://localhost:3000/api/chat/completions"

# 请求配置
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer 您的老张API密钥"
}

data = {
    "model": "gpt-4-turbo",
    "messages": [
        {"role": "user", "content": "解释量子计算的基本原理"}
    ],
    "stream": False
}

# 发送请求
response = requests.post(api_url, headers=headers, json=data)
result = response.json()
print(result["choices"][0]["message"]["content"])

​
JavaScript 集成

const apiUrl = 'http://localhost:3000/api/chat/completions';

const requestData = {
  model: 'gpt-4-turbo',
  messages: [
    { role: 'user', content: '写一个简单的 Python 函数' }
  ]
};

fetch(apiUrl, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer 您的老张API密钥'
  },
  body: JSON.stringify(requestData)
})
.then(response => response.json())
.then(data => {
  console.log(data.choices[0].message.content);
});

​
故障排除

​
常见问题

连接失败
  • 检查 API Base URL 是否正确：https://api.laozhang.ai/v1
  • 验证 API Key 有效性
  • 确认防火墙设置
模型不可用
  • 检查账户余额
  • 确认模型在服务范围内
  • 查看 老张API 服务状态
上传失败
  • 检查文件格式支持
  • 确认存储空间充足
  • 验证文件大小限制

​
日志调试

启用调试模式： 
docker logs -f open-webui
查看详细日志： 
environment:
  - LOG_LEVEL=DEBUG
  - WEBUI_DEBUG=true

​
最佳实践

​
性能优化

  1. 模型选择
    • 日常对话使用 GPT-3.5 Turbo
    • 复杂任务使用 GPT-4 Turbo
    • 长文本处理使用 Claude Sonnet
  2. 缓存策略
    • 启用对话缓存
    • 设置合理的缓存过期时间
    • 定期清理无用缓存
  3. 资源管理
    • 监控内存使用
    • 设置合理的并发限制
    • 定期备份用户数据

​
安全配置

environment:
  - ENABLE_ADMIN_EXPORT=false
  - ENABLE_ADMIN_CHAT_ACCESS=false
  - JWT_EXPIRES_IN=7d

​
监控告警

集成监控系统： 
environment:
  - ENABLE_WEBHOOKS=true
  - WEBHOOK_URL=https://your-monitoring-url
需要更多帮助？请查看 Open WebUI 官方文档 或访问 老张API官网。