OneUptime Windows 桌面应用安装指南通过 PWA 在 Windows 上部署监控与事件管理客户端【免费下载链接】oneuptimeComplete open-source monitoring and observability platform.项目地址: https://gitcode.com/GitHub_Trending/on/oneuptimeOneUptime 的 Web 控制台本身是一个渐进式 Web 应用Progressive Web AppPWA无需通过任何应用商店即可直接从现代浏览器以桌面应用的形式安装到 Windows 上。本篇指南以官方 Windows 安装文档为主体完整覆盖 Edge、Chrome、Firefox 三种安装路径、安装后的启动与通知配置、常见故障排查、卸载与自动更新机制并结合仓库内真实的前端路由与 Web App Manifest 源码帮助你理解 OneUptime PWA 的底层实现与安装前提最终在 Windows 上获得带独立窗口、图标与通知能力的 OneUptime 桌面客户端。安装前的准备PWA 的硬性前提OneUptime 桌面版本质上是将 Web 控制台以 PWA 形式安装到系统中因此安装成功与否取决于浏览器能否识别该站点的 PWA 特征。从仓库源码看OneUptime 前端服务在 App/FeatureSet/Frontend/Index.ts 中注册了以下根路径文件/manifest.json—— Web App Manifest声明应用名称、图标、显示模式/sw.js与/service-worker.js—— Service Worker承担离线与自动更新能力/browserconfig.xml—— 供 Windows 平台识别站点为可固定应用其中 manifest.json 声明了display: standalone、start_url: /dashboard/、scope: /dashboard/以及 192×192、512×512 的any与maskable图标这正是 Edge / Chrome 在地址栏出现安装按钮⊞的判断依据。因此安装前请确认使用受支持的浏览器Microsoft Edge 或 Google ChromeChromium 内核PWA 支持最完整Firefox 也支持基本安装但集成度较低。HTTPS 连接PWA 安装要求站点通过 HTTPS 提供如果访问的是自托管实例请先确认已正确配置 TLS 证书。网络与缓存首次访问需等待页面完全加载让浏览器完成对 manifest 与 Service Worker 的获取。安装方法一Microsoft Edge推荐Edge 与 Windows 原生功能Start Menu、任务栏、通知中心集成最佳是官方文档推荐的方式。在 Edge 中打开 OneUptime启动 Edge访问你的 OneUptime 实例 URL登录账户等待页面完全加载。触发安装观察地址栏右侧的安装图标⊞点击安装 OneUptime或通过三点菜单 → 应用 → 将此站点安装为应用进入安装流程。自定义安装选项应用名称默认 OneUptime可按需修改开始菜单选择是否添加到 Windows 开始菜单任务栏可选固定到任务栏桌面可创建桌面快捷方式。完成安装点击安装OneUptime 将在独立窗口中打开并出现在开始菜单的已安装应用列表中。安装方法二Google ChromeChrome 对 PWA 的桌面集成同样出色步骤与 Edge 高度一致。在 Chrome 中打开 OneUptime访问实例地址确保已登录并允许页面完整加载。通过地址栏安装点击地址栏右侧的**安装图标⊞**并选择安装 OneUptime或通过三点菜单 → 更多工具 → 创建快捷方式。安装选项勾选以窗口方式打开以获得类似原生应用的体验可按需修改应用名称点击安装或创建。启动应用从 Windows 开始菜单或桌面快捷方式启动应用会在专属窗口中打开。安装方法三FirefoxFirefox 对 PWA 的安装支持属于基础级别适合作为补充方案。在 Firefox 中打开 OneUptime访问实例 URL 并完成登录。安装 PWA留意浏览器中的安装提示或横幅或通过菜单 → 安装触发若提供添加到主屏幕类选项也可使用。安装后的启动与通知配置启动配置随 Windows 启动Autostart右键任务栏 →任务管理器 → 启动找到 OneUptime 并启用即可开机自动运行。默认窗口大小与位置可在应用的独立窗口中设置偏好的窗口尺寸与位置Windows 会记住相关设置。Windows 通知设置OneUptime 桌面版的事件告警依赖 Windows 通知中心请按以下路径配置系统通知进入设置 → 系统 → 通知和操作找到 OneUptime配置告警偏好并启用横幅通知以便实时接收 incident事件告警。专注助手Focus Assist配置免打扰Do Not Disturb规则允许 OneUptime 的关键通知穿透针对不同告警类型设置优先级级别确保重要事件不被系统静默。高级安装选项说明源文档中该小节为预留占位未展开具体内容。结合仓库中 manifest.json 的实现可以推断 OneUptime PWA 在安装后还具备以下可用的高级能力协议处理protocol_handlers声明了weboneuptime协议安装后可通过weboneuptime?url...这类自定义协议链接直接唤起应用打开对应仪表盘启动模式launch_handlerclient_mode: [focus-existing]已打开应用时再次唤起会聚焦已有窗口应用快捷方式shortcuts在系统应用菜单中提供直达 OneUptime Dashboard 的快捷入口侧边栏与窗口控制edge_side_panel定义了 Edge 侧边栏优先宽度display_override支持window-controls-overlay等现代窗口控制模式。这些配置在支持的浏览器与 Windows 版本上会被自动识别无需额外手动设置。故障排查安装问题安装按钮不出现解决方案 1. 确保使用 Edge 或 Chrome推荐浏览器 2. 确认到 OneUptime 实例的 HTTPS 连接正常 3. 清除浏览器缓存和 Cookie 4. 将浏览器更新到最新版本 5. 检查服务器端 PWA 要求是否满足 6. 暂时禁用浏览器扩展安装失败或崩溃解决方案 1. 以管理员身份运行浏览器 2. 检查 Windows 用户账户控制UAC设置 3. 确保有足够磁盘空间至少 100 MB 4. 暂时禁用杀毒软件 5. 完全清除浏览器数据 6. 重启 Windows 后重试应用未出现在开始菜单解决方案 1. 在 Windows 搜索中搜索 OneUptime 2. 检查是否以其他名称安装 3. 在 最近添加 应用区域查找 4. 重新安装并确保勾选 添加到开始菜单 5. 必要时手动创建快捷方式通知问题Windows 通知不工作解决方案 1. Windows 设置 → 系统 → 通知和操作 2. 为 OneUptime 启用通知 3. 检查专注助手Focus Assist设置 4. 确保在 OneUptime 中授予了通知权限 5. 先用一条简单通知测试卸载 OneUptime 桌面应用完全移除Windows 设置方式设置 → 应用 → 已安装的应用搜索 OneUptime点击并选择卸载。浏览器方式打开 Edge 或 Chrome访问edge://apps/或chrome://apps/找到 OneUptime点击设置 →卸载。开始菜单方式右键开始菜单中的 OneUptime选择卸载并确认移除。更新与维护OneUptime 桌面版作为 PWA更新机制完全自动化联网时 OneUptime PWA 自动更新无需任何手动干预重启后更新立即生效关键修复即时部署。这一机制依赖仓库中注册的 Service Worker 路由App/FeatureSet/Frontend/Index.ts 中的/sw.js与/service-worker.js每次启动应用都会检查最新版本并完成静默更新。延伸阅读桌面端整体入门与多平台安装总览移动端与桌面端应用索引其中包含 macOS、Linux 安装指南的入口PWA 安装的站点元数据Web App Manifest 与 站点图标清单前端路由与 PWA 文件托管实现App/FeatureSet/Frontend/Index.ts多语言版本本文对应的官方丹麦语原文位于 da/mobile-desktop-apps/windows-installation.md英文版位于 en/mobile-desktop-apps/windows-installation.md。【免费下载链接】oneuptimeComplete open-source monitoring and observability platform.项目地址: https://gitcode.com/GitHub_Trending/on/oneuptime创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考