TL;DR:原文作者的方案是「17 个原生 systemd 服务 + 11 个 Podman 容器,跑在一台 180~359 欧元的 N100 迷你主机上,只通过 IPv6 + VPN 暴露到公网」。
本文档在原文基础上做了五件事:(1) 逐条拆解他的设计决策;(2) 把每个服务写成可复制的实操步骤;(3) 补上原文没覆盖但你会踩的坑——尤其是中国大陆网络环境(CGNAT / 备案 / 443 端口)的适配;(4) 第 10 章讲「装完到底得到什么」——把 28 个服务重组为 9 大能力域 + 5 个端到端场景;(5) 第 11 章讲「怎么长期养」——观测/控制/恢复三层运维体系、巡检脚本、升级纪律、恢复演练、灾难恢复手册。
⚠️ 动手前必读:这套方案默认你在有公网 IPv6 的欧洲/北美宽带下。中国大陆家庭宽带基本没有公网 IPv4(CGNAT),直接照抄会卡在第一步。本文第 7 章专门讲中国大陆怎么改,第 10~11 章讲这套东西装完之后能提供什么能力、以及如何长期运维。
目录
- 第 1 章 原文精读:他的 4 条原则
- 第 2 章 硬件基线:为什么是 N100 + 16GB
- 第 3 章 网络前置:整套方案的地基
- 第 4 章 17 个原生 systemd 服务逐个实操
- 第 5 章 Podman + Quadlet:11 个容器服务
- 第 6 章 明确「不自托管」的服务及替代方案
- 第 7 章 中国大陆网络适配(重点)
- 第 8 章 资源规划与容量估算
- 第 9 章 验收清单与常见故障
- 第 10 章 服务能力全景:搭完之后你到底得到了什么
- 第 11 章 运维手册:搭完之后怎么养
第 1 章 原文精读:他的 4 条原则
原文最有价值的不是那 28 个服务清单,而是他反复强调的 4 条判断原则。清单会过时,原则不会。
1.1 原则一:任何服务都不直接暴露到公网
他的原话大意是:除了路由器上跑的 VPN,没有任何服务直接把端口开到公网。所有 Web 服务(Caddy、Jellyfin、Immich…)都只监听内网,公网唯一入口是 VPN。
为什么这是对的?
| 暴露方式 | 攻击面 | 被打穿的代价 |
|---|---|---|
| 直接开公网端口 | 每天 24h 全球扫描 | 一个弱密码 = 数据全泄 |
| 只走 VPN | 只对有 VPN 密钥的人开放 | 密钥泄露 = 同上,但可控可审计 |
逻辑很简单:公网 = 全世界的靶场,内网 = 自家客厅。把「全家福」全挂到大街上不如留一扇门(VPN)自己开门。
落地三件套:
- 路由器上装 WireGuard/OpenVPN,只有 VPN 端口对公网开放。
- 所有 Web 服务的
listen绑127.0.0.1或内网网卡地址。 - 出门用手机连 VPN,再访问内网地址——体验和连家里 WiFi 一样。
国内落地提醒:家里没有公网 IPv4 时,第 3 条要改用第 7 章的 Tailscale/FRP 方案。
1.2 原则二:优先原生二进制,其次容器;能不装包就不装
他的优先级是:原生二进制(Native)> 容器(Podman)。原文列的 17 个原生服务都是单二进制或单包,装完 systemctl enable 就完事。
为什么优先原生?
- 省内存:一个 systemd 服务常驻 10
80MB;同功能容器因为要跑 runc + 镜像层,基线开销多 2050MB。他 16GB 内存要跑 28 个服务,这直接决定了他「原生优先」的取舍。 - 省磁盘 + 免 CVE 维护:容器每次重建拉镜像,镜像层几十 MB 到几百 MB;原生包装完就固定,不受上游镜像更新影响。
- 启动快、依赖少:原生服务 systemd 直接拉起,不依赖镜像仓库可达性。
什么时候才用容器? 依赖复杂、组件多的服务(Home Assistant、Immich、Frigate 这类需要一堆依赖库/Python 环境的),原生装容易踩依赖地狱,容器打包好了一切自洽。
1.3 原则三:弃用 Docker,改用 Podman rootless
这是他最有主张的一点。他放弃 Docker 的理由:
- rootless:容器进程以普通用户跑,容器逃逸也拿不到 root。
- systemd 原生集成:用 Quadlet 把容器声明成 systemd unit(
podman generate systemd已弃用),systemctl直接管,体验和原生服务一致。 - 守护进程模型更干净:Podman 是「一次调用即退出」,不需要常驻 dockerd,也就没有那个历史上的 root 等价提权漏洞。
落地要点(后面第 5 章会详细展开):
- 配置放
~/.config/containers/systemd/*.container(Quadlet 格式)。 - 用
systemctl --user管理,配合loginctl enable-linger保证开机自启、不依赖登录会话。
1.4 原则四:监控 + 备份 + 可用性三件套
他不是”装完就算”,而是配了完整可观测性:
- Beszel:轻量监控面板(CPU/内存/磁盘/容器),看”资源趋势”。
- Uptime Kuma:可用性探针(容器),看”服务活着没”。
- Backrest:基于 Restic 的备份 Web UI,看”备份成功没、能不能恢复”。
这三个解决的是不同问题,别混为一谈:
- Beszel 回答”机器怎么样”;
- Uptime Kuma 回答”服务在线吗”;
- Backrest 回答”数据安全吗、能恢复吗”。
1.5 他的取舍哲学(一句话总结)
“只自托管那些’自己搭起来比找现成服务更省心’的东西;凡是’成熟 SaaS 又好又便宜’的,一律不自托管。”
他明确不装的:*arr 全家桶(资源重、易坏)、Collabora(不如 Google Docs)、Firefly III(容器一堆,不如 Actual Budget)、OwnTracks(手机耗电、定位不准)、Email(风险高)。每个都给了替代或放弃理由。做减法比做加法难,这是自托管最值钱的心智。
第 2 章 硬件基线:为什么是 N100 + 16GB
2.1 原文配置与成本
| 硬件 | 型号/规格 | 用途 | 成本(原文) |
|---|---|---|---|
| 迷你主机 | Beelink Mini PC S12 Pro,Intel N100 | 跑全部 28 个服务 | EUR 180 → 后涨到 EUR 359 |
| 内存 | 16GB DDR4 | 主力 | 含在上面 |
| 存储 | 512GB SSD 系统盘 | 根分区 + 容器镜像 | 含在上面 |
| 存储 | 6TB HDD | 媒体库(影视/音乐/有声书) | 额外 |
| 网络 | 依赖路由器(IPv6 + WireGuard) | — | 额外 |
涨价那笔他归因于 “rampocalypse”(Ramp 是美国加密货币借记卡公司破产,导致发币相关硬件/芯片产能被抢),属于供应链黑天鹅,不影响选型逻辑。
2.2 N100 够用吗:算一笔账
Intel N100 是 Alder Lake-N 系列的低功耗入门 U(6W 默认功耗墙,可 turbo 到 ~25W),8 核 8 线程、16GB LPDDR5/双通道 D4、 UHD 核显(支持 AV1/H.265 硬解)。
关键优势正好命中自托管场景:
- 原生 AV1/H.265 硬解:Jellyfin 直接走核显 GPU 转码,CPU 占用极低——这是他能用 N100 跑媒体库的关键。
- 双通道内存 + 硬件单通道 ECC 之外:16GB 内存跑 28 个服务偏紧但可行(他自述用 7.5GB / 16GB,CPU 30~40%)。
- x86_64:和主流教程、镜像兼容性好,不碰 ARM 的 docker 镜像坑。
它不适合什么:
- Frigate(NVR)——原文自己承认 Frigate「immediately pushed it to its limits」。Frigate 吃 GPU(最好 Coral TPU)和大量内存,N100 跑起来吃力,他装了 6TB 硬盘但 NVR 大概率另配设备。
- 重度转码/多路 4K——N100 只能硬解 1~2 路 4K,他自己妥协到媒体统一下 720p 就为了省资源。
2.3 选购建议(原文逻辑的复制)
选一台迷你主机时按这个顺序看:
- CPU 带 AV1/H.265 硬解核显(N100/N305、J4125、锐龙 6xxx G 系列都行)——决定了媒体服务能不能不炸 CPU。
- 内存 ≥16GB,且要双通道——能加内存更好;28 个服务 16GB 是他的实测下限。
- 双网口(可选):想以后拿它做软路由 / 跑 WireGuard 落地、或把 6TB 存储单独挂一台时有用。
- 至少 1 个 M.2 NVMe 槽 + SATA 口——系统/容器镜像放 NVMe(快),媒体放 SATA 大盘(性价比)。
- 功耗 6~15W 待机:常年 7×24 开着,功耗直接乘 8760 小时进电费。N100 这类低功耗 U 是对的选择。
存储规划提醒(原文的关键经验):
- SSD 只放系统 + 容器镜像 + 频繁读写的小文件(Beszel/SQLite 类数据库、Backrest 元数据、Podman 镜像层)。SSD 小、贵,但随机 IO 强。
- HDD 只放媒体流(影视/音乐/有声书)——顺序读、容量优先。原文的 6TB 就是干这个的。
- 绝别把 SQLite 数据库(Beszel/Actual/Gotify 数据)放 HDD——N100 的存储栈扛不住频繁小写。
第 3 章 网络前置:整套方案的地基
原文的方案能跑,前提是他的网络同时满足三个条件:IPv6 直连、路由器能跑 WireGuard、自有域名可 DNS 解析。这一章把这三件事拆开讲,并给可复制命令。
3.1 前提一:IPv6 直连(原文的关键前提)
原文提到他用 IPv6 访问 VPN。这是绕开 CGNAT 的正道:主流运营商的 IPv4 普遍走 CGNAT(Carrier-Grade NAT),你的 IPv4 不是公网 IP,外部主动连不进来;但 IPv6 几乎全球直连。
检测你有没有真 IPv6 / 在不在 CGNAT:
# 1) 查本机有没有全局 IPv6 地址(inet6 且不是 link-local fe80::)
ip -6 addr show scope global
# 2) 查出口 IPv6(会显示你的公网 IPv6)
curl -6 https://ifconfig.co
# 或
dig -6 myip.opendns.com @resolver1.opendns.com +short
# 3) 查出口 IPv4,判断是否 CGNAT(对比是否为私有段 100.64.0.0/10 等)
curl -4 https://ifconfig.co
判读:
- 有
scope global的 IPv6 地址 +curl -6能出公网 IP → 你有原生 IPv6,可以走原文路线。 - 只有 IPv4 且出口 IP 落在
100.64.0.0/10/10.0.0.0/8/192.168.0.0/16→ 你在 CGNAT 后面,原文路线走不通,看第 7 章国内适配方案。
要真公网 IPv6,联系运营商开通,一般免费,说「要公网 IPv6,用于自建服务」即可。部分宽带套餐才给,这一步是整套方案的前提,务必先确认。
3.2 前提二:路由器上跑 WireGuard(唯一公网敞口)
原文让 VPN 跑在路由器上(而不是主机上),好处是:不管主机怎么重装/换机器,VPN 入口都在;同时主机可以只跑内网服务。
最省事:路由器自带 WireGuard。 大多数新路由(OpenWrt、爱快、小米/华硕支持 Mesh 的)后台有 WireGuard 选项,新建一个 Peer(对端)填客户端公钥即可。
进阶:软路由/树莓派上开 WireGuard。 Debian 系:
sudo apt update && sudo apt install wireguard qn-gateway # qn 脚本见下
# 用 wg-easy / qnbwg 更省事;纯手工生成密钥:
wg genkey | tee privatekey | wg pubkey < privatekey
# 写 /etc/wireguard/wg0.conf(见下)
sudo sysctl -w net.ipv4.ip_forward=1
/etc/wireguard/wg0.conf(服务端 = 路由器侧,监听公网端口,示例 51820):
[Interface]
Address = 10.7.0.1/24
ListenPort = 51820
PrivateKey = <服务端私钥>
PostUp = iptables -A FORWARD -i wg0 -j ACCEPT; iptables -t nat -A POSTROUTING -o eth0 -j MASQUERADE
PostDown = iptables -D FORWARD -i wg0 -j ACCEPT; iptables -t nat -D POSTROUTING -o eth0 -j MASQUERADE
[Peer]
# 你的手机/笔记本
PublicKey = <客户端公钥>
AllowedIPs = 10.7.0.2/32
⚠️ AllowedIPs 要配客户端的隧道内网 IP,多设备就多
[Peer]段,每个设备一个公钥。别把 AllowedIPs 写成0.0.0.0/0(那是客户端主动指路用的,服务端侧写了会让流量乱)。
客户端(手机/笔记本)对应 wg0.conf,连上后你就拿到 10.7.0.x,可以直连内网服务了。
3.3 前提三:Caddy 做唯一反代 + 自动 TLS
原文用 Caddy 做反向代理和自动 Let’s Encrypt 证书。Caddy 的杀手锏是:自动申请并续期 HTTPS 证书,配置极简——只要域名指过来、80/443 通,它全自动。
安装 Caddy(Debian/Ubuntu):
sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo apt update && sudo apt install -y caddy
Caddy 配置(/etc/caddy/Caddyfile):
# 全局:邮件用于证书到期告警
{
email you@example.com
}
jellyfin.example.com {
# 反代到内网 jellyfin(监听 8096)
reverse_proxy 10.0.0.10:8096
}
immich.example.com {
reverse_proxy 10.0.0.10:2283
}
# 可以挂基本认证兜一层(VPN 之外的第二道,见下 3.4)
immich.example.com {
basic_auth {
admin $2a$14$xxxx # htpasswd 生成
}
reverse_proxy 10.0.0.10:2283
}
sudo systemctl reload caddy
sudo systemctl status caddy # 确认 active
sudo caddy validate --config /etc/caddy/Caddyfile # 语法自检
证书自动化的前提(很容易翻车):
- 域名 A/AAAA 记录必须已指向这台机器(IPv6 就指 AAAA)。
- 80 和 443 端口从公网可达。若走 VPN 入口,Let’s Encrypt 的 HTTP-01 验证要能打到你的 Caddy——所以做证书时可能要临时把 80 开到公网,或用 DNS-01 验证。
- 若你在 CGNAT 后面(第 7 章),HTTP-01 无法自动完成,需改用 DNS-01(用你的 DNS 服务商 API 签发)。
Caddy 支持 DNS-01 自动签发,只要插件 + API 凭证,例如 Cloudflare:
# 安装 cloudflare DNS 插件版 Caddy(官方提供 xcaddy 构建,见 https://caddyserver.com/docs/automatic-https)
# 配置改为:
# tls {
# dns cloudflare {env.CF_API_TOKEN}
# }
3.4 架构总览:三层纵深防御
原文的实际防线是三层的(自述”三重保障”):
这个纵深思维值得照抄:任一层被突破,后两层仍能拦一道。比如有人扫到你的 Web 服务端口(不该发生),还有认证和应用权限挡着。
3.5 检查网络是否按预期工作
# 1) VPN 未连接时,从手机 4G/5G 访问 jellyfin 域名 → 应该打不开(唯一敞口是 VPN)
# 2) 连上 VPN 后再访问 → 应该正常
# 3) 在内网直接 curl 服务端口 → 通
curl -s -o /dev/null -w "%{http_code}\n" http://10.0.0.10:8096
# 4) 确认没有意外的公网暴露(从外部视角看,只应有 VPN 端口)
# 在内网机器上 ss 监听检查:
ss -tlnp | grep -E "8096|2283|:80|:443"
第 4 章 17 个原生 systemd 服务逐个实操
原文 28 个服务里,17 个用原生 systemd 跑(单二进制/单包),11 个用 Podman 跑(本章讲原生,第 5 章讲 Podman)。
统一约定(后面每个服务都默认遵守):
- 安装用户假设为
selfhost(或你自己的普通用户,不要用 root 跑服务)。 - 二进制装到
/usr/local/bin或用发行版包,数据放~/services/<name>或/srv/<name>。 - 每个服务给出「用途 + 安装 + 配置/运行」,配置项挑关键的讲。
4.1 基础设施三件套
4.1.1 Caddy(反代 + 自动 TLS)
第 3 章已详述,这里只列核心安装。它是所有 Web 服务的唯一对外门面。
# 安装见 3.3;核心:写 /etc/caddy/Caddyfile,reload
sudo systemctl enable --now caddy
4.1.2 Samba(Samba 文件共享)
内网共享媒体目录给 Windows/macOS 客户端。
sudo apt install -y samba samba-common-bin
sudo nano /etc/samba/smb.conf
/etc/samba/smb.conf 关键段:
[media]
path = /srv/media
browseable = yes
read only = no
valid users = @mediausers
create mask = 0664
directory mask = 0775
[global]
workgroup = WORKGROUP
server string = selfhost
# 关掉 SMB1,防 EternalBlue 类攻击
server min protocol = SMB2
map to guest = never
# 建用户组与用户
sudo groupadd mediausers && sudo useradd -G mediausers -M -s /usr/sbin/nologin selfhost
sudo smbpasswd -a selfhost # 设 Samba 密码
# 授权目录(注意 -R 递归 + 归属)
sudo chown -R selfhost:mediausers /srv/media
sudo chmod -R 2775 /srv/media
# 生效
sudo systemctl restart smbd nmb
# 防火墙(内网才开)
sudo ufw allow from 10.0.0.0/24 to any app samba
4.1.3 Cockpit(服务器管理面板)
Web 版服务器控制台(终端、日志、服务、网络、存储)。
# Debian/Ubuntu
sudo apt install cockpit
sudo systemctl enable --now cockpit.socket
sudo ufw allow 9090/tcp # 或仅限内网
访问 https://<内网IP>:9090,用系统用户登录。⚠️ 生产上建议只经 VPN 访问。
4.2 监控与备份三件套
4.2.1 Beszel(轻量资源监控)
比 Grafana + Prometheus 轻得多,专为家用服务器设计(Agent 模式)。
# 1) 建专用用户
sudo adduser --disabled-password --gecos "" beszel
# 2) 官方安装脚本(下载对应架构二进制)
# 通用做法:
cd /tmp
ARCH=$(uname -m) # x86_64 / aarch64
wget https://github.com/henrygd/beszel/releases/latest/download/beszel_0.9_$(echo $ARCH | sed 's/x86_64/x86_64/;s/aarch64/arm64/')_linux_amd64.tar.gz 2>/dev/null || true
📌 实操建议:Beszel 版本迭代快,直接按官方仓库的安装说明走最稳(
curl -sSL https://raw.githubusercontent.com/henrygd/beszel/main/supervisor/install.sh | bash或解压放/usr/local/bin)。核心是两份配置:
- Server(hub):装在你的主机上,收数据。
- Agent:装在被监控的机器上,上报 CPU/内存/磁盘/容器指标。
这里给出 Agent 的 systemd 配置思路:写一个 /etc/systemd/system/beszel-agent.service,ExecStart=/usr/local/bin/beszel-agent,配 KEY 环境变量指向 hub 生成的 key,Restart=always,然后 systemctl enable --now beszel-agent。
4.2.2 Backrest(Restic 备份 Web UI)
给全家桶做定时备份(照片、文档、配置),带 Web 面板看备份历史。
# Backrest 官方提供二进制/容器。用二进制(原生):
cd /tmp
curl -LO https://github.com/garethgeorge/backrest/releases/latest/download/backrest_linux_amd64.tar.gz
tar xzf backrest_linux_amd64.tar.gz
sudo install -m755 backrest /usr/local/bin/backrest
# 数据目录
sudo mkdir -p /var/lib/backrest && sudo chown $USER /var/lib/backrest
# 用 systemd 跑(示例,放 ~/.config/systemd/user/backrest.service)
[Unit]
Description=Backrest backup UI
After=network-online.target
[Service]
ExecStart=/usr/local/bin/backrest serve --data-dir /var/lib/backrest --listen 127.0.0.1:9898
Restart=always
Environment=BACKREST_DATA_DIR=/var/lib/backrest
[Install]
WantedBy=default.target
systemctl --user daemon-reload
systemctl --user enable --now backrest
loginctl enable-linger $USER # 关键:不用登录也常驻
Restic 备份要点:在 Backrest UI 里加 repo(本地盘 / SFTP / S3 / Backblaze),配 plan(路径 + 排除 + 计划 cron)。建议:
- 媒体库(6TB)不必进 Restic(可重新获取、变动低),重点备份的是不可再生的数据:Immich 照片、Vaultwarden 密码库、文档、备份本身。
- 遵循 3-2-1:至少 3 份副本、2 种介质、1 份异地(异地的云端副本)。
4.2.3 Uptime Kuma(服务可用性)
监控你的各个服务”还活着没”,挂了发通知。(原文归在 Podman,第 5 章讲;此处记住它和 Beszel 分工:Beszel 看资源,Kuma 看在线。)
4.3 媒体与影音(原生部分)
4.3.1 Audiobookshelf(有声书服务器)
管理/串流有声书,服务端原生安装。
# 官方提供 deb 包或二进制。二进制方式:
cd /tmp
curl -LO https://github.com/advplyr/audiobookshelf/releases/latest/download/audiobookshelf-linux-x64.deb
sudo dpkg -i audiobookshelf-linux-x64.deb
# 初始化并配置
audiobookshelf --config /home/selfhost/services/abs
sudo systemctl enable --now audiobookshelf # 官方包自带 unit
数据目录(音频、podcast、元数据、用户)都在 --config 指向的目录,把这个目录纳入 Backrest 备份。
4.3.2 MPD(Music Player Daemon + 音乐库)
极轻量的服务端音乐播放器(无状态、纯协议),配合 ncmpcpp/客户端使用。
sudo apt install -y mpd mpd-mpdtag
/etc/mpd.conf 关键配置:
music_directory "/srv/media/music"
playlist_directory "/srv/mpd/playlists"
db_file "/srv/mpd/mpd.db"
state_file "/var/lib/mpd/state"
bind_to_address "127.0.0.1" # 只本机/内网,不公网
port "6600"
audio_output {
type "alsa"
name "My ALSA"
device "hw:0,0"
}
chown -R mpd:mpd /srv/mpd
systemctl restart mpd
4.3.3 Snapcast(多房间音频同步)
把 MPD/任何音频流同步到多个房间设备(树莓派音箱等)。原文用它做全屋音频。
# Snapcast 官方 deb
sudo snapcast-server 2>/dev/null || \
(cd /tmp && curl -LO https://github.com/badaix/snapcast/releases/latest/download/snapserver_0.3x_amd64.deb && sudo dpkg -i snapserver_*.deb)
sudo systemctl enable --now snapserver
# 客户端(每台播放设备):snapclient 连到 snapserver 的 :4953
工作模式:Snapcast server 收一路流,分发给所有 snapclient;客户端(如树莓派)本地播放,实现低延迟同步。
原文明确:为省资源他媒体统一压到 720p,摄像头用低分辨率子码流——这是 N100 + 单机器跑满的取舍。自托管媒体不要追求画质,够看即可。
4.4 阅读 / 知识管理(原生)
4.4.1 FreshRSS(RSS 聚合)
自托管 RSS 阅读器,配合 Fever/Google Reader API 接入。
# 原生:PHP 应用。Debian/Ubuntu:
sudo apt install -y php-cli php-mbstring php-xml php-curl php-sqlite3 nginx
git clone https://github.com/FreshRSS/FreshRSS.git ~/freshrss
# 内置 php -S 即可跑;生产建议配 nginx + php-fpm
cd ~/freshrss && php -S 0.0.0.0:8080 -t ./p/ > /tmp/freshrss.log 2>&1 &
# 做成 systemd 服务托管(示例)
# ~/.config/systemd/user/freshrss.service
[Unit]
Description=FreshRSS
After=network-online.target
[Service]
WorkingDirectory=%h/freshrss
ExecStart=/usr/bin/php -S 127.0.0.1:8080 -t ./p/
Restart=always
[Install]
WantedBy=default.target
4.4.2 Readeck(稍后读)
收集文章链接、稍后阅读、标签整理。
# Readeck 提供 deb/静态包。数据存 PostgreSQL 或 SQLite。
# 二进制 + SQLite 简单方式:
cd /tmp
curl -LO https://github.com/readeck/readeck/releases/latest/download/readeck_linux_amd64.tar.gz
tar xzf readeck_*.tar.gz && sudo install -m755 readeck /usr/local/bin/readeck
# ~/.config/systemd/user/readeck.service
[Unit]
Description=Readeck
[Service]
ExecStart=/usr/local/bin/readeck serve --database sqlite:///var/lib/readeck/readeck.db --listen 127.0.0.1:8010
Environment=READECK_BASE_URL=https://readeck.example.com
Environment=READECK_SECRET_KEY=<改成随机长串>
Restart=always
[Install]
WantedBy=default.target
⚠️ SECRET_KEY 一定要改成随机值。Readeck 官方明确警告:默认密钥会让人猜出你的账户管理权限。
4.4.3 Forgejo(自建 Git,类似 Gitea)
轻量自建 Git 服务(不像 GitLab 重)。
# 官方提供二进制包。Debian:
cd /tmp
curl -LO https://codeberg.org/forgejo/forgejo/releases/download/v1.21/forgejo-1.21.3-0-linux-amd64
sudo install -m755 forgejo-*-linux-amd64 /usr/local/bin/forgejo
# /etc/systemd/system/forgejo.service(系统级)
[Unit]
Description=Forgejo
After=network-online.target
Wants=network-online.target
[Service]
Type=simple
User=git
Group=git
WorkingDirectory=/var/lib/forgejo
ExecStart=/usr/local/bin/forgejo web --config /etc/forgejo/app.ini
Restart=always
RestartSec=5
[Install]
WantedBy=multi-user.target
sudo useradd -r -s /usr/sbin/nologin -d /var/lib/forgejo git
sudo mkdir -p /etc/forgejo /var/lib/forgejo && sudo chown -R git:git /var/lib/forgejo
# 生成 app.ini(DB_TYPE=sqlite3 最省事;DISABLE_REGISTRATION=true 更安全)
sudo -u git forgejo generate secret SECRET_KEY
systemctl enable --now forgejo
安全建议:[server] DISABLE_REGISTRATION = true(自用无需开放注册),或用 ALLOW_ONLY_EXTERNAL_REGISTRATION。数据库个人用 SQLite,多用户才上 Postgres/MySQL。
4.5 同步与下载(原生)
4.5.1 Syncthing(设备间文件同步)
点对点文件同步(类 Dropbox,但自己掌控、去中心化)。
# 官方 deb
curl -LO https://github.com/syncthing/syncthing/releases/download/v1.27/syncthing-amd64.deb
# 或解压官方 tar
cd /tmp && curl -LO https://github.com/syncthing/syncthing/releases/download/v1.27/syncthing-linux-amd64-v1.27.tar.gz
tar xzf syncthing-linux-*.tar.gz
sudo install -m755 syncthing-linux-*/syncthing /usr/local/bin/
sudo useradd -r -m -d /var/lib/syncthing -s /usr/sbin/nologin syncthing
# /etc/systemd/system/syncthing@.service
[Unit]
Description=Syncthing for %i
After=network-online.target
[Service]
User=syncthing
ExecStart=/usr/local/bin/syncthing serve --no-browser --home=/var/lib/syncthing/%i
Restart=always
[Install]
WantedBy=multi-user.target
systemctl enable --now syncthing@syncthing
# Web UI: http://127.0.0.1:8384(设 GUI 密码)
⚠️ 注意 Syncthing 的默认是同步而非备份(会传播删除)。要”版本化备份”需开启 .stversions 文件版本控制。
4.5.2 Transmission Daemon(BT 下载)
sudo apt install -y transmission-daemon
# 配置(先停服务再改,否则会被覆盖)
sudo systemctl stop transmission-daemon
sudo mkdir -p /srv/downloads /var/lib/transmission-daemon/info
sudo chown -R debian-transmission:debian-transmission /srv/downloads /var/lib/transmission-daemon
sudo nano /var/lib/transmission-daemon/settings.json
# 关键项: "download-dir": "/srv/downloads",
# "rpc-authentication-required": true,
# "rpc-whitelist-enabled": true (或关掉并用强密码)
# "rpc-password": <bcrypt 密码>
sudo systemctl start transmission-daemon
Web UI 默认 http://127.0.0.1:9091。⚠️ Transmission RPC 是高危面(曾爆多个远程漏洞),务必限制在内网/VPN 后。
4.5.3 slskd(Soulseek 客户端守护版)
Soulseek(音乐分享网络)的 CLI 客户端,守护进程化便于远程管理。原文用它从 Soulseek 下载音乐(MPD 库或媒体库来源之一)。
# slskd 是 .NET 应用,提供 deb 或二进制。
sudo dpkg -i slskd*.deb # 或解压 tar 到 /usr/local/bin
# 配置目录通常 /var/slskd 或 ~/.local/share/slskd
用 systemd(示例):
[Unit]
Description=slskd
After=network-online.target
[Service]
User=selfhost
ExecStart=/usr/local/bin/slskd --http-port 5030 --https-port 5031 --directory /srv/music
Restart=always
[Install]
WantedBy=default.target
⚠️ Soulseek 的版权灰色性:它主要用于未经授权的音乐共享,作者用来合法地获取自己已购买/可免费分发的资源。使用时请遵守当地版权法,不要用它大规模下载盗版。
4.5.4 Gonic(Soulseek 服务端)
Soulseek 网络的服务端,让你的库可被搜到/下载。原文把它和 slskd 搭配(slskd 下、Gonic 分享出去)。
# Gonic 是 Go 单二进制
cd /tmp
curl -LO https://github.com/sirrobot01/gonic/releases/latest/download/gonic_linux_amd64
sudo install -m755 gonic_linux_amd64 /usr/local/bin/gonic
/etc/gonic.toml:
[music]
path = "/srv/media/music"
[shares]
[shares."0"]
path = "/srv/media/music"
[web]
port = 4747
gonic -c /etc/gonic.toml
# systemd:
# ExecStart=/usr/local/bin/gonic -c /etc/gonic.toml
4.6 通知 / 面板 / 后端(原生)
4.6.1 Gotify(自建推送)
轻量推送服务器(类 ntfy),手机装 Gotify App,服务发 HTTP 就能推到手机。
# Gotify 是单二进制
cd /tmp
curl -LO https://github.com/matrix-org/gotify/releases/download/v2.5.0/gotify_2.5.0_linux_amd64.zip
unzip gotify_*.zip && sudo install -m755 gotify /usr/local/bin/gotify
# 初始化数据库
gotify -configuration gotify.yml migrate
gotify.yml 关键项:
server:
listenaddr: "0.0.0.0:8080"
database:
type: sqlite3
connection: "/var/lib/gotify/gotify.db"
# /etc/systemd/system/gotify.service
[Unit]
Description=Gotify
After=network-online.target
[Service]
User=selfhost
WorkingDirectory=/var/lib/gotify
ExecStart=/usr/local/bin/gotify -configuration /etc/gotify.yml
Restart=always
[Install]
WantedBy=multi-user.target
用法:Gotify 很适合做”家庭自动化中枢”——Uptime Kuma 挂了通知你、Backrest 备份失败通知你、Shell 脚本执行完通知你。全文的 Gotify 应用 token 在 UI 里生成。
4.6.2 Homepage(导航面板)
自托管服务入口页(原文明说它用 Podman,但本质上极轻,本节讲逻辑)。它就是一个 Dashboard,把 28 个服务做成卡片,点进去访问。
(安装见第 5 章 Podman 部分。)
4.6.3 PocketBase(轻量 BaaS)
Go 写的单二进制”后端即服务”(数据库 + Auth + 文件存储 + API),原文用它给 Homepage/小工具做后端。
cd /tmp
curl -LO https://github.com/pocketbase/pocketbase/releases/download/v0.28.4/pocketbase_0.28.4_linux_amd64.zip
unzip pocketbase_*.zip && sudo install -m755 pocketbase /usr/local/bin/pocketbase
# 数据目录(务必放进 Backrest 备份!)
cd /var/lib/pocketbase
pocketbase serve --http=127.0.0.1:8090
# systemd: ExecStart=/usr/local/bin/pocketbase serve --http=127.0.0.1:8090
# 首次打开 Web UI 建管理员账号
⚠️ PocketBase 的 SQLite 文件 pb_data/ 就是全部家当,丢了全丢,务必备份。
第 5 章 Podman + Quadlet:11 个容器服务
原文的 11 个容器服务:Actual Budget、ARM(Automatic Ripping Machine)、Frigate、Home Assistant、Homepage、Immich、Jellyfin、Uptime Kuma、Vaultwarden、Vikunja、Yubal。
5.1 为什么弃用 Docker,改 Podman
| 维度 | Docker | Podman(rootless) | 对自托管的意义 |
|---|---|---|---|
| 权限模型 | 默认 root daemon | 无 daemon,rootless 用户态 | 容器逃逸也拿不到 root;不用给 Docker 组 sudo 等价提权 |
| 常驻进程 | 需要 dockerd 常驻 | 一次调用即退出 | 省一个常驻进程 + 攻击面 |
| systemd 集成 | 需第三方插件(podman generate systemd 已弃用) |
Quadlet 原生 | 容器像原生服务一样被 systemd 管 |
| 兼容性 | — | 命令行刻意兼容 Docker | 迁移基本无痛 |
📌 原文明确点名:
podman generate systemd已经弃用/移除,现在的标准做法是 Quadlet。
5.2 安装 Podman + Quadlet 基础
# Debian/Ubuntu
sudo apt update
sudo apt install -y podman uidmap fuse-overlayfs slirp4netns
# 确认版本 ≥ 4.4(Quadlet 需 4.4+,推荐 5.x)
podman --version
# 5.x 建议开启 Quadlet(Debian 12+ 默认开;Debian 11 需手动)
sudo systemctl enable --now podman.socket # 提供 /run/podman/podman.sock 给工具
rootless 用户的前置条件:用普通用户(非 root)运行,Podman 会自动走 rootless。
# 验证 rootless 可用
podman info | grep -i "rootless"
# 确保 subuid/subgid 已配(通常装包时已自动加)
grep selfhost /etc/subuid /etc/subgid
# 没有就补:
sudo usermod --add-subuids 100000-165535 --add-subgids 100000-165535 selfhost
5.3 Quadlet 机制详解(核心)
Quadlet 是 Podman 4.4+ 内置的特性:你把一个 .container 文件丢进 Quadlet 目录,systemctl --user daemon-reload 后,Podman 会自动生成一个同名 .service,之后 systemctl --user start xxx 就像管原生服务一样。
目录:
- 用户级(rootless,推荐):
~/.config/containers/systemd/→ 生成systemctl --user单元。 - 系统级:
/etc/containers/systemd/→systemctl(系统)单元。
启用 Quadlet(Debian/Ubuntu 用户级):
mkdir -p ~/.config/containers/systemd
# Debian 12/Ubuntu 22.04+ 一般默认开;若没有:
grep -n Quadlet /usr/lib/systemd/user-generators/podman-system-generator 2>/dev/null || true
# 确保 podman 版本足够新(Quadlet 稳定于 5.x)
一个 Quadlet .container 文件长这样(以 Jellyfin 为例):
# ~/.config/containers/systemd/jellyfin.container
[Unit]
Description=Jellyfin Media Server
After=network-online.target
Wants=network-online.target
[Container]
Image=docker.io/jellyfin/jellyfin:latest
ContainerName=jellyfin
# 端口:hostPort:containerPort
PublishPort=8096:8096
# 卷:hostPath:containerPath[:options]
Volume=/srv/jellyfin/config:/config:Z
Volume=/srv/media:/media:ro
# 环境变量
Environment=TZ=Asia/Shanghai
Environment=JELLYFIN_PublishedServerUrl=https://jellyfin.example.com
[Service]
Restart=always
RestartSec=10
# 可选:资源限制、额外能力等在这里加
[Install]
WantedBy=default.target
加载并启动:
systemctl --user daemon-reload # 触发 Quadlet 生成 jellyfin.service
systemctl --user enable --now jellyfin.service
systemctl --user status jellyfin
journalctl --user -u jellyfin -f # 看日志
# ⭐ 关键一步:允许用户服务在未登录时也常驻
sudo loginctl enable-linger $USER
⚠️
loginctl enable-linger一定要做,否则你退出 SSH 后systemctl --user的服务会被杀掉,重启机器后也不会自动起。
[Container] 常用指令速查:
| 指令 | 作用 | 例子 |
|---|---|---|
Image |
镜像 | docker.io/jellyfin/jellyfin:latest |
ContainerName |
容器名 | jellyfin |
PublishPort |
端口映射 | 8096:8096、127.0.0.1:8096:8096(只绑本地) |
Volume |
卷挂载 | /srv/media:/media:ro(:ro 只读,:Z SELinux) |
Environment |
环境变量 | TZ=Asia/Shanghai |
User |
容器内以何用户跑 | User=1000:1000 |
AddDevice |
透传设备 | AddDevice=/dev/dri:/dev/dri |
Device |
同上(旧名) | Frigate 用它接 GPU |
SecurityLabelDisable |
关 SELinux 标签 | 需要时 |
:Z / :z 说明:SELinux 系统(Fedora/RHEL/部分 Debian)需要给卷加标签;Debian/Ubuntu 用 AppArmor,一般写 :Z 也不冲突;纯只读挂载建议 :ro,既安全又让 Jellyfin/Immich 之类不会误写源盘。
5.4 逐个服务的 Quadlet 配置
下面给出每个容器的 .container 模板。公共前提:
mkdir -p /srv/{immich,jellyfin,uptime,vaultwarden,home-assistant,homepage,actual,frigate,vikunja,arm,yubal}
mkdir -p ~/.config/containers/systemd
# 数据目录属主对齐容器内用户
5.4.1 Jellyfin(媒体库)
# jellyfin.container
[Unit]
Description=Jellyfin
After=network-online.target
[Container]
Image=docker.io/jellyfin/jellyfin:latest
ContainerName=jellyfin
PublishPort=8096:8096
Volume=/srv/jellyfin/config:/config:Z
Volume=/srv/media/movies:/data/movies:ro
Volume=/srv/media/tv:/data/tv:ro
# GPU 硬解透传(利用 N100 核显,关键!)
AddDevice=/dev/dri:/dev/dri
Environment=TZ=Asia/Shanghai
# 硬件加速
Environment=JELLYFIN_HardwareAccelerationType=intel
[Service]
Restart=always
[Install]
WantedBy=default.target
5.4.2 Immich(照片管理)
# immich.container —— Immich 官方是 docker-compose,但也能用 Quadlet 单容器跑
[Unit]
Description=Immich
After=network-online.target
[Container]
Image=docker.io/ghcr.io/immich-app/immich-server:latest
ContainerName=immich
PublishPort=2283:2283
Volume=/srv/immich/config:/usr/src/app/upload:Z
Environment=TZ=Asia/Shanghai
Environment=IMMICH_PORT=2283
[Service]
Restart=always
[Install]
WantedBy=default.target
📌 Immich 官方推荐 compose(app + postgres + redis)。若要完整依赖,用 compose 文件也行,但原文坚持统一 Quadlet。建议:Immich 是”数据最重要”的服务(照片不可再生),它的 Postgres/Redis 数据目录一定要进 Backrest 备份。
5.4.3 Home Assistant(智能家居)
# home-assistant.container
[Unit]
Description=Home Assistant
After=network-online.target
[Container]
Image=docker.io/homeassistant/home-assistant:stable
ContainerName=hassio
PublishPort=8123:8123
Volume=/srv/home-assistant:/config:Z
Volume=/run/dbus:/run/dbus:ro
Environment=TZ=Asia/Shanghai
[Service]
Restart=always
[Install]
WantedBy=default.target
⚠️ Home Assistant 对 /dev/dbus、蓝牙/Zigbee 直连有需求。上面挂 dbus 是常见做法;深度集成可能还要透传 /dev/serial 或 USB dongle。
5.4.4 Uptime Kuma(可用性监控)
# uptime-kuma.container
[Unit]
Description=Uptime Kuma
After=network-online.target
[Container]
Image=louislam/uptime-kuma:1
ContainerName=uptime-kuma
PublishPort=3001:3001
Volume=/srv/uptime/data:/app/data:Z
Environment=PORT=3001
Environment=TZ=Asia/Shanghai
[Service]
Restart=always
[Install]
WantedBy=default.target
5.4.5 Vaultwarden(密码库)
# vaultwarden.container —— ⚠️ Bitwarden 的轻量实现,最敏感的密码库
[Unit]
Description=Vaultwarden
After=network-online.target
[Container]
Image=docker.io/vaultwarden/server:latest
ContainerName=vaultwarden
PublishPort=127.0.0.1:8080:80 # 只绑本地,由 Caddy 反代
Volume=/srv/vaultwarden/data:/data:Z
Environment=DOMAIN=https://vault.example.com
Environment=ROCKET_PORT=80
Environment=SIGNUPS_ALLOWED=false # 关键:禁掉注册,防被薅
Environment=TZ=Asia/Shanghai
# 反代后拿到真实 IP(Cloudflare Tunnel/反代时必配)
Environment=ROCKET_TRUSTED_PROXIES=10.0.0.0/8,172.17.0.0/16
[Service]
Restart=always
[Install]
WantedBy=default.target
🔒 Vaultwarden 铁律:
SIGNUPS_ALLOWED=false(注册完立刻关,否则任何知道域名的人都能注册)。- 一定经 Caddy 反代 + HTTPS,不要裸奔 80。
/srv/vaultwarden/data是你全部密码,必须进 Backrest,且备份要加密异地。
5.4.6 Frigate(NVR 摄像头)
# frigate.container —— 全文最吃资源的容器,原文说它"immediately pushed to limits"
[Unit]
Description=Frigate NVR
[Container]
Image=docker.io/blakeblackshear/frigate:latest
ContainerName=frigate
PublishPort=5000:5000
PublishPort=8554:8554
PublishPort=1984:1984
Volume=/srv/frigate/config:/config:Z
Volume=/srv/frigate/media:/media
AddDevice=/dev/dri:/dev/dri # Intel 核显解码
AddDevice=/dev/bus/usb:/dev/bus/usb # Coral TPU / USB 摄像头
Environment=TZ=Asia/Shanghai
[Service]
Restart=always
TimeoutStartSec=300
[Install]
WantedBy=default.target
⚠️ Frigate 要 Intel 核显(VAAPI)+ 摄像头 RTSP 流,且吃内存/CPU 很重。在 N100 + 16GB 上要克制:摄像头数量控制在 2~4 路、分辨率用子码流(sub-stream)。这正是原文说的”用低分辨率子码流省资源”。
5.4.7 Actual Budget(个人财务)
# actual-budget.container
[Unit]
Description=Actual Budget
[Container]
Image=actualbudget/actual-server:latest
ContainerName=actual
PublishPort=5006:5006
Volume=/srv/actual/data:/appdata:Z
Environment=ACTUAL_PORT=5006
Environment=ACTUAL_HOSTNAME=0.0.0.0
Environment=TZ=Asia/Shanghai
[Service]
Restart=always
[Install]
WantedBy=default.target
原文用它替代 Firefly III(后者容器太多)。单容器、无外部 DB,最省心。
5.4.8 Homepage(服务导航面板)
# homepage.container
[Unit]
Description=Homepage Dashboard
[Container]
Image=gethomepage/homepage:latest
ContainerName=homepage
PublishPort=3000:3000
Volume=/srv/homepage/config:/app/config:Z
Volume=/var/run/docker.sock:/var/run/docker.sock:ro # 显示容器状态(可选)
Environment=HOMEPAGE_ALLOWED_HOSTS=vinceconsole.fyi,localhost
[Service]
Restart=always
[Install]
WantedBy=default.target
Homepage 里用一个
services.yaml定义所有卡片(这是它连接 28 个服务的”总目录”)。把本书提到的服务都做成卡片,点即达。
5.4.9 ARM(Automatic Ripping Machine,光驱自动刻录)
# arm.container —— CD/DVD 自动抓轨(ripping)
[Unit]
Description=Automatic Ripping Machine
[Container]
Image=ghcr.io/hejalsy/arm:latest
ContainerName=arm
PublishPort=8080:8080
PublishPort=7900:7900
Volume=/srv/arm/config:/config:Z
Volume=/srv/arm/music:/music
Volume=/srv/arm/video:/video
AddDevice=/dev/sr0:/dev/sr0 # 光驱
AddDevice=/dev/bus/usb:/dev/bus/usb
Environment=CONFIGSTRING=y:raw
Environment=TZ=Asia/Shanghai
[Service]
Restart=always
[Install]
WantedBy=default.target
ARM 用来把实体 CD ripping 成音乐/视频入库(喂给 MPD/Snapcast)。无光驱可忽略。
5.4.10 Vikunja(待办 / Todo)
# vikunja.container
[Unit]
Description=Vikunja Todo
[Container]
Image=docker.io/go-vikunja/vikunja:latest
ContainerName=vikunja
PublishPort=3456:3456
Volume=/srv/vikunja/data:/app/data:Z
Environment=VIKUNJA_SERVICE_URL=https://todo.example.com
Environment=TZ=Asia/Shanghai
[Service]
Restart=always
[Install]
WantedBy=default.target
5.4.11 Yubal(可选)
原文列表里还有 Yubal(用量/余额聚合看板),同样用容器。模板:
# yubal.container
[Unit]
Description=Yubal
[Container]
Image=<yubal-official-image>:latest # 按其文档填实际镜像
ContainerName=yubal
PublishPort=8091:8091
Volume=/srv/yubal:/data:Z
[Service]
Restart=always
[Install]
WantedBy=default.target
5.5 Quadlet 一键批量加载
cd ~/.config/containers/systemd/
systemctl --user daemon-reload
# 批量启动所有 *.container 对应的服务
for svc in jellyfin immich hassio uptime-kuma vaultwarden frigate actual homepage vikunja; do
systemctl --user enable --now "$svc.service"
done
# 查看所有用户服务
systemctl --user list-units --type=service | grep -E "jellyfin|immich|..."
排查三板斧:
systemctl --user status <svc> # 状态/最近错误
journalctl --user -u <svc> -n 100 # 容器日志
podman ps -a # 容器层面状态(rootless 你的用户)
podman logs <containerName> # 容器 stdout/stderr
第 6 章 明确「不自托管」的服务及替代方案
原文最有价值的部分之一是他明确不装的东西——每个都给了理由。做减法比做加法难,这是自托管最值钱的心智。
| 不自托管的服务 | 原文理由 | 替代方案 |
|---|---|---|
| *arr 全家桶(Sonarr/Lidarr/Radarr) | 资源占用大、容易坏、依赖链复杂 | Jellyfin + 手动整理;或用「整理册」自动化脚本轻量替代 |
| Collabora Online | Google Docs 更好用,没必要自建 | Google Docs / Microsoft 365;本地用 LibreOffice |
| Firefly III | 容器太多太重 | Actual Budget(单容器,替代方案更简单) |
| OwnTracks | 手机耗电、定位不准 | 放弃精确轨迹;需要的话用别的方案 |
| Dawarich(照片轨迹) | 要 4+ 个容器,太重 | 放弃;或直接用 Immich 的定位功能 |
| Music Assistant | “什么都要自己管”太折腾 | MPD + Snapcast(更简单直接) |
| Email 服务器 | 安全风险太高(配置反垃圾/DKIM 等极易踩坑) | 用 Gmail/Outlook/ProtonMail 等托管邮箱 |
这张表的通用判据(可复用到任何服务):
一句话:「要么 SaaS 搞定,要么用最简工具替代,要么容器跑,实在不值得就别装。」
第 7 章 中国大陆网络适配(重点)
这是原文默认成立、但国内会翻车的部分。原文的网络前提(公网 IPv6 + 域名直连 + 80/443 可达)在国内大多不满足。逐条给出国内可行的改法。
7.1 国内三大网络障碍
| 障碍 | 说明 | 原文假设 | 国内现实 |
|---|---|---|---|
| CGNAT(IPv4) | 运营商不给公网 IPv4 | 用 IPv6 绕过 | 家宽大多仍无公网 IPv4,且很多地区连公网 IPv6 也难配 |
| 域名备案 | 用国内服务器对外提供服务需备案 | 无需(用海外/自有 IP) | 云服务器建站要备案(否则 80/443 被拦) |
| 80/443 端口 | HTTP/HTTPS 标准端口 | 直接可用 | 国内云主机未备案不能开 80/443;家宽端口可能被封 |
7.2 方案一(推荐):Tailscale / WireGuard 组网
思路:不把任何服务暴露公网,只在设备间组加密网——这恰好就是原文原则一在国内的等价实现,而且不需要公网 IP。
# 服务器(你的迷你主机)装 Tailscale
curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up --advertise-routes=192.168.1.0/24 --accept-dns=false
# 手机/笔记本装 Tailscale 客户端,登同一账号
好处:
- 天然打洞,不需要公网 IPv4/IPv6、不需要端口映射、不需要备案。
- 你的所有服务只监听内网,只有装了 Tailscale 的设备能访问。
- 免费版 100 设备,家用绰绰有余。
国内注意:Tailscale 有国内直连但偶尔不稳,可搭配 自建 Headscale + DERP,或用 WireGuard + 一台便宜的海外 VPS 做中转(见 7.3)。
7.3 方案二:VPS 中转 + FRP(放弃家宽直连)
思路:既然家宽出不去,就在一台便宜的海外/国内 VPS 上跑中转,家里的机器主动连出去。
- 家宽 → VPS:家宽主动向 VPS 建隧道(无需入站)。
- 外部访问:用户先连 VPS,再经隧道回家里的服务。
- 工具:FRP(国内生态好,文档多)或 rathole(更轻)。
FRP 服务端(VPS 上)frps.toml:
bindPort = 7000
auth.method = "token"
auth.token = "<改成随机长串>"
家宽机器上的客户端 frpc.toml(家用服务仍只监听本地):
serverAddr = "<你的VPS_IP>"
serverPort = 7000
auth.token = "<同一个token>"
[[proxies]]
name = "jellyfin"
type = "tcp"
localIP = "127.0.0.1"
localPort = 8096
remotePort = 18096 # 外部访问 VPS:18096
./frpc -c frpc.toml # 用 systemd 托管
VPS 怎么选:
- 要低延迟 + 便宜:Vultr / Hetzner / Oracle 免费层(海外,走 FRP 回国)。
- 要免备案直连国内云:只能备案后用国内轻量服务器。
7.4 方案三:Cloudflare Tunnel(零公网 IP + 免备案)
如果你的服务都是 HTTP(S),Cloudflare Tunnel 最省事:家里机器主动连 Cloudflare,Cloudflare 给你一个公网 HTTPS 域名,不需要公网 IP、不需要备案(域名解析在 Cloudflare)。
# 家里机器
docker run cloudflare/cloudflared:latest tunnel run
# 或 Podman 同理;之后在 Cloudflare 后台把子域名指向 tunnel,
# 服务本身用 localhost:port,cloudflared 负责反代到公网 HTTPS
⚠️ 取舍:Cloudflare Tunnel 把入口交给 Cloudflare(国内访问质量/合规性需自行评估),且失去了”仅 VPN 可达”的隔离——务必配合各服务的强认证(Vaultwarden 关注册、Caddy 加 basic auth)。
7.5 域名与证书(国内适配)
- 域名:
.com/.net可在 Cloudflare/DNSPod 免费解析并托管到 Cloudflare,方便用 DNS-01 签证书。 - 证书:国内云(阿里/腾讯)有免费 DV 证书;或统一用 Caddy + DNS-01 自动签。
- 备案:只有把服务开在中国大陆云服务器且用域名对外时才强制备案。家宽 + Tailscale/FRP 到海外 VPS,通常无需在国内备案(FRP 中转的海外 VPS 按当地法规)。
7.6 国内选型小结(可直接照做)
第 8 章 资源规划与容量估算
8.1 原文实测资源
| 指标 | 实测值 |
|---|---|
| 内存 | 16GB 中约 7.5GB 已用 |
| CPU | 30~40% 常态(空载轻量服务) |
| 系统盘 | 512GB SSD |
| 媒体盘 | 6TB HDD |
注意:这是不含 Frigate(NVR)的常态占用;Frigate 一开,CPU/内存会显著上升。原文也承认 Frigate 是瓶颈。
8.2 各服务内存粗估(规划用)
| 服务 | 容器/原生 | 典型内存 | 备注 |
|---|---|---|---|
| Caddy | 原生 | ~20MB | 极轻 |
| Samba | 原生 | ~50MB | 取决共享数 |
| Cockpit | 原生 | ~80MB+ | Web 面板 |
| Beszel | 原生 | ~30MB | 轻 |
| Backrest | 原生 | ~50MB | 备份时才高 |
| Uptime Kuma | Podman | ~150MB | Node |
| Jellyfin | Podman | ~300MB+ | 转码时飙升 |
| Immich | Podman | ~500MB+ | 含 DB/redis 更多 |
| Home Assistant | Podman | ~300MB+ | 集成多则涨 |
| Vaultwarden | Podman | ~30MB | 极轻量 |
| Frigate | Podman | 1~2GB+ | 最重,需 GPU |
| Actual / Vikunja / Gonic | 混合 | 各 |
轻 |
规划公式:总内存 ≈ Σ常态内存 × 1.5(留转码/备份峰值余量)。16GB 跑 28 个轻服务 + 少量媒体是可行的;加 Frigate 前要三思。
8.3 磁盘容量估算
| 用途 | 建议位置 | 估算 |
|---|---|---|
| 系统 + Podman 镜像 + SQLite(Beszel/Actual/Backrest/Gotify/PocketBase 数据) | SSD | 512GB 足够 |
| 媒体库(影视/音乐/有声书) | HDD | 按码率估算:720p 约 1~1.5GB/集;无损音乐 FLAC ~1GB/张 |
| Immich 照片库(不可再生) | HDD/SSD + 独立备份 | 手机照片很多年可到 1~2TB |
| 备份暂存 | SSD 或另一块盘 | 与被备份量同级 |
🔒 唯一必须”多份 + 异地”备份的:Immich 照片、Vaultwarden 密码库、Gonic 音乐库元数据、Homepage/Forgejo 配置。媒体电影丢了可以再下,照片和密码丢了找不回。
8.4 省资源的两条原文经验(值得直接抄)
- 媒体统一 720p:不追求 1080p/4K,媒体服务器 CPU/带宽压力骤降。
- 摄像头用低分辨率子码流:Frigate 调检测用子码流(sub-stream),录原码流,降 CPU 和存储。
第 9 章 验收清单与常见故障
9.1 上线逐条验收
# 1) 所有服务状态
systemctl --user list-units --type=service --state=running | grep -E "jellyfin|immich|homepage|vaultwarden|uptime|actual"
systemctl --user list-timers # 定时任务(若有)
# 2) 没有意外公网暴露(只应有 VPN/Tailscale 相关端口)
ss -tlnp | grep LISTEN | awk '{print $4}' | sort -u
# 内网正常项:127.0.0.1:* 和 10.0.0.*:*
# 出现 0.0.0.0:某陌生端口 → 排查
# 3) linger 已开(保证开机自启)
loginctl show-user $USER | grep Linger # 期望 Linger=yes
# 4) 备份可恢复性验证(最重要,别只备不测!)
# 在 Backrest 里选一个 repo,跑一次 restore 测试,能还原出文件才算数
9.2 常见故障速查
| 现象 | 常见原因 | 处理 |
|---|---|---|
容器起不来 / exit code |
镜像拉不动 / 端口占用 / 权限 | podman ps -a、podman logs <c>、journalctl --user -u <svc> |
| systemd 服务重启循环 | 配置语法错 / 依赖 DB 未起 | 看 status 里 Last Log |
| 退出 SSH 后服务被杀 | 没开 linger | sudo loginctl enable-linger $USER |
| Jellyfin 不转码 / 卡 | 核显未透传 | 检查 AddDevice=/dev/dri、HA 类型=intel |
| Caddy 证书签发失败 | 80/443 不通 / DNS 未生效 / 非 HTTP-01 可达 | 改 DNS-01;检查 AAAA 与防火墙 |
| 远程访问打不开 | 未连 VPN / 防火墙拦 / 只绑 127.0.0.1 | 从内网 curl;确认 ss 绑定地址 |
| Frigate 重启 / OOM | 内存不足 / GPU 未透传 | 降摄像头数与分辨率、确认 /dev/dri |
| 数据”丢了” | SQLite 在 HDD / 没备份 | 恢复 Backrest 备份;把 DB 移到 SSD |
| Backrest 备份失败 | 路径不存在 / 权限 / 磁盘满 | 看 Backrest 日志;df -h 查空间 |
9.3 一句话验收标准
第 10 章 服务能力全景:搭完之后你到底得到了什么
前面 9 章讲的是「怎么装」。这一章反过来讲:装完之后,你的生活里多了哪些能力。
这是自托管最容易被忽视的一环。装完 28 个服务,如果只是「端口开了」,那只是自嗨;只有把它们组合成日常可用的工作流,这套东西才真正产生价值。
10.1 从「服务清单」到「能力清单」
原文是按技术栈列的(17 个 systemd + 11 个 Podman)。但用户感知到的不是 systemd 和 Podman,而是能力。同一批服务重组后是 9 大能力域:
10.2 九大能力域逐个拆解
每条能力我按 「能干什么 → 谁在用 → 依赖哪些服务 → 日常怎么用」 四个维度说明。
10.2.1 影音娱乐域
| 服务 | 提供的能力 | 使用者 | 依赖 |
|---|---|---|---|
| Jellyfin | 自建影视/剧集/动漫库,手机/电视/网页多端播放,自动刮削元数据、生成缩略图、追剧进度多端同步 | 全家 | Caddy + GPU 透传 + 媒体库 |
| Audiobookshelf | 有声书管理与串流,支持多播客源、章节、进度同步、书签 | 本人 | Caddy + 有声书文件 |
| MPD + Snapcast | 无状态音乐播放服务;Snapcast 把一路音频同步到全屋音箱(手机/树莓派/PC) | 全家 | MPD 音乐库 + 多个客户端 |
| ARM | 把实体 CD/DVD 自动抓轨成 FLAC/MP3,直接入库(喂给 MPD) | 本人 | 光驱 + 音乐库 |
能力闭环:
CD/DVD ──ARM 抓轨──▶ 音乐库 ──MPD 播放──▶ Snapcast 分发 ──▶ 全屋音箱
└──▶ 有声书 ──▶ Audiobookshelf ──▶ 手机
└──▶ 影视 ──▶ Jellyfin ──▶ 电视/手机
日常用法:
- 电视端装 Jellyfin 官方 TV 客户端,登录后选库。
- 手机端用 Jellyfin / Audiobookshelf App。
- 音乐用任意 MPD 客户端(如 ncmpcpp、客户端 App),或直接用 Snapcast 客户端指定房间。
⚠️ 媒体版权:只处理你自有或已获授权的内容。原文的 *arr 之所以被砍掉,一部分原因就是它容易滑向盗版抓取。
10.2.2 照片与记忆域
| 服务 | 提供的能力 | 依赖 |
|---|---|---|
| Immich | 手机照片自动备份(类似 iCloud/Google Photos)、时间轴浏览、人脸/地点识别、地图视图、多端分享 | 手机 App + 备份策略 |
| Home Assistant | 统一接入智能家居设备(灯、插座、传感器、摄像头),做自动化联动、地理围栏、场景 | 设备接入(Zigbee/WiFi) |
关键工作流(”自动”是核心价值):
这是最值得投入的域:Immich 的自动备份能真正防止「手机丢了照片没了」——而这正是 Backrest 存在的主要理由之一(照片不可再生)。
10.2.3 文件与同步域
| 服务 | 提供的能力 | 典型场景 |
|---|---|---|
| Syncthing | 点对点自动同步,多设备间文件实时互备,不经过云端 | 笔记本 ↔ 台式机 ↔ NAS 保持同一份工作目录 |
| Samba | 局域网 SMB 共享,Windows/macOS 挂载成本地磁盘 | 媒体库、老电影、临时交换区 |
| Transmission | BT 下载(做种/下载),支持 RSS 订阅自动下载 | 追剧种子、公开数据集 |
| Gonic + slskd | Soulseek 网络:slskd 下载、Gonic 把你的音乐库分享出去 | 音乐爱好者的内容交换 |
| Backrest(容器版能力) | 快照式备份 | 见 10.2.7 |
注意 Syncthing ≠ 备份:它是同步,删除会传播。真要防误删,务必开 .stversions 版本控制,或用 Backrest 做独立备份。
10.2.4 密码与身份域
| 服务 | 提供的能力 | 重要性 |
|---|---|---|
| Vaultwarden | Bitwarden 兼容的密码库:密码自动填充、跨设备同步、TOTP 二次验证、自建端到端加密 | 🔴 全家最该自托管的服务 |
| Forgejo | 私有 Git 托管:代码、配置、笔记的版本化存储,带 Web UI / Issue / Wiki | 中高 |
| PocketBase | 轻量 BaaS:给 Homepage、家庭自动化、小工具提供数据库 + Auth + 文件存储 | 基础设施级 |
为什么 Vaultwarden 是第一优先级:
- 用别人的密码库 = 把全家密码交给第三方(哪怕他们说端到端加密)。
- 自建后密码库文件在你自己手上(
/srv/vaultwarden/data)。 - 配合 Backrest 异地加密备份,做到”服务挂了也能恢复密码”——这是自托管密码库唯一真正的风险点。
🔒 务必做的三件事:① 首次注册后立即
SIGNUPS_ALLOWED=false;② 强主密码(这是唯一的解密钥匙,服务器上没有);③data目录进 Backrest 且异地 + 加密。
10.2.5 信息与任务域
| 服务 | 提供的能力 |
|---|---|
| FreshRSS | RSS 聚合,把 100+ 信息源收敛成一个阅读器,配合 Fever API 接入手机阅读 App |
| Readeck | 「稍后读」:网页文章存下来打标签,跨设备阅读,可导出 |
| Vikunja | 待办 / 任务管理:看板视图、多人协作、到期提醒、重复任务 |
| Actual Budget | 个人/家庭记账:规则化分类、预算、报表,纯本地数据不外传 |
这套组合的隐藏价值:把「信息洪水」变成一个入口。FreshRSS 收 → Readeck 存 → Vikunja 变成行动项 → Homepage 统一看。
10.2.6 监控与告警域
| 服务 | 提供的能力 | 回答什么问题 |
|---|---|---|
| Beszel | 主机与容器的 CPU / 内存 / 磁盘 / 网络 / 容器状态,带历史曲线与告警 | 「机器健康吗?趋势如何?」 |
| Uptime Kuma | HTTP/TCP/ICMP 探针,从外部视角监控每个服务,宕机即通知 | 「服务还在线吗?」 |
| Gotify | 推送中枢:任意服务/脚本都能 HTTP POST 一条消息到手机 | 「有事发生,怎么第一时间知道?」 |
| Homepage | 所有服务的可视化入口面板,显示每个服务的在线状态 | 「我现在该点哪个?」 |
告警闭环(这三者如何协同):
这是整套方案里投入产出比最高的部分:14 个服务的根因,往往就是「磁盘满了」「内存 OOM」「证书过期」「上游依赖挂了」这四类。
10.2.7 数据与容灾域
| 服务 | 提供的能力 |
|---|---|
| Backrest | 基于 Restic 的备份:本地 / SFTP / S3 / B2 多种后端,计划任务、快照浏览、一键恢复、Web UI |
| Cockpit | 服务器管理面板:终端、日志、服务启停、磁盘、网络、防火墙、用户管理 |
Backrest 的定位要拎清:
- 它不是同步,是快照备份——带时间点,可以恢复到任意历史版本。
- 不可再生的数据必须进来:Immich 照片、Vaultwarden 密码库、Forgejo 代码、Gotify/Backrest 自身配置、Readeck 收藏。
- 可再生的不用进:电影、音乐(重新下载)、apt 缓存。
10.2.8 基础设施域
| 服务 | 提供的能力 |
|---|---|
| Caddy | 唯一反向代理入口:自动 TLS 证书、HTTP/3、路径路由、Basic Auth、可选的访问日志 |
| Cockpit | 系统级管理(见上) |
基础设施域是「隐身的服务」:用户永远看不到它,但所有 Web 服务都靠它才有 HTTPS 和统一入口。Caddy 挂掉 = 所有 Web 服务对外不可达(内网直连 IP 仍可),所以它的可用性优先级最高。
10.3 五个端到端场景(服务如何串起来)
场景比单个服务更能说明价值。
场景 A:出门在外访问家里的一切
场景 B:照片自动备份 + 异地容灾
场景 C:服务挂了 60 秒内知道并修好
场景 D:新人/家人怎么用(零门槛)
场景 E:一条命令发通知
# 任何脚本执行完都能推到你手机
curl -s -X POST "http://127.0.0.1:8080/message?token=<你的AppToken>" -H "Title: 备份完成" -d "Backrest 增量备份完成,耗时 3m12s"
10.4 三个角色看到的不同东西
| 角色 | 主要入口 | 关心什么 | 典型操作 |
|---|---|---|---|
| 家人 / 非技术用户 | Homepage、Jellyfin App、Vaultwarden App | 服务能不能用、别让我折腾 | 点开即用,不碰配置 |
| 你(运维者) | SSH、Cockpit、Beszel、Uptime Kuma | 谁挂了、为什么、资源够不够 | 看监控 → 定位 → 重启 |
| 开发者 / 写代码的 | Forgejo、Readeck、FreshRSS | 代码与知识的版本管理 | push 代码、收订阅、做笔记 |
设计含义:Homepage 的存在不是为了好看,而是为了让非技术用户有唯一入口。否则你会被”这个服务怎么访问”的问题淹没。
10.5 能力到服务的映射总表(速查)
| 能力 | 核心服务 | 辅助服务 | 对外入口 |
|---|---|---|---|
| 看影视 | Jellyfin | Backrest, Caddy | jellyfin.域名 |
| 听有声书 | Audiobookshelf | Caddy | abs.域名 |
| 全屋音乐 | MPD + Snapcast | ARM, Gonic | 客户端直连 |
| 管照片 | Immich | Backrest | immich.域名 |
| 智能家居 | Home Assistant | PocketBase, Gotify | ha.域名 |
| 多设备文件同步 | Syncthing | Backrest | 客户端直连 |
| 局域网共享 | Samba | — | smb://内网IP |
| 下种子 | Transmission | — | transmission.域名 |
| 存密码 | Vaultwarden | Backrest | vault.域名 |
| 存代码 | Forgejo | Backrest | git.域名 |
| 读订阅 | FreshRSS | Readeck | rss.域名 |
| 稍后读 | Readeck | FreshRSS | readeck.域名 |
| 管任务 | Vikunja | Gotify | todo.域名 |
| 记流水 | Actual Budget | Backrest | budget.域名 |
| 看监控 | Beszel | Homepage | beszel.域名 |
| 收告警 | Uptime Kuma + Gotify | — | 手机推送 |
| 统一入口 | Homepage | — | home.域名 |
| 备份恢复 | Backrest | — | backrest.域名 |
| 管服务器 | Cockpit | — | cockpit.域名 |
第 11 章 运维手册:搭完之后怎么养
自托管真正的成本不在搭建,在运维。 原文花了大量篇幅讲「装什么」,但没讲「怎么养」——而这恰恰是大多数自托管项目烂尾的原因:服务挂了没人管、磁盘满了没发现、证书过期访问不了、备份从没验证过。
这一章给出可长期执行的运维体系。
11.1 运维的三个层次
关键认知:这三层缺一层,自托管就会退化。
- 没有观测 → 你只能等用户投诉才知道坏了(最糟的运维模式)。
- 没有控制 → 知道坏了但改不动,只能重装。
- 没有恢复 → 知道坏了也修不好,只能重买硬件(最贵的失败)。
11.2 日常巡检:日 / 周 / 月 / 季
不要天天手工查 28 个服务。把巡检做成固定节奏 + 自动化脚本。
| 频率 | 检查项 | 命令 / 入口 | 触发动作 |
|---|---|---|---|
| 每日(自动) | 服务在线状态 | Uptime Kuma 探针 | 挂了 → Gotify 推你 |
| 每日(自动) | 备份是否成功 | Backrest 计划任务 | 失败 → Gotify 推你 |
| 每日(自动) | 磁盘使用率 | 巡检脚本 | >85% → 告警 |
| 每周 | 容器/服务异常退出 | journalctl --user -p err |
排查反复重启的服务 |
| 每周 | 证书剩余天数 | caddy list-certificates |
<15 天 → 处理 |
| 每月 | 恢复演练 | 从 Backrest 随机抽一个仓库做 restore 测试 | 恢复失败 → 立刻修 |
| 每月 | 系统更新 | apt update && apt list --upgradable |
打安全补丁 |
| 每季 | 容量规划 | 媒体库增长率 | 规划扩容 |
| 每季 | 整机迁移演练 | 按文档重装一台 | 验证「我能恢复」 |
每月恢复演练是整套运维的皇冠动作。备份没验证过 = 没有备份。详见 11.5。
11.3 巡检脚本:一条命令看全貌
把每日检查写成脚本,扔进 cron,异常就推 Gotify。
#!/usr/bin/env bash
# /home/selfhost/bin/daily-check.sh
set -uo pipefail
GOTIFY_URL="http://127.0.0.1:8080"
GOTIFY_TOKEN="<你的AppToken>"
BACKREST_URL="http://127.0.0.1:9898"
WARN_DS=85 # 磁盘告警阈值 %
WARN_MEM=90 # 内存告警阈值 %
notify() {
curl -s -X POST "${GOTIFY_URL}/message?token=${GOTIFY_TOKEN}" \
-H "Title: $1" -d "$2" >/dev/null
}
problems=()
# 1) 磁盘使用率(排除 tmpfs,因为 df 会把 tmpfs 算成 100%)
while read -r usage mount; do
pct="${usage%%%*}"
if [[ "$pct" =~ ^[0-9]+$ ]] && [ "$pct" -ge "$WARN_DS" ]; then
problems+=("磁盘 $mount 使用率 ${pct}%")
fi
done < <(df -PT -x tmpfs -x devtmpfs | tail -n +2 | awk '{print $6, $7}')
# 2) 内存
mem_pct=$(free | awk '/Mem:/ {printf "%d", $3/$2*100}')
[ "$mem_pct" -ge "$WARN_MEM" ] && problems+=("内存使用率 ${mem_pct}%")
# 3) 失败的 user 服务
failed=$(systemctl --user list-units --state=failed --no-legend --no-pager | awk '{print $1}')
[ -n "$failed" ] && problems+=("失败的 user 服务: $(echo $failed | tr '\n' ' ')")
# 4) 重启过的容器(近 24h)
crashed=$(podman ps -a --filter "status=exited" --format "{{.Names}}" | tr '\n' ' ')
[ -n "$crashed" ] && problems+=("已退出的容器: $crashed")
# 5) 最近的备份记录(Backrest API 需按版本调整路径)
recent_backup=$(curl -s "$BACKREST_URL/api/restic/backups" 2>/dev/null | head -c 200)
if ! echo "$recent_backup" | grep -q '"time"'; then
problems+=("Backrest 备份状态异常,请检查 Web UI")
fi
# 6) 汇总上报
if [ ${#problems[@]} -gt 0 ]; then
notify "自托管巡检告警" "$(printf '%s\n' "${problems[@]}")"
echo "发现问题 ${#problems[@]} 项,已推送通知"
else
echo "巡检通过:磁盘/内存/服务/容器/备份 全部正常"
fi
挂到 cron(每天 8:30):
chmod +x ~/bin/daily-check.sh
crontab -e
# 加入:
30 8 * * * /home/selfhost/bin/daily-check.sh >> /home/selfhost/logs/daily-check.log 2>&1
用
cron而非 systemd timer 的理由:脚本极轻、失败不影响系统;systemd timer 更适合有状态的长任务。两者都可行,看你习惯。
11.4 升级:两条路径
原生服务和容器的升级方式完全不同,别搞混。
11.4.1 原生服务升级
# 1) 先备份配置和数据
sudo tar czf ~/backup-$(date +%F).tar.gz /etc/<service>/ /var/lib/<service>/
# 2) 查更新
apt list --upgradable
# 3) 只升级目标服务(避免连带升级一堆)
sudo apt install --only-upgrade <packagename>
# 4) 重启并确认
sudo systemctl restart <service>
systemctl status <service>
手工安装的二进制(Backrest / Forgejo / Gonic / Gotify / PocketBase / slskd 等):
# 套路:下载新版本 → 停服务 → 换二进制 → 启服务 → 验证
cd /tmp
VERSION=<新版本号>
curl -LO "https://github.com/<org>/<repo>/releases/download/v${VERSION}/<binary>"
sudo systemctl stop <service> # 停
sudo install -m755 <binary> /usr/local/bin/<binary> # 换(先备份旧的)
# sudo cp /usr/local/bin/<binary> /usr/local/bin/<binary>.bak
sudo systemctl start <service> # 起
systemctl status <service> && journalctl -u <service> -n 50 --no-pager
⚠️ 务必先备份旧二进制(
cp xxx xxx.bak)。新版本可能改配置文件格式,起不来时能秒回滚。
11.4.2 Podman 容器升级
# 1) 改 Quadlet 文件里的 tag:latest → 具体版本号(生产环境别用 latest!)
# Image=docker.io/jellyfin/jellyfin:10.9.11
# 2) 重载并重建
systemctl --user daemon-reload
systemctl --user restart jellyfin.service
# 3) 看日志确认新版起来了
podman logs --tail 50 jellyfin
podman image ls | head # 确认新镜像
镜像清理(rootless Podman 会越攒越多):
podman image prune -f # 清理悬空镜像
podman system df # 看占用
podman image prune -a -f # 谨慎:删除所有未被使用的镜像
💡 生产建议:Quadlet 里写死版本号而不是
latest。latest意味着某天podman pull拉到一个有 bug 的版本,你排查时会多花几小时。
11.4.3 升级纪律
| 规则 | 原因 |
|---|---|
| 生产环境写死版本号 | latest 会静默引入变更 |
| 升级前必备份二进制 + 数据目录 | 出问题能秒回滚 |
| 一次只升一个服务,升完验证再下一个 | 出问题时归因清晰 |
| 非紧急补丁不必当天打 | 观察 2~3 天再升,避免踩上游新 bug |
| 安全高危补丁立即打 | 前提是已有备份和恢复路径 |
11.5 备份与恢复:真正重要的一章
11.5.1 备份分层
三层数据分级:
| 等级 | 内容 | 备份策略 |
|---|---|---|
| 🔴 不可再生 | Immich 照片、Vaultwarden 密码库、Forgejo 代码、Backrest 自身配置 | 每日增量 + 异地 + 每月恢复演练 |
| 🟡 半可再生 | Readeck 收藏、Actual 账本、Gotify 通知历史 | 每周 |
| 🟢 可再生 | 影视、音乐、apt 缓存、容器镜像 | 不备份 |
11.5.2 恢复演练(必做)
没有验证过的备份不算备份。 每月做一次,流程固定:
# 1) 列出所有仓库和快照
backrest repo list
backrest snapshot list --repo <repo-name>
# 2) 选一个快照,恢复到临时目录(不覆盖现有数据!)
backrest restore --repo <repo-name> --snapshot <snapshot-id> --target /tmp/restore-test
# 3) 验证内容
ls -la /tmp/restore-test/
find /tmp/restore-test -name "*.jpg" | head # 照片类
# 密码库:确认 pb_data / vaultwarden data 在
# 4) 清理
rm -rf /tmp/restore-test
在 Backrest Web UI 里做更直观:Plans → 对应 plan → Snapshot 列表 → 选一个 → Restore → 选目标目录 → 恢复后打开文件校验。
🔴 密码库专项演练:定期(每季)在一台干净的机器/容器里恢复 Vaultwarden 的数据目录,验证能用主密码正常解密。只在原机器上”恢复成功”说明不了问题——真正的风险是解密密钥验证流程没走过。
11.5.3 异地备份的现实问题
- 成本:Backblaze B2 / 阿里 OSS / 腾讯 COS,媒体库不大(只备不可再生数据)的话,月成本通常在几元到几十元。
- 加密:Restic 客户端加密,异地仓库里是密文——这既是安全优势,也是风险(密码丢了,备份也解不开)。密码要存在密码管理器之外的第二处。
- 一致性:数据库类数据(SQLite)备份时若正在写入,恢复出来可能损坏。解法:
- 优先用服务自带的备份机制(Immich 有官方 backup 流程);
- 或用 SQLite 的
.backup命令而非直接复制文件; - 或接受”最坏情况下丢最近几分钟”。
11.6 证书与域名运维
| 事项 | 频率 | 操作 |
|---|---|---|
| 检查证书有效期 | 每周/自动 | sudo caddy list-certificates |
| 确认自动续期正常 | 每月 | journalctl -u caddy | grep -i renew |
| 域名 DNS 记录核对 | 每季 | 确认 AAAA 仍指向本机 |
| 证书签发失败排查 | 出现时 | 80/443 可达?DNS 生效?配额? |
Caddy 自动续期失败的三种典型原因:
- 80 端口被占用或不通 → HTTP-01 验证失败。
- DNS 记录未生效 → 验证请求打不到你的机器。
- Let’s Encrypt 速率限制 → 短时间重复签发被限(5 次/小时等)。别反复重试,看
journalctl里的具体错误码。
兜底方案:即使 Caddy 挂了,你还能从内网直连服务 IP 应急(这也是”服务不直接暴露公网”的另一个好处——不影响内网使用)。
11.7 磁盘与容量管理
媒体库是会持续增长的,这是长期运维最大的隐性成本。
# 1) 找出空间大户
sudo du -h --max-depth=1 /srv/media | sort -h | tail -20
# 2) inode 检查(小文件太多也会满)
df -i
# 3) 找大文件(Top 50)
sudo find /srv/media -type f -size +2G -exec du -h {} + 2>/dev/null | sort -rh | head -50
# 4) 日志占位
sudo du -sh /var/log/* 2>/dev/null | sort -h | tail -10
journalctl --disk-usage
必做的两件事:
- 限制 journald 占用(否则日志把根分区写满,全盘服务挂掉):
# /etc/systemd/journald.conf
[Journal]
SystemMaxUse=500M
MaxRetentionSec=2week
sudo systemctl restart systemd-journald
sudo journalctl --vacuum-size=500M
- 给媒体库设增长预期:按当前速率估算 6 个月后占多少,提前扩容。原文 6TB 听着多,但 4K 媒体一年吃掉好几 TB;如果按他的 720p 策略,每年增长会慢得多。
11.8 安全运维
11.8.1 密钥与凭据管理
| 凭据 | 存放位置 | 轮换周期 |
|---|---|---|
| Vaultwarden 主密码 | 只在脑子里 | 无法轮换,强度决定一切 |
| 各服务密码 | Vaultwarden | 6~12 个月 |
| WireGuard/Tailscale 密钥 | 服务器 + 客户端 | 设备丢失时立即吊销 |
| Caddy Cloudflare API Token | 环境变量 / secret 文件 | 6~12 个月 |
| Podman registry 凭据 | ~/.config/containers/auth.json |
按需 |
| Backrest Restic 仓库密码 | Backrest 配置 | 谨慎变更(改了要重加密) |
一条铁律:自托管的凭据不能存在同一台机器上。用 Vaultwarden 存其他服务的密码,Vaultwarden 的主密码靠记忆 + 纸质备份(放在保险的地方)。
11.8.2 暴露面定期核查
# 1) 本机所有监听端口——只应该有内网地址 + 必要端口
ss -tlnp
# 2) 确认没有意外的 0.0.0.0 监听(对公网的服务)
ss -tlnp | grep '0.0.0.0' | awk '{print $4}'
# 3) 从外部视角自查(用手机关掉 WiFi,用 4G 访问)
# 逐个访问你的域名,应该全部打不开(除了 VPN 端口)
💡 定期从”外网视角”检查是最有效的安全习惯。家里宽带可以用另一条线路(手机热点)做这件事。
11.8.3 认证审计
- Uptime Kuma 里给每个服务配外部探针(从外部网络请求),而不只是内网自检。
- 定期检查 Vaultwarden 是否有异常登录。
- Vaultwarden 关闭注册后,任何”注册成功”都是异常信号。
11.9 故障处理:从现象到根因
11.9.1 分级与响应
| 级别 | 定义 | 例子 | 响应时间 | 处理方式 |
|---|---|---|---|---|
| P0 | 全家不可用 | 主机宕机、网络断了 | 立即 | 查硬件/网络,考虑备用方案 |
| P1 | 核心服务不可用 | Jellyfin 挂了、密码库进不去 | 2 小时内 | 重启 → 查日志 → 查资源 |
| P2 | 单个非核心服务异常 | FreshRSS 抓取失败 | 当天 | 记录,周末批量修 |
| P3 | 体验类问题 | 媒体库刮削不干净 | 择机 | 有空再管 |
11.9.2 标准排障流程
命令速查(按顺序试):
# 服务层
systemctl --user status <svc> # 原生服务
systemctl --user restart <svc> # 先重启止血
journalctl --user -u <svc> -n 100 --no-pager # 看错误
journalctl --user -u <svc> -f # 实时跟踪
# 容器层
podman ps -a # 容器状态
podman logs --tail 100 <container>
podman inspect <container> | grep -A5 State
# 系统层
df -h && df -i # 磁盘
free -h # 内存
dmesg -T | tail -50 # 内核消息(OOM!)
uptime # 负载
sudo systemctl --failed # 失败的系统服务
# 网络层
ss -tlnp # 端口监听
curl -sv http://127.0.0.1:8096 # 本地直连测试
sudo caddy validate --config /etc/caddy/Caddyfile # 反代配置
11.9.3 常见根因速查(按出现频率排序)
| 现象 | 最可能的根因 | 第一动作 |
|---|---|---|
| 多个服务同时挂 | 主机资源耗尽(磁盘满/OOM) | df -h、free -h、dmesg |
| 单个服务反复重启 | 配置错、依赖未起、端口冲突 | journalctl -u <svc> 看最后一次退出原因 |
| 页面打不开但服务在跑 | Caddy 配置/证书问题 | caddy validate、caddy list-certificates |
| 变慢/卡顿 | 内存不足开始 swap,或磁盘 IO 饱和 | free -h、iostat -x 1 |
| 手机连不上 | VPN/Tailscale 断了 | 重连;看服务端握手日志 |
| 备份突然变大 | 媒体库被扫进备份了 | 检查 Backrest plan 路径 |
| 照片不见了 | Immich 存储目录写满/挂载失败 | df -h /srv/immich |
11.10 自动化运维:用 systemd timer 做周期任务
比 cron 更”原生”的做法,适合长任务:
# ~/.config/systemd/user/backup-verify.timer
[Unit]
Description=每周验证备份可恢复性
[Timer]
OnCalendar=Sun 03:00
Persistent=true # 关机错过了,开机后补跑
[Install]
WantedBy=timers.target
# ~/.config/systemd/user/backup-verify.service
[Unit]
Description=验证备份
[Service]
Type=oneshot
ExecStart=%h/bin/backup-verify.sh
systemctl --user daemon-reload
systemctl --user enable --now backup-verify.timer
systemctl --user list-timers # 确认下次触发时间
Persistent=true 很关键:笔记本/迷你主机断电或关机错过了任务,开机后会自动补跑,不会静默丢失。
11.11 整机迁移与灾难恢复
这是”自托管”区别于”装软件”的最后一环:如果这台机器明天彻底坏了,你能在多久内恢复全部服务?
必须提前写好的文档(写在纸上或离线存一份):
# 灾难恢复手册
## 1. 硬件清单
- 主机:Beelink S12 Pro (N100/16GB/512GB)
- 存储:6TB HDD (数据), 128GB SSD (系统)
- 网络:路由器 WireGuard,客户端密钥 <存放位置>
## 2. 恢复顺序
1. 安装 Debian 12
2. 恢复 6TB 数据盘(挂载到 /srv/media)
3. 安装 Caddy,恢复 /etc/caddy/Caddyfile,重载
4. 恢复各服务配置与数据目录(从 Backrest 拉)
5. 部署 systemd unit 与 Quadlet 文件
6. loginctl enable-linger
7. 逐个验证(见验收清单)
## 3. 关键配置备份位置
- Caddyfile: <位置>
- Quadlet 文件: <位置>
- 各服务数据目录: <列表>
- Backrest 仓库凭据: <位置>
- Vaultwarden 主密码: <纸质备份位置>
## 4. 联系方式
- 家人如何访问: <说明>
恢复演练(每季度一次,或至少每年一次):
- 找台旧电脑/虚拟机,从头照着文档装一遍。
- 会发现文档里缺失的步骤 —— 那正是它的价值。
- 演练耗时的 2~3 倍,就是你真实的灾难恢复时间(RTO)。
11.12 运维成熟度自查
自评:
| 维度 | 达成标准 |
|---|---|
| 观测 | 手机关 WiFi 用 4G 访问,全部服务打不开但 VPN 能通;服务挂掉 1 分钟内收到推送 |
| 控制 | 知道服务名后,30 秒内完成「定位 → 查看日志 → 重启 → 验证」 |
| 恢复 | 每月完成一次实际 restore 并打开文件验证;知道从零重建全栈需要多久 |
| 安全 | 从外网扫描只有一个 VPN 端口开放;Vaultwarden 注册已关闭;所有凭据在密码库里 |
| 容量 | 知道当前磁盘用了多少、按当前速率 6 个月后会是多少、有明确扩容计划 |
附:与原文的差异说明(本文档做的增补)
| 项 | 原文 | 本文档 |
|---|---|---|
| 网络前提 | 公网 IPv6 + VPN | 新增第 7 章:中国大陆 CGNAT/备案/端口 的完整适配(Tailscale/FRP/Cloudflare Tunnel) |
| 服务安装 | 列了名字,未给命令 | 每个服务给出可复制安装/配置/systemd/Quadlet 步骤 |
| 容器管理 | 提了 Podman/Quadlet 概念 | 补全 Quadlet 机制细节 + 每个容器的 .container 模板 + linger 等必踩坑 |
| 安全 | 原则一(不暴露公网) | 落地为三层纵深防御图 + Vaultwarden 关注册等硬规矩 |
| 容量 | 给了实测(7.5G/16G、30-40% CPU) | 补内存/磁盘估算表 + 存储规划(DB 放 SSD、媒体放 HDD) |
| 验收 | 无 | 新增逐条验收清单 + 故障速查表 |
| 不自托管 | 列了 6 个 + 理由 | 提炼成通用判据决策树,可复用到任何服务 |
| 服务能力 | 只列了服务名 | 第 10 章:9 大能力域重组 + 5 个端到端场景 + 能力→服务映射总表 |
| 运维 | 几乎没提 | 第 11 章:观测/控制/恢复三层体系、巡检脚本、升级纪律、恢复演练、灾难恢复手册、成熟度自查 |
⚠️ 免责与校验说明:本文档中 systemd unit、Quadlet 文件、配置文件均为按各服务官方文档与通用实践整理的模板,服务版本迭代较快,具体镜像 tag、命令行参数请以各项目官方文档为准;落地时请先用单个服务验证通再批量应用。国内网络章节是结合通用情况的工程方案,涉及付费服务(VPS/Tailscale 等)请自行评估合规与成本。