
自建服务玩到一定程度,绕不开三样东西:登录用的二次验证、随手记的笔记、多设备之间的文件。三个需求看着不搭,选型逻辑却一样:数据得握在自己手里,部署别折腾,坏了能恢复。这篇把三类里我实测过的三个开源方案一次讲清:2FA 选 Ente Auth、笔记选 Joplin、文件同步选 Syncthing,每款都给部署方法、踩过的坑和卸载办法,最后给一张“三句话怎么挑”的对照表。
先看总表:三款怎么挑
| 需求 | 选它 | 一句话定位 | 部署成本 |
|---|---|---|---|
| 2FA 验证码多端同步 | Ente Auth | 开源、端到端加密,验证码自己管 | 偏高(需搭服务端) |
| 笔记多端同步 | Joplin Server | Markdown 笔记 + 自建同步端 | 中等(两个容器) |
| 文件多设备同步 | Syncthing | 点对点同步,不走第三方服务器 | 低(一个容器) |
三款都是开源免费、数据放自己 NAS 上。如果只想先上一个,Syncthing 最轻,先从它开始。
一、2FA:Ente Auth——验证码不再锁死在一台手机
干什么用:Ente Auth 是开源的两步验证器,支持 TOTP 验证码,端到端加密。换手机不用逐个服务重新扫码,登录自建服务端就能把验证码同步回来。它和 Ente Photos 共用同一套服务端(museum),自建一次,两边都能用。
Docker 一键部署:官方提供 quickstart 脚本,在群晖上用 SSH 进到 docker 目录执行:
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ente/ente/main/server/quickstart.sh)"脚本会在当前目录生成 my-ente,拉起 museum(API,端口 8080)、PostgreSQL、MinIO 和 Web 端(端口 3000)。装好后打开 Web 端注册,第一个注册的用户默认就是管理员,注册用的验证码去 docker compose logs 里找。
实测要点:手机装 Ente Auth App,首次登录要点 7 下欢迎页才能改自定义服务端地址,填进你的 http://NAS-IP:8080。导入旧验证码支持从 Aegis、Google Authenticator 等直接迁移,扫码导入一次搞定。
避坑:
- Ente Auth 要求 HTTPS 才能正常同步,内网 IP 直连会受限,正式用之前先用 Lucky 或反代配好域名和证书。
- 注册完、确认只有自己一个账号后,把 museum 的开放注册关掉,别让服务端裸奔。
- 恢复密钥(Recovery Key)单独抄一份放密码库,服务端密码和恢复密钥丢一个,验证码就找不回来。
- 自建服务端偏重(museum + 数据库 + 对象存储三件套),如果只是想要“换手机不丢验证码”,不搭服务端、直接用 Aegis(纯本地 + 加密备份文件)更轻量,没必要为了 2FA 单独养一套服务端。
怎么卸载:docker compose down 停掉 my-ente 目录下的容器,删掉 my-ente 目录和映射的数据卷即可。卸载前先把 Auth 里的验证码导出备份,否则验证码随容器一起没了。
二、笔记:Joplin Server——Markdown 笔记的自建同步端
干什么用:Joplin 是开源 Markdown 笔记,客户端全平台都有。官方同步要走 Joplin Cloud(付费),自建 Joplin Server 后,手机、电脑、平板的笔记都同步到自己 NAS,不用再把笔记交给第三方。
Docker 一键部署:一个 PostgreSQL 容器加一个 Joplin Server 容器,docker-compose.yml 这样写:
services:
db:
image: postgres:16
container_name: joplin-db
restart: unless-stopped
volumes:
- ./data/postgres:/var/lib/postgresql/data
environment:
- POSTGRES_USER=joplin
- POSTGRES_PASSWORD=换成你自己的强密码
- POSTGRES_DB=joplin
app:
image: joplin/server:latest
container_name: joplin-app
depends_on:
- db
restart: unless-stopped
ports:
- "22300:22300"
environment:
- APP_PORT=22300
- APP_BASE_URL=http://NAS-IP:22300
- DB_CLIENT=pg
- POSTGRES_HOST=db
- POSTGRES_USER=joplin
- POSTGRES_PASSWORD=换成你自己的强密码
- POSTGRES_DATABASE=joplin
- POSTGRES_PORT=5432docker compose up -d 拉起后打开 http://NAS-IP:22300,默认管理员账号是 admin@localhost,密码 admin。各客户端在同步设置里选 Joplin Server,填同一个地址就能同步。
避坑:
APP_BASE_URL是最容易翻车的一项:必须填客户端实际能打开的地址,内网用http://NAS-IP:22300,外网用反代后的 HTTPS 域名。改了地址要重建容器,否则客户端会报 Invalid origin。- 首次登录立刻改掉默认管理员密码,再单独建一个普通账号给日常同步用,别拿管理员账号同步。
- Joplin Server 只管同步,不管备份。笔记数据在 PostgreSQL 卷里,记得把它纳进群晖 Hyper Backup 的备份计划。
怎么卸载:docker compose down -v 停容器并删数据卷,再删掉 compose 目录。卸载前先在客户端把同步目标改回本地或导出 JEX 备份,笔记本体在各客户端都有一份,不会因为服务端删了就丢。
三、文件同步:Syncthing——不走云盘的多设备同步
干什么用:Syncthing 是开源的点对点文件同步工具,设备之间直连传文件,不经过任何第三方服务器。NAS 上常驻一个节点,手机拍的照片、电脑改的文档,回家连上内网就自动同步到位,相当于自己搭了个没有中心服务器的“私有云盘”。
Docker 一键部署:用 linuxserver 的镜像最省事:
services:
syncthing:
image: lscr.io/linuxserver/syncthing:latest
container_name: syncthing
hostname: syncthing
restart: unless-stopped
environment:
- PUID=1000
- PGID=1000
- TZ=Asia/Shanghai
volumes:
- ./config:/config
- /volume1/photo:/sync/photo
ports:
- "8384:8384"
- "22000:22000/tcp"
- "22000:22000/udp"
- "21027:21027/udp"8384 是管理界面,22000 是设备间同步端口,21027/udp 是局域网发现。起好后打开 http://NAS-IP:8384,在各设备上装 Syncthing 客户端,用设备 ID 配对、勾上要同步的文件夹就行。
避坑:
- 第一件事是给管理界面设密码:默认 8384 端口没有鉴权,裸奔在公网等于把同步目录敞开给人看。
- 同步不等于备份:A 设备误删文件,删除动作也会同步到所有设备。重要目录一定开文件版本控制(交错版本或简易版本),或者再配一份 Hyper Backup。
- PUID/PGID 填群晖上实际有读写权限的用户 ID,填错了容器能跑、同步目录却写不进文件,日志里只会看到权限报错。
- 跨公网同步不通时先查 22000 端口有没有放行,不通就走官方中继,速度会慢很多,这是正常的。
怎么卸载:docker compose down 停容器,删 compose 目录和 config 卷。同步过的文件还留在各设备的本地目录里,卸载容器不会删文件,但配对关系要重建。
三句话,怎么挑

- 只想解决“换手机丢验证码”:先装 Aegis,够用了再考虑 Ente Auth 自建。
- 笔记已经在用 Joplin 客户端:直接上 Joplin Server,同步端半小时就能跑起来。
- 只想让手机、电脑、NAS 之间的文件自动保持一致:Syncthing 一个容器搞定,优先上它。
三款跑起来之后,顺手做两件事:一是把它们的配置目录和数据库卷都纳进群晖备份计划,二是用 Uptime Kuma 把 22300、8384 这些端口的存活状态监控起来,挂了第一时间知道。
相关旧文
- Vaultwarden 自建密码库:Docker 一键部署 + 多端同步实测:密码和 2FA 是同一套账号安全组合,密码库先搭好,验证码再接上。
- 群晖 3-2-1 备份方案:Hyper Backup + 快照 + 异地备份一次配好:同步不等于备份,Joplin 的数据库和 Syncthing 的同步目录都要进备份计划。
- Uptime Kuma 监控告警:NAS、VPS、摄像头在线状态一屏看清:三个服务的端口存活状态,挂一个 Kuma 监控项就能盯住。


评论 (0)