
企业支持由 Kroonen AI 提供
!https://raw.githubusercontent.com/libre-webui/libre-webui/main/screenshot.png
!Version !License
!GDPR Ready !HIPAA Compatible !SOC 2 Ready
官网 • 文档 • 𝕏 • https://github.com/***/libre-webui • 快速开始
一个简单的自托管AI聊天界面。可本地搭配Ollama运行,或连接OpenAI、Anthropic等9+种AI提供商——全在一个界面中实现。
核心体验
AI提供商支持
|
高级功能
安全特性
|
前置要求:Ollama(用于本地AI)或云服务提供商API密钥
bashnpx libre-webui
完成后访问 http://localhost:8080
| 部署方式 | 命令 |
|---|---|
| 内置Ollama(CPU版) | docker-compose up -d |
| 内置Ollama(NVIDIA GPU版) | docker-compose -f docker-compose.gpu.yml up -d |
| 外部Ollama(已在主机运行) | docker-compose -f docker-compose.external-ollama.yml up -d |
访问地址:http://localhost:8080
警告:开发版构建由
dev分支自动生成,可能包含实验性功能、破坏性变更或bug。请谨慎使用,勿用于生产环境。
| 部署方式 | 命令 |
|---|---|
| 开发版+内置Ollama(CPU) | docker-compose -f docker-compose.dev.yml up -d |
| 开发版+内置Ollama(GPU) | docker-compose -f docker-compose.dev.gpu.yml up -d |
| 开发版+外部Ollama | docker-compose -f docker-compose.dev.external-ollama.yml up -d |
开发版使用独立数据卷(libre_webui_dev_data),避免与稳定版安装冲突。
手动拉取最新开发镜像:
bashdocker pull librewebui/libre-webui:dev
bashhelm install libre-webui oci://ghcr.io/libre-webui/charts/libre-webui
bash# 使用外部Ollama helm install libre-webui oci://ghcr.io/libre-webui/charts/libre-webui \ --set ollama.bundled.enabled=false \ --set ollama.external.enabled=true \ --set ollama.external.url=http://my-ollama:11434 # 启用NVIDIA GPU支持 helm install libre-webui oci://ghcr.io/libre-webui/charts/libre-webui \ --set ollama.bundled.gpu.enabled=true # 配置Ingress helm install libre-webui oci://ghcr.io/libre-webui/charts/libre-webui \ --set ingress.enabled=true \ --set ingress.hosts[0].host=chat.example.com
查看helm/libre-webui/values.yaml获取所有配置选项。
bash# 1. 克隆仓库 git clone https://github.com/libre-webui/libre-webui cd libre-webui # 2. 配置环境 cp backend/.env.example backend/.env # 3. 安装依赖并运行 npm install && npm run dev
编辑backend/.env文件添加API密钥:
env# 本地AI(Ollama) OLLAMA_BASE_URL=http://localhost:11434 # 云AI提供商(按需添加) OPENAI_API_KEY=sk-... ANTHROPIC_API_KEY=sk-ant-...
注意:桌面应用目前处于积极开发阶段。macOS版本正在等待Apple公证,可能在部分系统上出现安全警告或安装问题。我们正在解决此问题,欢迎反馈和bug报告!
从https://github.com/libre-webui/libre-webui/releases%E4%B8%8B%E8%BD%BD%E5%8E%9F%E7%94%9F%E6%A1%8C%E9%9D%A2%E5%BA%94%E7%94%A8%EF%BC%9A
| 平台 | 状态 |
|---|---|
| macOS(Apple Silicon) | Beta版(.dmg或.zip) |
| Windows | 即将推出 |
| Linux | 即将推出 |
[!NOTE]
企业服务
需要定制部署? Kroonen AI 为Libre WebUI部署提供专业服务。
服务 适用场景 本地及云部署 HIPAA、SOC 2合规环境、空气隔离环境 SSO集成 Okta、Azure AD、SAML、LDAP 定制开发 集成、白标、插件开发 SLA支持服务 优先响应、专属支持渠道 联系:*** | 了解更多 →
[!TIP]
支持开发
Libre WebUI由独立团队开发和维护。您的支持将保持其免费开源。
https://github.com/***/libre-webui — 助力持续开发
Apache 2.0 许可证 • 版权所有 © 2025–现在 Libre WebUI™
由 Kroonen AI 开发维护 • 企业支持
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
无需登录使用专属域名
Kubernetes 集群配置 Containerd
K3s 轻量级 Kubernetes 镜像加速
VS Code Dev Containers 配置
Podman 容器引擎配置
HPC 科学计算容器配置
ghcr、Quay、nvcr 等镜像仓库
Harbor Proxy Repository 对接专属域名
Portainer Registries 加速拉取
Nexus3 Docker Proxy 内网缓存
需要其他帮助?请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
docker search 限制
站内搜不到镜像
离线 save/load
插件要用 plugin install
WSL 拉取慢
安全与 digest
新手拉取配置
镜像合规机制
manifest unknown
no matching manifest(架构)
invalid tar header(解压)
TLS 证书失败
DNS 超时
域名连通性排查
410 Gone 排查
402 与流量用尽
401 认证失败
429 限流
D-Bus 凭证提示
413 与超大单层
来自真实用户的反馈,见证轩辕镜像的优质服务