对国内用户更顺手的 AI WebUI？Docker一键部署HaloWebUI

CherryStudio 和 OpenWebUI，很多人应该都已经折腾过了。它们算是曾经 AI 热潮里最常被提到的两个工具：一个偏桌面客户端，打开就能聊；一个偏 Web 服务，部署起来之后多端都能用。

AI 工具越来越多，模型越来越多，配置、对话、知识库、用量统计也越来越分散。所以本次想分享一个更能整合多方优点的方案：HaloWebUI。

项目介绍

完整项目名：ztx888/HaloWebUI，可于GitHub搜索。

HaloWebUI 是一个集成了 CherryStudio 和 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，还得看实际体验，但这个方向确实很对味。

有需求的朋友可以部署使用。

感谢观看，本文完。