對國內用戶更順手的 AI WebUI？Docker一鍵部署HaloWebUI

CherryStudio 和 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_strg

         - OPENAI_API_BASE_UR=  # 注意填寫，兼容地址也可

         # - 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，還得看實際體驗，但這個方向確實很對味。

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

感謝觀看，本文完。