不止于网页NodeWarden PWA 安装、离线使用与桌面 App 快捷方式设置【免费下载链接】nodewardenBitwarden-compatible server running on Cloudflare Workers项目地址: https://gitcode.com/gh_mirrors/no/nodewardenNodeWarden 是一个运行在 Cloudflare Workers 上的 Bitwarden 兼容密码库服务器除了网页访问外它还内置了完整的 PWA渐进式 Web 应用能力可以把密码库安装到手机主屏幕或电脑桌面像原生 App 一样独立窗口打开并且支持离线打开库、离线解锁。本文手把手带你完成 NodeWarden PWA 安装、离线使用以及桌面 App 快捷方式的设置。为什么 NodeWarden 值得安装成 App 官方特性对比中NodeWarden 的 PWA/离线能力是相对 Bitwarden 免费版服务器的独有卖点可安装、离线使用、App 快捷方式见 README_ZH.md 的特性表格。安装为 PWA 后你会立刻获得三样东西能力说明 独立窗口打开全屏、独立标签没有浏览器地址栏 离线可用App 外壳页面框架与静态资源被缓存断网也能打开⚡ 快捷入口系统菜单里内置了 Vault保险库与 TOTP动态口令两个快捷方式直达核心页面这套能力由 PWA 清单文件定义display: standalone决定独立窗口形态shortcuts数组定义了上面两个快捷入口可参考 manifest.webmanifest。手机安装Android 主屏幕快捷方式设置在 Android 上安装 NodeWarden推荐 Chrome用 Chrome 打开你的 NodeWarden 地址部署后生成的 Workers 域名或自定义域名点击地址栏右侧的安装图标或打开浏览器菜单 →安装应用 / 添加到主屏幕确认图标与名称NodeWarden无误后点安装。完成后主屏幕会出现 NodeWarden 图标点击即以全屏独立窗口启动直接进入保险库。在 iPhone 上安装 NodeWardenSafari用 Safari 打开 NodeWarden 地址iOS 只有 Safari 支持添加到主屏幕点底部分享按钮 →添加到主屏幕名称默认为 NodeWarden点添加。index.html中已配置apple-mobile-web-app-capable、主题色和 Apple 触摸图标见 index.html所以 iPhone 上的图标和状态栏效果是完整适配的。桌面安装Windows / macOS / Linux 快捷方式设置Windows一键安装应用用 Chrome 或 Edge 打开 NodeWarden点击地址栏最右侧的安装图标或菜单 → 应用 → 安装此站点为应用。系统会在开始菜单和桌面生成独立应用窗口带标题栏、可固定到任务栏完全像原生桌面软件。macOS从 Safari 添加到 Dock用 Safari 打开 NodeWarden 地址菜单文件 → 添加到程序坞Dock 中出现 NodeWarden 图标打开即独立窗口自动适配深色主题主题色#0f172a。Linux按浏览器操作Chrome/Edge 系浏览器同样支持地址栏安装图标Firefox 系可创建普通网址快捷方式。Linux 桌面端已在官方测试列表中验证可用README_ZH.md。 小提示如果网络环境无法访问默认 Workers 域名先在 Workers 设置里绑定自定义域名再用该域名安装 PWA体验更稳定。离线使用断网也能开库 NodeWarden 的离线能力不只是页面能打开而是三层设计1. App 外壳缓存断网秒开构建时会生成一个 Service Workersw.js把首页、保险库页面、样式、脚本等全部预缓存之后每次在线访问都会静默刷新缓存见 vite.config.ts 中的缓存策略与 pwa.ts 的注册逻辑。这意味着飞机上、地铁里断网PWA 依然秒开缓存带版本号升级后自动切换新版缓存无需手动清理。⚠️ 注意第一次必须先在线打开一次缓存就绪后才能离线使用Service Worker 的离线兜底页也会给出这个提示。2. 离线解锁保险库密码不用问服务器多数离线只做到打开页面登录仍要联网。NodeWarden 走得更远每次在线成功登录后会把你的账户解锁信息邮件、主密钥派生参数、库主密钥存到本机之后断网输入主密码即可在本地完成密钥派生并解锁保险库全程不请求服务器。相关实现在 offline-auth.ts退出登录时该记录会被安全清除。3. 网络状态实时感知界面里有一个在线/离线状态徽标NetworkStatusBadge.tsx它每 30 秒探测一次服务可达性见 network-status.ts连续两次探测失败或浏览器断网时立即切换为离线。你可以清楚知道当前处于离线模式——离线期间可正常查看和解锁库但新增/修改需联网后才能同步到其他设备。进阶技巧与常见问题 ️快捷方式直达 TOTP安装后的桌面/手机快捷菜单里除了Vault还有TOTP快捷项适合常看动态口令的用户配置见 manifest.webmanifest。隐藏网页版但 PWA 不受影响在 Workers 变量中设置HIDE_WEB_VAULT1后服务器托管的前端页面返回 404但已安装或已缓存的 PWA 仍可继续使用本地前端服务端接口照常工作说明见 README_ZH.md适合只允许自己人用 Web Vault 的部署。升级后离线打不开先在线打开一次让新版缓存就绪再断网即可。换设备怎么办每个设备都需要独立完成一次在线登录 离线记录离线解锁能力是按设备建立的。总结NodeWarden 的 PWA 方案让自建 Bitwarden 兼容密码库真正走出浏览器手机端Chrome / Safari 两步安装直达主屏幕桌面端Windows 一键安装、macOS 添加到程序坞、Linux 常规快捷方式离线端App 外壳缓存 本地离线解锁 网络状态徽标断网照样安全开库。配合官方的备份中心与多设备同步它已经是一套完整的个人密码库解决方案 。【免费下载链接】nodewardenBitwarden-compatible server running on Cloudflare Workers项目地址: https://gitcode.com/gh_mirrors/no/nodewarden创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考