# 你的卡片， 在你的服务器上同步。

> 把全卡卡的同步服务与网页保险库部署到自己的服务器：iPhone 与网页端到端加密同步，服务器只存密文。服务端开源、可审计，一条命令即可部署。

Source: https://quancard.app/server/

把同步服务和网页保险库部署到自己的服务器。iPhone 与浏览器之间加密同步，服务器只保存它读不懂的数据。服务端开源、可审计，由你掌控。

## 让 AI 助手帮你安装

复制提示词给 Claude Code、Codex 等，按官方 Skill 安全安装。

复制下面的提示词，交给能在服务器上执行命令的 AI 助手（如 Claude Code、Codex、Cursor）。它会先检查环境、征得你确认，再按官方 Skill 完成安装与验证。

```
请帮我在我的服务器上安装 QuanCard Server（全卡卡自建同步服务与网页保险库）。

先阅读并严格遵循官方安装 Skill：
https://quancard.app/.well-known/agent-skills/quancard-server-install/SKILL.md
若无法读取，再参考 https://quancard.app/server/docs/ 与 https://github.com/zoolapp/quancard-server。

要求：
1. 先只做只读检查（系统、Docker、域名解析、80/443 端口占用、已有反向代理），汇报结果并推荐安装方式，等我确认后再改动。
2. 安装最新正式发布版本并固定版本号；运行任何下载的脚本前先阅读，并说明它会做什么。
3. 不要把 .env、QC_SECRET 或初始化令牌写进日志、提交或发送到任何外部服务；也不要向我索要卡号、密码等卡片资料。
4. 删除数据、覆盖已有配置、修改防火墙或重启已有服务前，先征得我同意；保留官方的容器安全加固设置。
5. 完成后逐项验证（HTTPS 证书、/healthz、8080 端口未暴露、.env 权限 600、备份脚本可用），给我一份简短报告，并告诉我如何创建所有者账户和配对 iPhone。

全程用中文回复。我的域名：vault.example.com（请替换为你的域名）
```

提示词只包含安装要求，不需要也不应包含任何卡片资料或密码。 [查看 Agent Skill](https://quancard.app/.well-known/agent-skills/quancard-server-install/SKILL.md)

## 多端同步

iPhone 与网页使用同一套版本协议，任一端的修改都会出现在另一端。

## 完全自托管

一个 Docker Compose 文件，自动 HTTPS。域名、备份与升级节奏都由你决定。

## 安全可控

卡片在你的设备上加密后才同步。服务器看不到卡号，也看不到你的密码。

## 扫一次码， 两端同时就绪。

在网页生成一次性二维码，用 iPhone 扫描即可完成配对。密钥只从浏览器交给手机，从不经过服务器。

- 一次性配对码: 二维码 10 分钟内有效、只能使用一次。配对前需要再次输入密码。

- 两端同步确认: 手机连上的瞬间，网页随即确认，两端播放同一段连接动画，并显示首次同步进度。

- 自动保持最新: 网页回到前台时刷新，打开期间每 60 秒刷新一次；iPhone 按自己的节奏同步。

## 数据放在你的服务器， 也只有你能读懂。

你的卡片在离开设备之前就已经加密。即使服务器或备份被别人拿到，看到的也只是一串无法读取的数据。

- 01: 在你的设备上加密: 卡片先在 iPhone 或浏览器里加密，再同步出去。密码从不离开你的设备。

- 02: 服务器只存密文: 服务器上只有加密后的数据。硬盘或备份即使被人拿走，也读不出任何内容。

- 03: 数据完全属于你: 服务器、域名和备份都在你手里，解开数据的钥匙只在你自己的设备上。

采用业界通行的加密标准：AES-256 加密你的数据，Argon2 保护你的密码。

### 服务器能看到

- 账户名与登录时间

- 版本数量、大小与写入时间

- 已配对设备的名称

### 服务器看不到

- 卡号、有效期、安全码、账户号

- 备注、标签与卡面照片

- 你的密码与任何解密密钥

诚实的边界：被攻破的服务器可能下发篡改过的网页代码，这是所有浏览器端加密应用的共同限制。请自己运行服务器并及时更新；在不信任的主机上，优先使用 iPhone App。 [阅读威胁模型](https://github.com/zoolapp/quancard-server/blob/main/THREAT_MODEL.md)

## 修改冲突， 交给你决定。

两台设备离线时改了同一张卡？全卡卡从不让设备时钟悄悄决定胜负。内容完全相同的副本会自动合并；真正的差异进入冲突中心，逐字段对比后由你选择。

- 逐字段标出差异，敏感字段只显示"不同"

- 逐条选择，或批量处理：采用最近修改、示例数据各留一份、全部保留为副本

- 每次批量操作前都会列出完整清单

## 一个真正的桌面应用。

网页保险库不是简化版。它和 iPhone 共享卡面配色与示例数据，也有为键盘和大屏设计的交互。

### ⌘K 命令面板

搜索卡片、账户，或直接执行操作。

### 侧边栏与抽屉

按地区、收藏浏览；详情和编辑在侧边抽屉中打开。

### 默认遮罩

卡号只显示后四位；查看完整信息需要再次输入密码。

### 家庭成员

所有者发邀请；每位成员拥有独立账户和单独加密的保险库。

### 两步验证与审计

TOTP 与恢复码、限流与锁定、只追加的活动记录。

### 服务端开源

同步服务与网页保险库以 AGPL-3.0 开源；协议规范与测试向量以 Apache-2.0 开放。

## 三条命令， 部署你自己的同步服务。

需要一台装有 Docker 的 Linux 主机、一个指向它的域名，并开放 80 与 443 端口。1 核 CPU、512 MB 内存就足够一个家庭使用。

然后打开你的域名，创建所有者账户，再用 iPhone 扫码配对。

- 获取源码: `git clone https://github.com/zoolapp/quancard-server.git && cd quancard-server`

- 生成配置与一次性初始化令牌: `./scripts/init-env.sh vault.example.com`

- 启动服务，自动申请 HTTPS 证书: `docker compose up -d --wait`

## 关于自建服务

### 全卡卡是开源的吗？

不是。全卡卡 iPhone App 是商业应用，源码不公开。开源的只有自建服务 QuanCard Server，即同步服务端与网页保险库，以 AGPL-3.0 发布；协议规范与测试向量以 Apache-2.0 开放，方便你审计数据是如何加密和存储的。

### 自建服务需要付费吗？

QuanCard Server 可以免费使用、修改和部署，你只需要承担自己服务器的费用。全卡卡 App 的定价另行公布。

### 和 iCloud 同步有什么区别？

iCloud 跟随你的 Apple 账户，免维护；自建服务把数据放在你掌控的服务器上，还提供网页保险库与家庭成员账户。两者一次选择一种，切换前先断开当前连接，本机收藏会保留。

### 忘记密码怎么办？

无法重置——服务器从不知道你的密码，这是零知识设计的代价。已配对的 iPhone 仍保留本机副本。请使用长口令，并开启两步验证。

### 服务器被攻破会怎样？

数据库与备份里只有加密后的数据，泄露也不会暴露卡片内容。但攻击者可能篡改网页代码来窃取之后输入的密码，因此请保持系统和镜像更新，并在不信任的主机上优先使用 iPhone App。

### 可以只用网页，不用 iPhone 吗？

可以。网页保险库支持完整的增删改查、卡面照片与转账信息，也可以安装为桌面应用（PWA）。

### 目前处于什么阶段？

开发预览版，尚未经过独立安全审计。iPhone 端的自建同步将随 App 上架开放。部署与维护由你负责。

## 准备好部署了吗？

安装文档覆盖快速部署、反向代理、配置项、配对、备份与升级。

截图使用内置示例数据（公开测试号码，无法支付）。卡面及商标归各权利人所有。
