# NodeWarden

## Aliases
- NodeWarden

## Type
Project / Product

## Description
NodeWarden 是将 Bitwarden 服务器端部署到 Cloudflare Workers 的开源实现，通过边缘计算实现真正的无服务器（Serverless）密码管理。

## Key Facts

| 属性 | 值 |
|------|-----|
| GitHub | https://github.com/shuaiplus/NodeWarden |
| 运行时 | Cloudflare Workers（边缘计算平台） |
| 数据存储 | Cloudflare D1（SQLite）+ R2（对象存储） |
| 部署方式 | GitHub Actions + Cloudflare Pages |
| 定位 | 单用户密码管理器 |
| 许可证 | 开源 |

## Architecture

```
[Bitwarden 官方客户端]
       ↓ (自托管模式，API 调用)
[Cloudflare Workers]
       ↓
[Cloudflare D1] ← 保管库数据、登录、笔记、卡片、身份
[Cloudflare R2] ← 附件文件存储
```

## Features

### 支持的功能
- ✅ 单用户保管库（登录/笔记/卡片/身份）
- ✅ 文件夹/收藏管理
- ✅ 全量同步 `/api/sync`
- ✅ 附件上传/下载（基于 R2）
- ✅ 导入功能（覆盖常见导入路径）
- ✅ 网站图标代理
- ✅ **Passkey** 原生支持（免费，无需会员）
- ✅ **TOTP** 通过 `TOTP_SECRET` 环境变量支持（免费，无需会员）

### 不支持的功能
- ❌ 多用户/组织/集合/成员权限
- ❌ SSO / SCIM / 企业目录
- ❌ Send（密码分享）
- ❌ 紧急访问
- ❌ 管理后台/计费订阅
- ❌ 推送通知

## Deployment Requirements

1. Cloudflare 账号（必须有一个域名和信用卡）
2. GitHub 账号

## Deployment Steps

1. Fork [NodeWarden GitHub 仓库](https://github.com/shuaiplus/NodeWarden)
2. 在 Cloudflare 页面点击 "Deploy to Cloudflare" 一键部署
3. 访问临时地址（如 `1nodewarden.apipnn.workers.dev`）或绑定自定义域名
4. 通过设置页面配置：
   - JWT_SECRET
   - 自动更新 GitHub
   - 主账号与密码
   - TOTP 二次验证
5. 在 Bitwarden 官方客户端选择"自托管"，输入服务器 URL 即可登录

## Advantages over Traditional Bitwarden Self-Hosting

| 优势 | 说明 |
|------|------|
| 零服务器 | 不需要维护 VPS 或任何服务器 |
| 零成本 | Cloudflare D1 + R2 免费额度足够个人使用 |
| 全球低延迟 | 边缘计算架构，用户就近访问 |
| 自动化部署 | GitHub Actions 自动更新，无需手动维护 |
| 免费 TOTP | 通过环境变量配置，无需付费会员 |
| 免费 Passkey | 原生支持 WebAuthn 无密码认证 |

## Relations

- [[NodeWarden]] ← implements ← [[Bitwarden]]
- [[NodeWarden]] ← runs_on ← [[Cloudflare Workers]]
- [[NodeWarden]] ← uses ← [[Cloudflare D1]]
- [[NodeWarden]] ← uses ← [[Cloudflare R2]]
- [[Bitwarden]] ← alternative_to ← [[1Password]]
- [[Bitwarden]] ← alternative_to ← [[LastPass]]

## Source
- [[nodewarden-把-bitwarden-搬上-cloudflare-workers-彻底告别服务器]]