
librewebui/libre-webui企业支持由 Kroonen AI 提供
!Dark Theme
!Version !License 或云服务提供商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=[***] # 启用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 [***] 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:*** # 云AI提供商(按需添加) OPENAI_API_KEY=sk-... ANTHROPIC_API_KEY=sk-ant-...
注意:桌面应用目前处于积极开发阶段。macOS版本正在等待Apple公证,可能在部分系统上出现安全警告或安装问题。我们正在解决此问题,欢迎反馈和bug报告!
从GitHub Releases下载原生桌面应用:
| 平台 | 状态 |
|---|---|
| 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由独立团队开发和维护。您的支持将保持其免费开源。

manifest unknown 错误
TLS 证书验证失败
DNS 解析超时
410 错误:版本过低
402 错误:流量耗尽
身份认证失败错误
429 限流错误
凭证保存错误
来自真实用户的反馈,见证轩辕镜像的优质服务