OneUptime macOS 安装指南三种浏览器 PWA 安装方法、系统级定制与故障排查【免费下载链接】oneuptimeComplete open-source monitoring and observability platform.项目地址: https://gitcode.com/GitHub_Trending/on/oneuptime本指南基于 OneUptime 官方文档macos-installation.md讲解如何在 macOS 上将 OneUptime 安装为类原生桌面应用通过 Safari、Chrome 或 Edge 的 PWA渐进式 Web 应用能力把监控与事件管理界面放进 Dock 和 Launchpad。读完本文你将掌握三种安装路径的完整步骤、Dock/通知等系统级定制、卸载与数据清理、自动更新机制并能对照 OneUptime 仓库中的 PWA 清单文件 与 Service Worker 注册源码理解安装背后的技术原理。为什么 OneUptime 能安装为 macOS 桌面应用OneUptime 的 Dashboard 是一个标准 PWA浏览器安装到桌面的能力正是建立在以下仓库证据之上Web 应用清单App/FeatureSet/Dashboard/public/manifest.json 声明了short_name: OneUptime、name: OneUptime - Complete Observability Platform、应用id: /dashboard/oneuptime以及 192×192 与 512×512 两档图标同时提供any与maskable两种用途。浏览器安装 PWA 时读取的正是这份清单它决定了 Dock 图标、应用名称和启动行为。Service Worker 注册Dashboard 入口模板 App/FeatureSet/Dashboard/views/index.ejs 中的脚本在页面load后调用navigator.serviceWorker.register(/dashboard/sw.js, { scope: / })并注册了updatefound、message与controllerchange三类监听器负责版本更新提示与新 Worker 接管后的自动刷新。缓存与离线策略Service Worker 由构建脚本 App/FeatureSet/Dashboard/scripts/generate-sw.js 从模板 App/FeatureSet/Dashboard/sw.js.template 生成。模板中缓存版本号为oneuptime-v{APP_VERSION}-{GIT_SHA}确保每次部署后旧缓存自动失效静态资源缓存 7 天、动态内容缓存 1 天安装事件会预缓存/dashboard/、manifest.json、offline.html 等关键资源。这正是文档中离线也能打开应用壳类能力的底层实现。适用前提安装对象是你部署的 OneUptime 实例的 Dashboard 地址默认为/dashboard路径下的界面且浏览器版本满足各平台 PWA 要求Safari 路径需要 macOS Sonoma 14.0 及以上。安装方法一SafarimacOS 推荐Safari 对 PWA 与 macOS 原生功能的集成度最高是官方文档推荐的方式。步骤 1在 Safari 中打开 OneUptime启动 Safari访问你的 OneUptime 实例地址登录 OneUptime 账号等待页面完全加载此时 Service Worker 注册流程才会执行完毕。步骤 2安装 PWA点击菜单栏的文件Ablage/Files选择**添加到 Dock**Zum Dock hinzufügenmacOS Sonoma 及以上版本支持或者在地址栏中寻找安装图标⊞直接点击旧版 macOS 的替代入口文件 → 添加到主屏幕Zum Home-Bildschirm hinzufügen。步骤 3定制安装选项应用名称默认继承清单中的short_name即 OneUptime可按需修改Dock勾选添加到 Dock图标将出现在 Dock 中Launchpad勾选添加到 Launchpad方便在应用启动器中检索。步骤 4启动应用在 Dock、Launchpad 或应用程序文件夹中找到 OneUptime点击后会在独立窗口中启动不再依赖 Safari 浏览器进程由于manifest.json中声明的是独立展示模式standalone display窗口中不会出现浏览器地址栏与标签页。安装方法二Google ChromeChrome 提供成熟的 PWA 安装与桌面集成能力。步骤 1在 Chrome 中打开 OneUptime启动 Chrome → 访问 OneUptime 实例 → 保持登录状态 → 等待页面完全加载。步骤 2通过菜单安装在地址栏右侧寻找安装图标⊞点击**安装 OneUptime**或者使用Chrome 菜单 → 更多工具Weitere Tools→ 创建快捷方式Verknüpfung erstellen。步骤 3安装选项勾选**作为窗口打开**Als Fenster öffnen获得类原生应用体验独立窗口无浏览器界面按需修改应用名称点击**安装或创建**。步骤 4调用应用在应用程序文件夹中找到 OneUptime或通过 Spotlight 搜索启动建议将其固定到 Dock 以便快速访问。安装方法三Microsoft EdgeEdge 的 PWA 支持与 Chrome 同源macOS 集成表现良好。启动 Microsoft Edge访问 OneUptime 地址完成登录点击三点菜单 → 应用Apps→ 将本网站安装为应用或寻找地址栏中的安装提示按需修改应用名称点击**安装**。macOS 系统级定制安装完成后可以利用 macOS 自身功能进一步定制监控入口。Dock 与 LaunchpadDock 位置将 OneUptime 拖拽到偏好的 Dock 位置Dock 尺寸在 Dock 设置中缩放图标大小Launchpad 组织创建监控应用文件夹归类监控相关应用角标Badge通知在 Dock 图标上显示事件数量角标。菜单栏与通知中心通知中心系统设置 → 通知 → OneUptime配置通知样式与投递方式并为不同类型的事件Incident设置优先级菜单栏集成Safari PWA 支持原生菜单栏可为常用操作配置自定义菜单项键盘快捷键为高频任务绑定快捷键加速事件响应流程。补充说明OneUptime 的推送通知依赖 Service Worker 的 PushManager 通道。从源码 App/FeatureSet/Dashboard/src/Components/NotificationMethods/Push.tsx 可见前端在注册推送前会先检查serviceWorker与PushManager是否可用再调用navigator.serviceWorker.register(/dashboard/sw.js)。因此首次使用通知时务必授予浏览器推送权限这是后面通知不工作排查清单的第 6 条。故障排查安装类问题Safari 中没有添加到 Dock选项确认 macOS 为 Sonoma14.0或更高版本将 Safari 更新到最新版本尝试替代入口文件 → 添加到主屏幕清空 Safari 缓存后重试改用 Chrome 或 Edge 安装。PWA 安装失败或安装后崩溃检查 macOS 版本兼容性确保磁盘剩余空间充足建议 100 MB 以上将浏览器更新到最新版本清除浏览器缓存与 Cookie临时禁用浏览器扩展排除干扰重启 Mac 后重试安装。应用没有出现在应用程序文件夹在 Launchpad 中查找 OneUptime 图标用 Spotlight 搜索⌘空格在浏览器的 PWA 管理页中查找见下文卸载章节的地址换用另一个浏览器重新安装确认是否以其他自定义名称安装了。通知类问题macOS 通知不工作系统设置 → 通知 → OneUptime开启允许通知设置合适的通知样式横幅/提醒检查勿扰/专注模式是否拦截了通知核对 OneUptime 实例内的通知配置在浏览器首次请求时授予通知权限对应 Push.tsx 中的权限检查流程。卸载常规移除应用程序文件夹方式打开应用程序文件夹找到 OneUptime拖入废纸篓或右键 → 移到废纸篓Dock 方式右键 Dock 中的 OneUptime → 选项 → 从 Dock 移除然后再从应用程序文件夹删除浏览器 PWA 管理页Chrome访问chrome://apps/→ 找到 OneUptime → 移除Edge访问edge://apps/→ 找到 OneUptime → 卸载Safari没有独立的管理页面通过移除主屏幕项或重新管理 Dock 图标处理。彻底清除本地数据PWA 的登录会话与缓存数据存放在浏览器目录下。如需彻底清理原文档给出的命令# 删除 Safari PWA 数据注意这会清理 Safari 的通用网站数据 rm -rf ~/Library/Safari/Databases rm -rf ~/Library/Caches/com.apple.Safari # 删除 Chrome PWA 数据 rm -rf ~/Library/Application\ Support/Google/Chrome/Default/Web\ Applications # 删除 Edge PWA 数据 rm -rf ~/Library/Application\ Support/Microsoft\ Edge/Default/Web\ Applications注意Safari 的清理命令影响范围较大会删除 Safari 全部网站数据库与缓存执行前请先确认。缓存键格式可在 sw.js.template 中确认——形如oneuptime-v{版本}-{GitSHA}-static随部署变更自动失效日常维护一般无需手动清理。更新与维护自动更新机制OneUptime PWA 的更新是自动的无需 App Store。从仓库源码看这套机制有两层保障views/index.ejs 中每 60 秒调用一次registration.update()主动检查新版本当 Service Worker 发出SW_UPDATED消息或controllerchange事件时页面自动window.location.reload()缓存版本号绑定APP_VERSION与GIT_SHA每次部署生成新缓存旧缓存在新 Worker 激活阶段被清理。因此新部署上线后桌面应用会在下次打开或分钟级检查时自动获取最新代码无需重新安装。例行维护计划每周重启一次 OneUptime 应用出现问题时清理浏览器缓存检查 macOS 系统更新。每月检查磁盘占用并按需清理若浏览器未开启自动更新则手动更新浏览器验证通知设置仍然有效。与 macOS 功能的集成快捷指令Shortcuts为 OneUptime 创建自定义快捷指令打开快捷指令应用新建快捷指令添加**打开 App**动作选择 OneUptime可为该快捷指令添加 Siri 语音触发。终端集成在 Shell 中管理 OneUptime 桌面应用原文档给出的配置追加到~/.zshrc# 创建快速启动 OneUptime 的别名 echo alias oneuptimeopen -a \OneUptime\ ~/.zshrc # 检查 OneUptime 是否正在运行的函数 oneuptime_status() { if pgrep -f OneUptime /dev/null; then echo OneUptime is running else echo OneUptime is not running fi }配置完成后执行source ~/.zshrc即可用oneuptime命令启动桌面应用、用oneuptime_status查看运行状态。注意桌面应用本身只是一个 PWA 窗口实例服务、探针等组件仍需在服务端参见 Devops/docs 中的部署文档运行。安全与隐私macOS 安全能力Gatekeeper确保 PWA 仅从可信来源你的 OneUptime 实例域名安装系统完整性保护SIP保护系统文件不被应用修改FileVault开启全盘加密保护本地缓存的会话数据钥匙串浏览器将登录凭据安全存储于钥匙串。最佳实践保持 macOS 与浏览器定期更新在可用时启用 Touch ID / Face ID 强认证远程访问监控平台时建议走 VPNTime Machine 备份可覆盖浏览器 PWA 数据目录定期检查已授予的通知、位置等权限。延伸阅读同系列文档iOS 安装、Android 安装、Windows 安装、Linux 安装、FAQ 与故障排查仓库中 PWA 相关实现Dashboard 清单、Service Worker 模板、SW 生成脚本、Accounts 端清单。【免费下载链接】oneuptimeComplete open-source monitoring and observability platform.项目地址: https://gitcode.com/GitHub_Trending/on/oneuptime创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考