对国内用户更顺手的 AI WebUI？Docker一键部署HaloWebUI
Cherry Studio 和 OpenWebUI，很多人应该都已经折腾过了。它们算是曾经 AI 热潮里最常被提到的两个工具：一个偏桌面客户端，打开就能聊；一个偏 Web 服务，部署起来之后多端都能用。
AI 工具越来越多，模型越来越多，配置、对话、知识库、用量统计也越来越分散。所以本次想分享一个更能整合多方优点的方案：HaloWebUI。
项目介绍
完整项目名：ztx888/HaloWebUI，可于GitHub搜索。
HaloWebUI 是一个集成了 Cherry Studio 和 OpenWebUI 两者优势的项目。它基于官方 Open WebUI 深度定制，化界面提高中文使用体验，增加了模型计费和用量统计，原生集成Claude/Gemini/Grok，内置 HaloClaw 消息网关，一站式管理你的所有大模型。
部署流程
以威联通NAS为例，通过Docker Compose的方式进行部署。
部署代码如下：
services:
halowebui:
image: ghcr.io/ztx888/halowebui:main
container_name: halowebui
restart: unless-stopped
ports:
- "3911:8080"
extra_hosts:
- "host.docker.internal:host-gateway"
environment:
- WEBUI_SECRET_KEY=please_change_this_to_a_long_random_string
- OPENAI_API_BASE_URL=https://api.openai.com/v1 # 兼容地址也可
# - OPENAI_API_KEY=sk-xxxxxxxx
# - ANTHROPIC_API_KEY=xxxxxxxx
# - GEMINI_API_KEY=xxxxxxxx
# - OLLAMA_BASE_URL=http://host.docker.internal:11434
volumes:
- /share/Container/halowebui/data:/app/backend/data # 必须挂载打开威联通的Container Station创建新的应用程序。
使用一览
部署完毕后，浏览器输入NAS_IP:3911即可访问项目界面。点击底部的「开始使用」。
注册的第一个账户，默认为管理员账户。如果你只打算自用，邮箱随便填写一个符合格式的即可。
弹出功能更新日志。关于一些功能需求、Bug反馈和优化建议，大家可以提Issues。
初始界面如下，是不是感觉很熟悉？
右上角点击头像，进入设置。
来到「接口配置」，在部署时如果没有添加，那么手动添加即可。
输入API地址和密钥并进行测试。
你所用供应商的所有可用模型都会自动刷新，选择要使用的即可。
测试了多个，国产、非国产，官方、三方供应商，都没问题。
其他的一些内容就不去细调了，毕竟本项目是个深度优化集成类型，大家过去如果用过CherryStudio 和 OpenWebUI，HaloWebUI 这边也是信手拈来。
回到对话界面，左上角选择已经导入的模型，助手可以自定义也可不选，对话使用即可。
对话后，后台也可以很清晰的看到数据统计。
最后
HaloWebUI 不是简单再做一个 AI 客户端，而是试图把 CherryStudio 的轻便顺手和 OpenWebUI 的 Web 化部署能力结合起来，再针对中文用户常见的多模型接入、计费统计和统一管理做深度优化。能不能真正成为更适合国内用户的 AI WebUI，还得看实际体验，但这个方向确实很对味。
有需求的朋友可以部署使用。
感谢观看，本文完。