侧边栏壁纸
博主头像
羊刀仙的部落格 博主等级

很有力量。

  • 累计撰写 283 篇文章
  • 累计创建 60 个标签
  • 累计收到 13 条评论

目 录CONTENT

文章目录

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

羊刀仙
2026-06-22 / 0 评论 / 0 点赞 / 0 阅读 / 0 字 / 正在检测是否收录...
温馨提示:
部分素材来自网络,若不小心影响到您的利益,请联系我们删除。
GW树洞

高速稳定 · 海外专线

  • 自用推荐
  • 90天使用时长
  • 70+ 节点分布
  • IEPL专线 油管4K无压力
  • 全平台客户端
  • 不限制在线设备
立即注册

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

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

截屏2026-06-22 15.57.31.png

项目介绍

完整项目名: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创建新的应用程序。

截屏2026-06-22 14.22.45.png

使用一览

部署完毕后,浏览器输入NAS_IP:3911即可访问项目界面。点击底部的「开始使用」。

截屏2026-06-22 14.39.57.png

注册的第一个账户,默认为管理员账户。如果你只打算自用,邮箱随便填写一个符合格式的即可。

截屏2026-06-22 14.41.05 拷贝.png

弹出功能更新日志。关于一些功能需求、Bug反馈和优化建议,大家可以提Issues。

截屏2026-06-22 14.42.03.png

初始界面如下,是不是感觉很熟悉?

截屏2026-06-22 14.44.30.png

右上角点击头像,进入设置。

截屏2026-06-22 14.55.22.png

来到「接口配置」,在部署时如果没有添加,那么手动添加即可。

截屏2026-06-22 15.11.46 拷贝.png

输入API地址和密钥并进行测试。

截屏2026-06-22 15.14.19 拷贝.png

你所用供应商的所有可用模型都会自动刷新,选择要使用的即可。

截屏2026-06-22 15.36.48.png

测试了多个,国产、非国产,官方、三方供应商,都没问题。

截屏2026-06-22 15.37.35 拷贝.png

其他的一些内容就不去细调了,毕竟本项目是个深度优化集成类型,大家过去如果用过CherryStudio 和 OpenWebUI,HaloWebUI 这边也是信手拈来。

截屏2026-06-22 15.41.08.png

回到对话界面,左上角选择已经导入的模型,助手可以自定义也可不选,对话使用即可。

截屏2026-06-22 15.44.36.png

对话后,后台也可以很清晰的看到数据统计。

截屏2026-06-22 16.29.23.png

最后

HaloWebUI 不是简单再做一个 AI 客户端,而是试图把 CherryStudio 的轻便顺手和 OpenWebUI 的 Web 化部署能力结合起来,再针对中文用户常见的多模型接入、计费统计和统一管理做深度优化。能不能真正成为更适合国内用户的 AI WebUI,还得看实际体验,但这个方向确实很对味。

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

感谢观看,本文完。

0

评论区