Open WebUI Desktop 从零安装完整指南macOS、Windows、Linux 三端一步到位【免费下载链接】desktopOpen WebUI Desktop 项目地址: https://gitcode.com/gh_mirrors/desktop25/desktop装了半天、卡在权限弹窗、打开就闪退、日志看不懂——这大概是很多人第一次尝试桌面端 AI 工具的真实体验。Open WebUI Desktop 安装教程的核心价值就是帮你把这段弯路彻底省掉它把 Web 版 Open WebUI 打包成了原生桌面应用无需 Docker、无需敲终端命令下载、启动、开聊三步走。照着本文操作最快 5 分钟就能跑通你的第一次 AI 对话。 先给结论Open WebUI Desktop 是跨平台桌面应用既能连远程 Open WebUI 服务器零配置、轻量也能在本地跑 AI 模型完全离线、数据不出设备。两种模式可以同时存在侧边栏一键切换。 准备工作先弄清三个问题动手下载之前花 30 秒做一次自我诊断能帮你少走一大半弯路。问题一你属于哪类用户你的情况推荐路径理由已经有一个 Open WebUI 服务器公司、团队、云上部署远程连接零安装成本打开即用本机内存大、想要完全离线的私有 AI本地安装 llama.cpp数据完全不出设备电脑配置一般只想快速体验先远程连接以后再加本地4GB 内存就够起步问题二你需要多少内存与磁盘一句话版想本地跑模型看内存只想连远程看心情。资源本地运行模型仅远程连接磁盘空间5 GB 以上约 500 MB内存16 GB 以上4 GB操作系统macOS 12、Windows 10、Linuxglibc 2.28同上⚠️ 本地跑模型对内存是硬指标7B 参数模型大约需要 8 GB 可用内存13B 模型需要约 16 GB。内存不够别硬上——先连远程服务器体验一样完整。问题三你该优先选哪种安装方式不需要纠结看表选包即可平台安装包架构选择macOS.dmgApple 芯片选 arm64Intel 选 x64Windows.exe常规选 x64ARM 设备选 arm64Linux.AppImage/.deb/.snap/.flatpak绝大多数选 x64 Linux 新手优先选AppImage不用安装、不用 sudo下载后给个执行权限就能跑。Debian/Ubuntu 用户也可以直接装.deb体验更接近原生。️ 三平台安装方式速查表平台格式安装方式难度适合人群macOSApple 芯片.dmg拖入 Applications⭐ 极简所有 Mac 用户macOSIntel.dmg拖入 Applications⭐ 极简Intel Mac 用户Windows x64/ARM64.exe双击向导⭐ 极简所有 Windows 用户Linux x64.AppImage授权后直接运行⭐⭐ 简单追求免安装Linux Debian/Ubuntu.debdpkg -i⭐⭐ 简单系统集成爱好者Linux.snap/.flatpak一条命令⭐⭐ 简单沙箱偏好者 路径一最省事的一条路——连接远程服务器约 5 分钟这条路径适合已有服务器的用户全程不下载任何模型连 Docker 和终端都碰不到。1. 下载并打开安装包按平台执行对应动作macOS双击.dmg把 Open WebUI 图标拖进 Applications 文件夹。Windows双击.exe按向导一路下一步安装时可勾选创建桌面快捷方式。Linux AppImage下载后在终端执行两步授权chmod x open-webui_x64.AppImage ./open-webui_x64.AppImage 如果 macOS 提示无法打开因为来自身份不明的开发者去系统设置 → 隐私与安全性点仍要打开即可。2. 首次启动选择连接到现有服务器启动后你会看到主界面两个入口「开始使用」本地安装和「连接到现有服务器」。走远程路径点后者。3. 填入服务器地址并添加连接在输入框里粘贴你的服务器地址例如https://your-server.com不填http前缀也会自动补全。应用会自动校验地址是否可达填一个名称可选不填则默认用服务器域名。点击添加连接会出现在侧边栏连接列表里并标记为默认。⚠️ 地址必须能被公网或局域网访问到。如果提示无法访问先确认服务器本身在线再看下面的避坑清单。4. 开始你的第一次对话点击侧边栏里的连接Open WebUI 界面加载完成后直接在输入框里提问即可。到此你的第一个使用场景已经跑通了。⚙️ 路径二进阶自定义——在本地跑模型约 10~20 分钟这条路径适合追求离线与隐私的用户。所有组件都在本机运行断网也能聊天。1. 首次启动选择「开始使用」2. 确认安装位置界面会显示默认的安装目录存放 Python 运行时与数据。想换位置就点更改位置否则保持默认直接点继续。3. 等待环境初始化划重点第一次会比较慢应用会自动完成三件事全程可视化进度下载并安装内置 Python 3.12应用自带不污染你的系统 Python通过uv包管理器安装open-webui服务包在本地127.0.0.1:8080启动服务器。 通俗解释Open WebUI 本身是一个 Web 服务桌面版把装 Python → 装服务 → 启动服务这三步自动化了。你看到的进度提示就是它在替你跑这些原本要敲一堆命令的活。完成后会自动进入 Open WebUI 界面——此时本地模式已经可用直接聊天即可。4. 可选开启 llama.cpp 推理引擎想完全离线跑模型进入设置 → 推理运行时开启 llama.cpp。推理引擎就是负责在本地跑模型的组件llama.cpp 以高性能著称甚至能在纯 CPU 机器上工作。按硬件选择变体后端平台可选变体macOS自动 / Metal默认Windows自动 / CPU / CUDA 12.4 / CUDA 13.1 / VulkanLinux自动 / CPU / Vulkan / ROCm5. 下载一个 GGUF 模型进入设置 → 模型从 Hugging Face 搜索并下载 GGUF 格式的模型文件。也可以直接把.gguf文件丢进模型目录llama-server 会自动识别。 首次建议选 3B~7B 的小模型如 Qwen 系列小尺寸版下载快、内存占用低跑通后再换更大的。6. 连接多台服务器随时切换在侧边栏点 添加连接可以把远程服务器、本地实例全部收进来。点哪个用哪个还能给每个连接设置默认项——本机跑私有数据远程跑重型任务互不干扰。✅ 安装后的第一件事5 分钟跑通验证别急着关窗口用下面三个动作确认安装真的成功看状态本地模式下底部状态栏应显示Open WebUI 正在运行侧边栏的服务区出现绿色运行指示。远程模式下连接列表里目标服务器应显示已连接。验版本进入设置 → 关于能看到桌面版版本号、Open WebUI 版本号、llama.cpp 版本号。能显示出来就说明环境完好。发消息向 AI 发送一句你好请自我介绍一下。拿到正常回复即宣告安装成功。再顺手试两个杀手级功能Spotlight 浮动聊天栏按下Shift Cmd ImacOS或Shift Ctrl IWindows/Linux任何应用中都能呼出悬浮聊天栏还能拖动框选截图提问。语音输入按下默认的Shift Cmd/Ctrl Space说一句话自动转文字发到聊天窗口。 常见问题速查症状 → 原因 → 解法遇到问题先别卸载按图索骥症状原因解法macOS 提示无法打开未受信任的开发者系统设置 → 隐私与安全性 → 仍要打开应用启动即闪退系统权限 / 图形驱动异常关闭重开一次Windows 下若 GPU 崩溃应用会自动用软件渲染恢复耐心等待重启首次启动卡在准备环境需要联网下载 Python 等组件检查网络与代理首次初始化必须联网之后才支持离线本地安装提示磁盘空间不足剩余空间低于 5 GB清理磁盘或更改安装目录到空间充足的盘远程连接提示无法访问地址错误 / 防火墙拦截 / 代理确认地址以http(s)://开头且可公网访问放行防火墙检查代理设置语音输入无声音 / 不识别麦克风权限未授予macOS系统设置 → 隐私与安全性 → 麦克风开启后重启应用全局快捷键没反应快捷键被其他应用占用在设置 → 通用中重新录制快捷键组合本地端口冲突8080 被占用应用会自动顺延端口也可在 Open WebUI 设置中手动指定端口Linux 下 AppImage 无法运行缺少执行权限或 glibc 过旧执行chmod x后重试系统需 glibc 2.28Ubuntu 20.04 / Debian 11 均可模型下载很慢网络到 Hugging Face 链路不佳换个时段重试模型支持断点续传直接重启下载即可 需要深挖原因时可以看日志macOS 在~/Library/Logs/open-webui/Windows 在%APPDATA%/open-webui/logs/Linux 在~/.config/open-webui/logs/。把最新的错误行复制出来提问或排查会高效很多。 下一步立刻动手Open WebUI Desktop 的核心价值就两点离线隐私对话数据永远留在本机无遥测、无跟踪和跨端便利macOS、Windows、Linux 一套体验。更新也在后台静默完成你几乎感觉不到它的存在。接下来的探索方向查看项目说明与使用文档README.md了解版本演进与新功能CHANGELOG.md阅读核心功能源码服务管理、llama.cpp、Spotlight 等src/main 与 src/renderer现在就去下载适合你系统的安装包把第一步迈出去——5 分钟后你的桌面 AI 助手就上线了。开聊吧【免费下载链接】desktopOpen WebUI Desktop 项目地址: https://gitcode.com/gh_mirrors/desktop25/desktop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Open WebUI Desktop 从零安装完整指南：macOS、Windows、Linux 三端一步到位
Open WebUI Desktop 从零安装完整指南macOS、Windows、Linux 三端一步到位【免费下载链接】desktopOpen WebUI Desktop 项目地址: https://gitcode.com/gh_mirrors/desktop25/desktop装了半天、卡在权限弹窗、打开就闪退、日志看不懂——这大概是很多人第一次尝试桌面端 AI 工具的真实体验。Open WebUI Desktop 安装教程的核心价值就是帮你把这段弯路彻底省掉它把 Web 版 Open WebUI 打包成了原生桌面应用无需 Docker、无需敲终端命令下载、启动、开聊三步走。照着本文操作最快 5 分钟就能跑通你的第一次 AI 对话。 先给结论Open WebUI Desktop 是跨平台桌面应用既能连远程 Open WebUI 服务器零配置、轻量也能在本地跑 AI 模型完全离线、数据不出设备。两种模式可以同时存在侧边栏一键切换。 准备工作先弄清三个问题动手下载之前花 30 秒做一次自我诊断能帮你少走一大半弯路。问题一你属于哪类用户你的情况推荐路径理由已经有一个 Open WebUI 服务器公司、团队、云上部署远程连接零安装成本打开即用本机内存大、想要完全离线的私有 AI本地安装 llama.cpp数据完全不出设备电脑配置一般只想快速体验先远程连接以后再加本地4GB 内存就够起步问题二你需要多少内存与磁盘一句话版想本地跑模型看内存只想连远程看心情。资源本地运行模型仅远程连接磁盘空间5 GB 以上约 500 MB内存16 GB 以上4 GB操作系统macOS 12、Windows 10、Linuxglibc 2.28同上⚠️ 本地跑模型对内存是硬指标7B 参数模型大约需要 8 GB 可用内存13B 模型需要约 16 GB。内存不够别硬上——先连远程服务器体验一样完整。问题三你该优先选哪种安装方式不需要纠结看表选包即可平台安装包架构选择macOS.dmgApple 芯片选 arm64Intel 选 x64Windows.exe常规选 x64ARM 设备选 arm64Linux.AppImage/.deb/.snap/.flatpak绝大多数选 x64 Linux 新手优先选AppImage不用安装、不用 sudo下载后给个执行权限就能跑。Debian/Ubuntu 用户也可以直接装.deb体验更接近原生。️ 三平台安装方式速查表平台格式安装方式难度适合人群macOSApple 芯片.dmg拖入 Applications⭐ 极简所有 Mac 用户macOSIntel.dmg拖入 Applications⭐ 极简Intel Mac 用户Windows x64/ARM64.exe双击向导⭐ 极简所有 Windows 用户Linux x64.AppImage授权后直接运行⭐⭐ 简单追求免安装Linux Debian/Ubuntu.debdpkg -i⭐⭐ 简单系统集成爱好者Linux.snap/.flatpak一条命令⭐⭐ 简单沙箱偏好者 路径一最省事的一条路——连接远程服务器约 5 分钟这条路径适合已有服务器的用户全程不下载任何模型连 Docker 和终端都碰不到。1. 下载并打开安装包按平台执行对应动作macOS双击.dmg把 Open WebUI 图标拖进 Applications 文件夹。Windows双击.exe按向导一路下一步安装时可勾选创建桌面快捷方式。Linux AppImage下载后在终端执行两步授权chmod x open-webui_x64.AppImage ./open-webui_x64.AppImage 如果 macOS 提示无法打开因为来自身份不明的开发者去系统设置 → 隐私与安全性点仍要打开即可。2. 首次启动选择连接到现有服务器启动后你会看到主界面两个入口「开始使用」本地安装和「连接到现有服务器」。走远程路径点后者。3. 填入服务器地址并添加连接在输入框里粘贴你的服务器地址例如https://your-server.com不填http前缀也会自动补全。应用会自动校验地址是否可达填一个名称可选不填则默认用服务器域名。点击添加连接会出现在侧边栏连接列表里并标记为默认。⚠️ 地址必须能被公网或局域网访问到。如果提示无法访问先确认服务器本身在线再看下面的避坑清单。4. 开始你的第一次对话点击侧边栏里的连接Open WebUI 界面加载完成后直接在输入框里提问即可。到此你的第一个使用场景已经跑通了。⚙️ 路径二进阶自定义——在本地跑模型约 10~20 分钟这条路径适合追求离线与隐私的用户。所有组件都在本机运行断网也能聊天。1. 首次启动选择「开始使用」2. 确认安装位置界面会显示默认的安装目录存放 Python 运行时与数据。想换位置就点更改位置否则保持默认直接点继续。3. 等待环境初始化划重点第一次会比较慢应用会自动完成三件事全程可视化进度下载并安装内置 Python 3.12应用自带不污染你的系统 Python通过uv包管理器安装open-webui服务包在本地127.0.0.1:8080启动服务器。 通俗解释Open WebUI 本身是一个 Web 服务桌面版把装 Python → 装服务 → 启动服务这三步自动化了。你看到的进度提示就是它在替你跑这些原本要敲一堆命令的活。完成后会自动进入 Open WebUI 界面——此时本地模式已经可用直接聊天即可。4. 可选开启 llama.cpp 推理引擎想完全离线跑模型进入设置 → 推理运行时开启 llama.cpp。推理引擎就是负责在本地跑模型的组件llama.cpp 以高性能著称甚至能在纯 CPU 机器上工作。按硬件选择变体后端平台可选变体macOS自动 / Metal默认Windows自动 / CPU / CUDA 12.4 / CUDA 13.1 / VulkanLinux自动 / CPU / Vulkan / ROCm5. 下载一个 GGUF 模型进入设置 → 模型从 Hugging Face 搜索并下载 GGUF 格式的模型文件。也可以直接把.gguf文件丢进模型目录llama-server 会自动识别。 首次建议选 3B~7B 的小模型如 Qwen 系列小尺寸版下载快、内存占用低跑通后再换更大的。6. 连接多台服务器随时切换在侧边栏点 添加连接可以把远程服务器、本地实例全部收进来。点哪个用哪个还能给每个连接设置默认项——本机跑私有数据远程跑重型任务互不干扰。✅ 安装后的第一件事5 分钟跑通验证别急着关窗口用下面三个动作确认安装真的成功看状态本地模式下底部状态栏应显示Open WebUI 正在运行侧边栏的服务区出现绿色运行指示。远程模式下连接列表里目标服务器应显示已连接。验版本进入设置 → 关于能看到桌面版版本号、Open WebUI 版本号、llama.cpp 版本号。能显示出来就说明环境完好。发消息向 AI 发送一句你好请自我介绍一下。拿到正常回复即宣告安装成功。再顺手试两个杀手级功能Spotlight 浮动聊天栏按下Shift Cmd ImacOS或Shift Ctrl IWindows/Linux任何应用中都能呼出悬浮聊天栏还能拖动框选截图提问。语音输入按下默认的Shift Cmd/Ctrl Space说一句话自动转文字发到聊天窗口。 常见问题速查症状 → 原因 → 解法遇到问题先别卸载按图索骥症状原因解法macOS 提示无法打开未受信任的开发者系统设置 → 隐私与安全性 → 仍要打开应用启动即闪退系统权限 / 图形驱动异常关闭重开一次Windows 下若 GPU 崩溃应用会自动用软件渲染恢复耐心等待重启首次启动卡在准备环境需要联网下载 Python 等组件检查网络与代理首次初始化必须联网之后才支持离线本地安装提示磁盘空间不足剩余空间低于 5 GB清理磁盘或更改安装目录到空间充足的盘远程连接提示无法访问地址错误 / 防火墙拦截 / 代理确认地址以http(s)://开头且可公网访问放行防火墙检查代理设置语音输入无声音 / 不识别麦克风权限未授予macOS系统设置 → 隐私与安全性 → 麦克风开启后重启应用全局快捷键没反应快捷键被其他应用占用在设置 → 通用中重新录制快捷键组合本地端口冲突8080 被占用应用会自动顺延端口也可在 Open WebUI 设置中手动指定端口Linux 下 AppImage 无法运行缺少执行权限或 glibc 过旧执行chmod x后重试系统需 glibc 2.28Ubuntu 20.04 / Debian 11 均可模型下载很慢网络到 Hugging Face 链路不佳换个时段重试模型支持断点续传直接重启下载即可 需要深挖原因时可以看日志macOS 在~/Library/Logs/open-webui/Windows 在%APPDATA%/open-webui/logs/Linux 在~/.config/open-webui/logs/。把最新的错误行复制出来提问或排查会高效很多。 下一步立刻动手Open WebUI Desktop 的核心价值就两点离线隐私对话数据永远留在本机无遥测、无跟踪和跨端便利macOS、Windows、Linux 一套体验。更新也在后台静默完成你几乎感觉不到它的存在。接下来的探索方向查看项目说明与使用文档README.md了解版本演进与新功能CHANGELOG.md阅读核心功能源码服务管理、llama.cpp、Spotlight 等src/main 与 src/renderer现在就去下载适合你系统的安装包把第一步迈出去——5 分钟后你的桌面 AI 助手就上线了。开聊吧【免费下载链接】desktopOpen WebUI Desktop 项目地址: https://gitcode.com/gh_mirrors/desktop25/desktop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考