这是「Docker 好项目」系列的第 21 期。前 20 期我们写了监控、密码库、照片、音乐、代码、文档、记账、认证……每一篇的结尾我都写了一句「记得备份」。今天得承认一件事:这套系列里唯一没被认真写过的东西,就是备份本身。而且前面 20 个服务的数据全躺在同一台服务器的同一块盘上——那台机器一挂,等于 20 期一次清零。这期介绍 Kopia:一个把"备份"这件事做对的工具。

Kopia 效果图

痛点开场

先说个不好听的现实。翻一遍你的自托管清单:

  • Immich 的相册(第 4 期)在 /opt/xxx/library,Paperless-ngx 的档案(第 14 期)在 /opt/xxx/media,Gitea 的仓库(第 10 期)在 /opt/xxx/data,Vaultwarden 的密码库(第 3 期)在 /opt/xxx/data/db.sqlite3……全都在这台机器这块系统盘上
  • Docker 卷不是备份。docker volume 只是换个目录放,盘坏了照样一起没
  • cp -r 也不是备份。拷到一半机器断电,你得到一堆半截文件,还原时报错也不知道从哪开始;拷完不校验,坏块静悄悄地跟着你走
  • 拷过去的那份自己也不安全。如果目标目录被勒索软件扫到,加密后的文件连同"备份"一起被锁
  • "每天全量拷一遍"根本跑不下去。几百 G 的照片库,第二天你就把它关了——一个跑不完的备份方案等于没有备份方案

Kopia 的定位就是解决这几个问题:增量 + 去重 + 客户端加密 + 快照式历史 + 定时策略,一个二进制,跑在容器里,把数据推到远端。它和 Duplicati、restic、Borg 是同类,但它的差异化在"快照策略(Policy)"这套模型上——备份频率、保留规则、排除规则全都可以在服务端配、按路径配、还能继承,不用去改一堆 crontab。

数据模型上它把仓库拆成三层:Blob(后端存储里的一坨字节)→ Object(内容寻址的对象,切割后压缩加密)→ Manifest(把对象组织成"某时刻某个目录长什么样")。这也是它增量快的原因——文件没变,对应的 object 就不用重传。

Kopia 三层数据模型

能力边界

能干什么

  • 端到端加密:默认 AES256-GCM-HMAC-SHA256,密钥由仓库密码派生,密钥永远不上传。云厂商拿到的只有密文和一堆看不出内容的对象
  • 内容去重 + 压缩:一样的块只存一份。同一个 Docker 镜像跑十个副本、十份文档里有九份是复印件,仓库只占一份的空间
  • 增量快照 + 时间点还原:每次备份是一条不可变快照,可以按时间点浏览任何一天的文件长什么样,可以整目录还原,也可以只捞出某个文件
  • 策略(Policy)模型:备份几小时一次、保留多少个 hourly/daily/weekly/monthly、排除哪些目录、用什么压缩、传到哪、多久做一次维护——都能单独设,且支持按用户/主机/路径分层继承(--global 是根,user@host:/path 是叶子,子级不设就继承父级)
  • 一份仓库多个来源:服务器目录、家里的 NAS、你笔记本上的文件夹,可以推到同一个仓库里,各自独立保留策略
  • 存储后端多:本地/NFS 目录、S3 兼容(含 MinIO、阿里云 OSS、腾讯云 COS)、WebDAV、SFTP、Google Drive、OneDrive、Azure Blob、B2,还有 rclone 通道(能覆盖 rclone 支持的一切对象存储)
  • 备份通知:内置 email / Pushover / Webhook 三种通知通道,可以按"失败才通知"配置
  • Web UI:漂亮的网页管理台,能在浏览器里浏览快照、下载单个文件、还原目录(不用回命令行)
  • 后端校验:kopia snapshot verify 支持按百分比抽样校验,加 --verify-files-percent 能真的读回数据核对内容哈希

不干什么

  • 不能给"裸机灾难恢复"。它备份的是文件,不是磁盘镜像。系统盘炸了,你得先重装系统、装好 Docker、再 kopia restore 把数据捞回来。想要一键整机恢复得配 PVE 快照 / dd / 云厂商磁盘快照,那是另一套
  • 不是同步工具。不做双向同步,不做"两台机器实时一致"。它是单向的、时间点的
  • 不帮你处理数据库一致性。MySQL/PostgreSQL 备份期间正在写入的页可能不一致。正确姿势是先在应用层 dump 成文件,再备份 dump 文件(后面会写怎么串)
  • 不覆盖手机相册。想备份手机照片,走 Immich(第 4 期)或 Syncthing 把文件同步到服务器,再让 Kopia 备份那个目录

部署前准备

项 说明
服务器 任意 Linux,1 核 1G 起,CPU 主要在压缩/加密上;amd64 / arm64 / armv7 都有镜像
磁盘 仓库不要和数据放同一块盘。理想是另一个盘/另一台 NAS,退一步至少是另一个分区
镜像 kopia/kopia,推荐 0.23(滚动次版本 tag,实测 0.23 == 0.23.1 == latest)
端口 51515(HTTP + gRPC 同端口,Web UI 也在这里)
权限 要读所有数据 + 挂 FUSE 做即时还原 → 容器需要 root + SYS_ADMIN + /dev/fuse
关键环境变量 KOPIA_PASSWORD(仓库密码)、KOPIA_CONFIG_PATH、KOPIA_CACHE_DIRECTORY
数据卷 /app/config(仓库连接配置)、/app/cache(本地缓存)、/app/logs(日志)

先做一件不能省的事:把仓库密码写进密码管理器(第 3 期 Vaultwarden 就是干这个的)。Kopia 零知识,密码丢了作者也救不了你,这个仓库连同里面全部历史永远打不开。

mkdir -p /opt/kopia/{config,cache,logs,repository}
# 仓库放另一个盘的话,把 repository 换成 /mnt/backup-disk/kopia 之类

docker run 一行版

先跑起来看个明白,正式用建议直接看下面的 compose 版:

docker run -d \
  --name kopia \
  --restart unless-stopped \
  --privileged \
  --cap-add SYS_ADMIN \
  --security-opt apparmor:unconfined \
  --device /dev/fuse:/dev/fuse:rwm \
  -e KOPIA_PASSWORD='换成你自己的强密码' \
  -e TZ='Asia/Shanghai' \
  -e USER='kopia' \
  -p 51515:51515 \
  -v /opt/kopia/config:/app/config \
  -v /opt/kopia/cache:/app/cache \
  -v /opt/kopia/logs:/app/logs \
  -v /opt/kopia/repository:/repository \
  -v /opt/1panel/apps:/data/apps:ro \
  -v /var/lib/docker/volumes:/data/docker-volumes:ro \
  kopia/kopia:0.23 server start --address=0.0.0.0:51515

注意 --server-username / --server-password 这里故意没写:不写的话 Web UI 会弹一个"创建用户"的向导,让你现场设管理员账号(存进仓库里)。这比在命令行上明文写密码安全,下面 compose 版也沿用这个做法。

docker-compose 推荐版

services:
  kopia:
    image: kopia/kopia:0.23
    container_name: kopia
    restart: unless-stopped

    # Kopia 要读宿主机全部数据、还要挂 FUSE 做即时还原,权限给足
    privileged: true
    cap_add:
      - SYS_ADMIN
    security_opt:
      - apparmor:unconfined
    devices:
      - /dev/fuse:/dev/fuse:rwm

    command:
      - server
      - start
      - --address=0.0.0.0:51515
      # 走 Cloudflare 或 1Panel 反代时,HTTPS 由外层终止,这里保持 HTTP
      # 配 Cloudflare 的话再加一行 --tls-cert-file / --tls-key-file 做端到端加密

    environment:
      # 仓库密码:所有数据的主密钥,务必用密码管理器另存一份
      KOPIA_PASSWORD: '换成你自己的强密码'
      TZ: Asia/Shanghai
      USER: kopia
      # 不把凭据写进仓库配置文件(默认就是 false,显式写出来防止误解)
      KOPIA_PERSIST_CREDENTIALS_ON_CONNECT: "false"
      # 容器里不需要它自己检查更新,升级由你控制
      KOPIA_CHECK_FOR_UPDATES: "false"

    ports:
      - "127.0.0.1:51515:51515"   # 只监听本机,公网入口交给 1Panel 反代

    volumes:
      - ./config:/app/config
      - ./cache:/app/cache
      - ./logs:/app/logs
      # 备份仓库落盘位置:理想是另一个物理盘或 NFS 挂载点
      - /opt/kopia/repository:/repository
      # 只读挂载要备份的数据。冒号后不加 :ro 就等着写坏源数据
      - /opt/1panel/apps:/data/apps:ro
      - /var/lib/docker/volumes:/data/docker-volumes:ro
      - /etc:/data/etc:ro

    healthcheck:
      # 镜像没有内置 HEALTHCHECK,用自带的 server status 探活
      test: ["CMD", "/bin/kopia", "server", "status", "--address=http://127.0.0.1:51515"]
      interval: 60s
      timeout: 10s
      retries: 3
      start_period: 30s

几个"为什么这么写":

  • --privileged + cap_add: SYS_ADMIN + security-opt apparmor:unconfined 不是偷懒。FUSE 挂载需要 SYS_ADMIN,而 Debian/Ubuntu 默认的 docker AppArmor profile 会挡住 mount 系统调用——三个都给上才是官方 compose 的做法。如果你不需要"在浏览器里挂载快照当目录浏览"这个功能,可以把 privileged 和 FUSE 这段全删掉,纯命令行备份完全不需要它们
  • 所有数据卷都带 :ro。Kopia 只读源数据,万一它出 bug 也不会把源文件改坏。这是用完就回不去的习惯
  • 端口只绑 127.0.0.1。Web UI 有登录,但没必要把登录页直接暴露在公网上让人撞库,入口统一走反代
  • USER: kopia 是继承的。这条来自官方 compose(Kopia 用 ClientOptions().UsernameAtHost() 去认"谁是这个仓库的维护者")。注意它和 PUID/PGID 是两回事——镜像里根本没有 PUID 处理逻辑,设了也没用
  • KOPIA_PASSWORD 用单引号包住。密码里有 $、!、# 的话,不加引号 compose 会替你解释一遍,然后就"密码错误"了。这个坑很多人踩过

配置项逐项解释

环境变量

变量 默认值 作用 / 为什么这么设
KOPIA_PASSWORD 无(必填) 仓库主密码。它派生加密密钥,零知识,丢了数据永久打不开。所有容器、所有恢复场景都要它
KOPIA_CONFIG_PATH /app/config/repository.config 仓库连接配置(含后端地址、用户名)。不含密码,所以可以跟着 config 卷一起备份
KOPIA_CACHE_DIRECTORY /app/cache 本地元数据缓存。有了它列目录、算增量才快。丢了只会变慢,不会丢数据,可以放心删
KOPIA_LOG_DIR /app/logs 日志目录。排障时 docker logs 只能看到一部分,全量日志在这里
KOPIA_PERSIST_CREDENTIALS_ON_CONNECT true 建议设 false。设 false 就不把凭据写进 repository.config,避免配置文件泄漏等于仓库被打开
KOPIA_CHECK_FOR_UPDATES true 容器里建议关掉。顺带一个隐私点:开着的话它会定期请求 api.github.com 查最新版本
RCLONE_CONFIG /app/rclone/rclone.conf 用 rclone 后端时的配置文件路径

server start 的常用参数

参数 默认值 说明
--address http://127.0.0.1:51515 监听地址。容器里要写 0.0.0.0:51515 才能从宿主机访问
--server-username / --server-password 用户名 kopia、密码空 Basic Auth 登录。都不给时启动向导让你在网页上建第一个用户(推荐,见下文)
--tls-cert-file / --tls-key-file 无 让 Kopia 自己起 HTTPS。不接反代、直接对外暴露时才需要
--refresh-interval 4h 多久刷新一次仓库状态。任务多的话别调太小,会空转
--ui true 是否提供 Web UI。带 SSH 的纯 CLI 机器可以关掉
--ui-title-prefix 无 页面标题前缀(多仓库时区分用),可用 KOPIA_UI_TITLE_PREFIX
--max-concurrency 0(自动) 最大并发任务数。小内存机器(比如 1C1G 的轻量服务器)建议显式设 2 左右
--shutdown-grace-period 5s 优雅关闭等待时间。备份刚好在跑时,调大一点让它收尾

两个密码别搞混(源码里是两套独立的认证):

概念 用户名 用途
UI 用户 --server-username,默认 kopia 浏览器访问 Web UI 的登录凭据
控制用户 --server-control-username,固定叫 server-control 让命令行客户端远程指挥这台服务器(暂停/刷新/触发快照)。对应 <name> 的管理命令用它

1Panel 面板怎么搞

1Panel 应用商店里没有 Kopia(1Panel-dev/appstore 当前 265 个应用,kopia 零命中;同类备份工具的坑位也是空的)。所以走容器 → 编排:

  1. 左侧菜单 → 容器 → 编排 → 创建编排
  2. 名称填 kopia,把上面的 compose 原样贴进去,把 KOPIA_PASSWORD 和几个宿主机路径改掉
  3. 创建前先确认 /opt/kopia/{config,cache,logs,repository} 都已存在,否则 Docker 会以 root 创建这些目录,后面权限会绕
  4. 点确定,等容器起来。编排文件会落在 /opt/1panel/apps/kopia/kopia/docker-compose.yml——以后要改配置,编辑这个文件再重建,别在面板里改一半
  5. 站点里加反向代理指向 127.0.0.1:51515,并顺手申请 Let's Encrypt 证书(Kopia 自己那个 TLS 是自签的,浏览器会报不安全)
  6. 反代记得放长超时。备份首扫、校验、还原都是长连接,默认 60 秒会把你的还原请求掐断:
# /opt/1panel/www/sites/<你的域名>/proxy/root.conf
proxy_connect_timeout 60s;
proxy_send_timeout    3600s;
proxy_read_timeout    3600s;
client_max_body_size  0;          # 上传不限大小(还原上传大文件时要用)
proxy_buffering       off;        # WebSocket / gRPC 流式通信需要

1Panel 的反向代理默认就会透传 WebSocket 的 Upgrade 头,一般不用额外加。要注意的是别自己在站点里重复 add_header——上游和代理各加一遍同名安全头,浏览器会判定策略失效(第 16 期 Actual Budget 就栽在这上面);这里 Kopia 没设什么安全头,正常反代即可。

首次访问

浏览器打开 http://<你的服务器IP>:51515(或反代后的域名),会看到 Kopia 的连接向导:

  1. 先连仓库。第一次用的话选「创建新仓库」: - 存储类型选 Filesystem,路径填容器内路径 /repository(对应宿主机 /opt/kopia/repository) - 或者选 S3 Compatible Storage 填对象存储的 endpoint/bucket/key(腾讯云 COS 就是 S3 兼容) - 密码就填 KOPIA_PASSWORD 那个
  2. 然后会让你创建第一个 UI 用户(因为我们没传 --server-username/password)。用户名密码自己定,这个账号存在仓库里,会随仓库一起被备份
  3. 进去之后点左侧 Snapshots → New Snapshot,浏览目录树勾上要备份的目录(容器里能看到的就是我们 -v 挂进去的那些 /data/...),点 Snapshot Now 跑第一次

第一次会慢,因为要全量读一遍、切块、去重、加密、上传。之后再跑就只传变化的部分。

最小可用配置

先用 CLI 把"仓库 + 策略 + 第一次备份"跑通,命令都在容器里执行(docker exec -it kopia /bin/kopia ...):

# 1) 建仓库(容器内路径 /repository)——如果想在网页上建,跳过这步
docker exec -it kopia /bin/kopia repository create filesystem --path=/repository

# 2) 给"服务器上这一整棵目录树"设全局策略
docker exec -it kopia /bin/kopia policy set --global \
  --snapshot-interval=6h \
  --keep-latest=10 --keep-daily=30 --keep-weekly=12 --keep-monthly=12 --keep-annual=3 \
  --ignore-identical-snapshots=true \
  --compression=zstd-fastest

# 3) 看一眼策略到底生成了什么(强烈建议,比记参数靠谱)
docker exec -it kopia /bin/kopia policy show --global

# 4) 手动跑第一次备份
docker exec -it kopia /bin/kopia snapshot create /data/apps

# 5) 列出快照,确认有记录
docker exec -it kopia /bin/kopia snapshot list --all

参数说明(都是"为什么"):

  • --snapshot-interval=6h:每 6 小时一次。这是客户端调度——Kopia 的定时备份靠的是"长时间驻留的进程",所以服务器模式才会按时触发;用一台机器临时 kopia snapshot create 是不会自己排班的
  • --keep-latest=10 等保留规则:10 份最近快照 + 30 份每日 + 12 份每周 + 12 份每月 + 3 份每年。去重之后多留几份的成本很低,真正贵的是"需要的时候历史不够"
  • --ignore-identical-snapshots=true:内容一点没变就不产生新快照。避免半夜被一堆"空快照"刷屏
  • --compression=zstd-fastest:服务器 CPU 一般有余,压缩换存储最划算。文档、代码、日志能压掉一大半;已经压过的视频/图片收益很小,但也不会更差
  • 注意 --snapshot-time-crontab 收的是分号分隔的多个表达式(0 3 * * *;0 15 * * *),不是逗号。写了 cron 之后 --snapshot-interval 会让位

策略是按路径分层继承的,这是 Kopia 最好用的地方。比如整个 /data/apps 保留 30 天,但 paperless 的归档库想留 5 年:

# 给单个目录设更长的保留期,其余设置自动继承全局
docker exec -it kopia /bin/kopia policy set /data/apps/paperless-ngx \
  --keep-daily=90 --keep-monthly=60 --keep-annual=5

# 反过来,把某个目录彻底排除
docker exec -it kopia /bin/kopia policy set /data/apps/xxx/cache \
  --add-ignore=/data/apps/xxx/cache/*

数据库要单独处理——别直接备份正在跑的 MySQL 数据目录:

# 先 dump 成文件,再让 Kopia 备份这个文件
docker exec your-mysql sh -c \
  'exec mysqldump --all-databases -uroot -p"$MYSQL_ROOT_PASSWORD"' \
  > /opt/kopia/dumps/mysql-$(date +%F).sql

把 /opt/kopia/dumps 挂进 Kopia 容器一起备份。先 dump 后备份是这个链路里唯一不能省的一步。

告警/通知配置

Kopia 把通知做成"配置文件(profile)+ 发送通道",三种通道:Email、Pushover、Webhook。Webhook 是给我们这种自托管玩家准备的——可以直连第 13 期那个 ntfy,或接企业微信/钉钉/飞书的机器人地址:

# 建一个叫 ntfy 的通知配置,只在出错时推送
docker exec -it kopia /bin/kopia notification profile configure webhook \
  --name=ntfy \
  --endpoint="https://ntfy.你的域名/kopia-alerts" \
  --method=POST \
  --format=plain-text \
  --min-severity=error

# 建完可以手动发一条测试,确认管道通
docker exec -it kopia /bin/kopia notification profile send --name=ntfy \
  --subject="Kopia 测试" --body="通知链路正常"

要点:

  • --min-severity=error 是关键。默认级别更低,成功也推,用几天你就会把 ntfy 静音——那这个告警就白配了
  • --format=plain-text 配合 ntfy 更清爽;接企业微信机器人(它要 JSON)时用 --format=html 再配合 --http-header 试,或者加一层 n8n(第 19 期)做格式转换
  • 备份任务默认会发送快照报告。如果你只想要"失败通知",可以给不需要报告的来源设 --send-snapshot-report=false(这是 policy set 的支持项)
  • 健康检查建议走外部。镜像没有内置 HEALTHCHECK,compose 里那条 kopia server status 只证明进程活着。真正要盯的是"最后一次成功快照是什么时候"——用第 1 期 Uptime Kuma 监控一个自建脚本,或者用第 12 期 Miniflux 订阅 Kopia 的报告邮件,都比"进程活着"有用

反向代理与 HTTPS

推荐架构:Kopia 只监听 127.0.0.1:51515,1Panel 反代(或 Cloudflare)在前面做 TLS。

location / {
    proxy_pass http://127.0.0.1:51515;
    proxy_http_version 1.1;
    proxy_set_header Host              $host;
    proxy_set_header X-Real-IP         $remote_addr;
    proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_read_timeout 3600s;
    proxy_send_timeout 3600s;
    proxy_buffering off;
}

如果要跑在 Cloudflare 后面:关掉它自己那个 TLS(--tls-cert-file 参数去掉),让 Cloudflare 和源站之间用源证书加密,Kopia 只提供 HTTP。两边都开 TLS 会变成"双重 TLS",配置复杂还容易出证书指纹不匹配的问题。

另外一个容易忽略的点:Kopia 的 Web UI 和 gRPC 共用 51515 端口。反代如果只转发普通 HTTP 请求、把升级请求掐了,网页能打开但很多操作会转圈。上面 proxy_buffering off 和 1.1 版本声明就是干这个的。

踩坑清单

  1. 密码里的特殊字符。KOPIA_PASSWORD 在 compose 里一定用单引号包住。密码含 $、!、反引号时不加引号,会被 YAML/shell 先解释一遍,表现是"密码错误"——看着像 bug,其实是转义
  2. 忘了仓库密码 = 数据报废。零知识设计,没有后门、没有找回入口。请把它和 Vaultwarden 一起管理,并且单独记一份(Vaultwarden 也在被它备份,别形成循环依赖)
  3. 源目录忘了加 :ro。-v /opt/1panel/apps:/data/apps(不带 :ro)虽然 Kopia 正常不会去写,但一旦策略配错(比如 actions 脚本写错路径),源数据就在可写范围内。加 :ro 成本为零
  4. FUSE 相关的三个权限给不全会启动失败。cap_add: SYS_ADMIN、security-opt apparmor:unconfined、--device /dev/fuse 是配套的,少一个就是 permission denied 或者挂载点建不起来。只用命令行备份的话,这三个都可以不要
  5. --server-username 和 --server-control-username 是两套东西。前者是网页登录名(默认 kopia),后者固定叫 server-control,用于命令行远程控制。互相填混会得到 401
  6. 容器内路径 ≠ 宿主机路径。策略里写的路径是容器内看到的(/data/apps/...),不是宿主机的 /opt/1panel/apps/...。反代/看日志时经常搞混
  7. 维护(maintenance)需要"有人负责"。Kopia 的 FullCycle(默认每 24h)和 QuickCycle(默认每 1h)会压缩索引、回收垃圾对象。一个仓库只能有一个维护者(默认是第一个连上来的 用户名@主机名)。如果你从多台机器连同一个仓库,得确认维护者那台在线,否则仓库会长胖
  8. Kopia 服务器本身不会自动"排班"。定时快照依赖进程常驻 + 策略里的时间设置。如果你只是想每天跑一次,用宿主机 cron 调 kopia snapshot create 更简单可控——不是所有场景都值得上服务器模式
  9. 首次备份会撑爆 CPU 和带宽。大目录首扫是实打实的全量读取。建议分两次跑:先跑一个小的目录验证策略,再挂完整的目录,并在 --max-concurrency 上留点余量
  10. 别把仓库放在被备份的那个目录里。听起来像废话,但把 /opt/kopia/repository 挂在 /opt 下、然后又备份 /opt,结果是备份自己包含了备份,仓库指数级膨胀

备份(Kopia 自己的)

这件事必须单独说,因为备份工具自己的配置丢了,是一种特别窝火的失败:

要备份的东西 在哪 丢了会怎样
仓库密码 你的密码管理器 数据永久无法解密。这是唯一不可恢复的
/app/config/repository.config 宿主机 ./config 要重新配一次后端连接(密码不在里面,可重建)
./logs/、./cache/ 宿主机 日志和缓存,丢了只影响排障和速度
仓库本体 /opt/kopia/repository 或对象存储 数据全在里面
# 仓库本体用 rsync 做一份异地副本(Kopia 仓库是自描述的,冷备即可)
rsync -a --delete /opt/kopia/repository/ /mnt/other-disk/kopia-mirror/

# 定期做一次抽样校验,确认仓库真的能读出数据
docker exec -it kopia /bin/kopia snapshot verify --verify-files-percent=10

# 清掉已经不满足保留策略的快照(会释放实际空间)
docker exec -it kopia /bin/kopia snapshot expire --all

最后一句最重要:定期真的做一次还原演练。随手挑一个文件,从网页里下载出来看能不能打开。备份能不能用,只有还原过才知道。

小结

适合谁

  • 已经在自托管、并且开始害怕的人。跑满 20 个服务、数据全在一块盘上,这时候补一套 Kopia 是性价比最高的一步
  • 要"改一份文件、只传变化部分"的人。照片库、文档库、代码仓库这类大而少变的目录,去重 + 增量的收益非常明显
  • 不信任云厂商的人。客户端加密意味着对象存储里放的是密文,你甚至可以放心用别人的 S3
  • 想做"分层保留"的人。近期密、远期疏,30 天日备 + 12 个月备,一条策略搞定
  • 愿意花两小时把备份这条路走通、然后永远不再想它的人

不适合谁

  • 想要一键整机恢复的人。Kopia 备份文件不备份系统,灾难恢复还得配合快照/镜像
  • 只想定期拷一个文件夹、不介意没有历史版本的人。rsync 更简单,别过度工程
  • 完全不想记密码的人。(这条是认真的:忘了密码,这套东西就是一堆随机字节)
  • 跑在 1C1G 小机上、数据量上 T 的人。加密和去重吃 CPU,首扫期间会很难受

和系列里的邻居怎么配合

  • 源数据:从第 3 期 Vaultwarden、第 4 期 Immich、第 10 期 Gitea、第 14 期 Paperless-ngx 的挂载目录里选要备份的
  • 通知:Webhook 直连第 13 期 ntfy,失败秒推手机
  • 监控:第 1 期 Uptime Kuma 盯"最后成功快照的时间",比盯进程有用
  • 编排:数据库 dump 那一步交给第 19 期 n8n 定时跑,dump 完再触发 Kopia

前面二十期把东西一件件搬回了自己家。这一期说的是——搬回来了,也别忘了上锁和留个后路。

项目地址

本文核实时的最新版本为 0.23.1(2026-06-16 发布),14.2k star,Apache-2.0。文中镜像统一用 kopia/kopia:0.23——实测 0.23、0.23.1、latest 三个 tag 的 manifest 摘要完全一致,说明它属于"次版本 tag 会跟着补丁滚动"的那一类,钉 0.23 既能拿到安全补丁又不会跳出次版本。如果你的场景对版本极其敏感,改成 0.23.1 也可以。