Open WebUI

支持 Ollama 和任意 OpenAI 兼容接口的自部署 AI Web 平台

简介

Open WebUI 是一款强大的自部署 AI Web 平台，运行于 Docker。开箱即支持本地 Ollama 模型，同时可接入任意 OpenAI 兼容接口（包括 TokenMix），从而在私有部署中使用 Claude、GPT-5、Qwen 等云端模型。

前提条件

• 在本机安装 Docker，然后运行：

  docker run -d -p 3000:8080 --name open-webui ghcr.io/open-webui/open-webui:main
  

  访问 http://localhost:3000，首次启动时创建管理员账号。
• 在 tokenmix.ai 注册，进入控制台 → API Keys 获取以 sk-tm- 开头的 API 密钥。

配置步骤

1. 使用管理员账号登录 Open WebUI。
2. 点击右上角头像 → 管理员设置。
3. 切换到 Connections（连接） 标签页。
4. 在 OpenAI 区域点击 ➕ 添加连接 按钮。
5. 填写以下信息：
   • URL：https://api.tokenmix.ai/v1
   • Key：粘贴你的 sk-tm-xxx 密钥
6. 点击保存。

注意： Open WebUI 会尝试通过 /models 接口自动发现模型。TokenMix 会返回所有可用模型，列表应自动填充。若部分模型未出现，执行第 7 步。

7. （可选）在连接设置中，滚动到 Model IDs (Filter) 字段，手动输入需要的模型 ID，如 claude-sonnet-4.6、gpt-5.4、qwen3.6-max-preview，然后再次保存。

验证

回到主聊天界面，点击聊天窗口顶部的模型选择下拉菜单，应可看到 TokenMix 的模型列表。发起一次对话即可确认配置成功。

常见问题

Q：保存连接后没有模型显示？ A：Open WebUI 依赖 /v1/models 接口枚举模型。若列表为空，在 Model IDs (Filter) 中手动指定模型 short_id，如 claude-sonnet-4.6、gpt-5.4、qwen3.6-max-preview。

Q：提示 401 Unauthorized 怎么办？ A：确认 URL 精确为 https://api.tokenmix.ai/v1（含 /v1，末尾无斜杠），并从 TokenMix 控制台重新粘贴密钥。

Q：如何为团队多人使用 Open WebUI？ A：Open WebUI 内置完整的用户管理系统。在管理员设置 → 用户中邀请团队成员并分配角色，TokenMix 连接由管理员统一配置，所有用户共享。