自托管服务全家桶:从原文方案到可复制实操手册


难度 中等

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 条原则

原文最有价值的不是那 28 个服务清单,而是他反复强调的 4 条判断原则。清单会过时,原则不会。

1.1 原则一:任何服务都不直接暴露到公网

他的原话大意是:除了路由器上跑的 VPN,没有任何服务直接把端口开到公网。所有 Web 服务(Caddy、Jellyfin、Immich…)都只监听内网,公网唯一入口是 VPN。

为什么这是对的?

暴露方式 攻击面 被打穿的代价
直接开公网端口 每天 24h 全球扫描 一个弱密码 = 数据全泄
只走 VPN 只对有 VPN 密钥的人开放 密钥泄露 = 同上,但可控可审计

逻辑很简单:公网 = 全世界的靶场,内网 = 自家客厅。把「全家福」全挂到大街上不如留一扇门(VPN)自己开门。

落地三件套:

  1. 路由器上装 WireGuard/OpenVPN,只有 VPN 端口对公网开放。
  2. 所有 Web 服务的 listen 绑 127.0.0.1 或内网网卡地址。
  3. 出门用手机连 VPN,再访问内网地址——体验和连家里 WiFi 一样。

国内落地提醒:家里没有公网 IPv4 时,第 3 条要改用第 7 章的 Tailscale/FRP 方案。

1.2 原则二:优先原生二进制,其次容器;能不装包就不装

他的优先级是:原生二进制(Native)> 容器(Podman)。原文列的 17 个原生服务都是单二进制或单包,装完 systemctl enable 就完事。

为什么优先原生?

  • 省内存:一个 systemd 服务常驻 1080MB;同功能容器因为要跑 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 选购建议(原文逻辑的复制)

选一台迷你主机时按这个顺序看:

  1. CPU 带 AV1/H.265 硬解核显(N100/N305、J4125、锐龙 6xxx G 系列都行)——决定了媒体服务能不能不炸 CPU。
  2. 内存 ≥16GB,且要双通道——能加内存更好;28 个服务 16GB 是他的实测下限。
  3. 双网口(可选):想以后拿它做软路由 / 跑 WireGuard 落地、或把 6TB 存储单独挂一台时有用。
  4. 至少 1 个 M.2 NVMe 槽 + SATA 口——系统/容器镜像放 NVMe(快),媒体放 SATA 大盘(性价比)。
  5. 功耗 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 解析。这一章把这三件事拆开讲,并给可复制命令。

flowchart TB subgraph Internet["公网"] User["你(手机/笔记本)"] end subgraph Router["路由器(唯一公网敞口)"] WG["WireGuard/OpenVPN<br/>监听公网端口"] end subgraph LAN["内网(唯一可达面)"] H["迷你主机<br/>所有服务监听 LAN 地址"] Caddy["Caddy<br/>反代 + 自动 TLS"] end User -->|"① 先连 VPN 拿到内网 IP"| WG WG -->|"② 经隧道访问内网 IP"| H H --> Caddy Caddy -->|"③ 按域名分发 + Let's Encrypt"| User

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 架构总览:三层纵深防御

原文的实际防线是三层的(自述”三重保障”):

flowchart LR A["① 网络层<br/>仅 VPN 端口对公网开放<br/>Caddy 也只经隧道可达"] --> B["② 认证层<br/>VPN 密钥认证<br/>+ 各服务 Basic Auth / 强密码"] B --> C["③ 应用层<br/>服务自身登录<br/>Vaultwarden 等敏感服务额外加固"]

这个纵深思维值得照抄:任一层被突破,后两层仍能拦一道。比如有人扫到你的 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>。
  • 每个服务给出「用途 + 安装 + 配置/运行」,配置项挑关键的讲。
flowchart TB subgraph Row1[" "] direction LR subgraph L1["基础设施"] Caddy["Caddy"] Samba["Samba"] Cockpit["Cockpit"] end subgraph L2["监控/备份"] Beszel["Beszel"] Backrest["Backrest"] Uptime["Uptime Kuma"] end subgraph L3["媒体/影音"] Jelly["Jellyfin"] ABS["Audiobookshelf"] MPD["MPD"] Snapcast["Snapcast"] end end subgraph Row2[" "] direction LR subgraph L4["阅读/笔记"] FreshRSS["FreshRSS"] Readeck["Readeck"] Forgejo["Forgejo"] end subgraph L5["同步/下载"] Syncthing["Syncthing"] Transmission["Transmission"] Slskd["slskd"] Gonic["Gonic"] end subgraph L6["通知/面板"] Gotify["Gotify"] Homepage["Homepage"] PocketBase["PocketBase"] end end Row1 --> Row2

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 铁律:

  1. SIGNUPS_ALLOWED=false(注册完立刻关,否则任何知道域名的人都能注册)。
  2. 一定经 Caddy 反代 + HTTPS,不要裸奔 80。
  3. /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 等托管邮箱

这张表的通用判据(可复用到任何服务):

flowchart TB Start["想自托管某个服务 X"] --> Q1{"成熟 SaaS 又好又便宜?"} Q1 -->|是| UseSaaS["用 SaaS"] Q1 -->|否| Q2{"维护成本 > 收益?"} Q2 -->|是| Skip["放弃自托管"] Q2 -->|否| Q3{"依赖复杂到翻车?"} Q3 -->|是| Container["Podman 容器跑"] Q3 -->|否| Native["原生二进制/包跑"]

一句话:「要么 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 国内选型小结(可直接照做)

flowchart TB Start["我的家宽能直连公网吗"] --> C1{"有公网 IPv6<br/>且能开 80/443?"} C1 -->|能| Use1["照抄原文方案<br/>IPv6 + Caddy 自动 TLS<br/>+ WireGuard"] C1 -->|不能| C2{"接受所有服务<br/>仅自己/家人可达?"} C2 -->|接受| Use2["Tailscale/Headscale 组网<br/>不暴露任何公网端口"] C2 -->|要对外公开| Use3["FRP 中转海外 VPS<br/>或 Cloudflare Tunnel"]

第 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 混合 各 50150MB 轻

规划公式:总内存 ≈ Σ常态内存 × 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 省资源的两条原文经验(值得直接抄)

  1. 媒体统一 720p:不追求 1080p/4K,媒体服务器 CPU/带宽压力骤降。
  2. 摄像头用低分辨率子码流: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 一句话验收标准

flowchart LR A["① 自动启动"] --> B["② 仅 VPN 可达"] B --> C["③ 证书正常"] C --> D["④ 监控无异常"] D --> E["⑤ 备份可恢复"] E --> F["✓ 跑通"]

第 10 章 服务能力全景:搭完之后你到底得到了什么

前面 9 章讲的是「怎么装」。这一章反过来讲:装完之后,你的生活里多了哪些能力。

这是自托管最容易被忽视的一环。装完 28 个服务,如果只是「端口开了」,那只是自嗨;只有把它们组合成日常可用的工作流,这套东西才真正产生价值。

10.1 从「服务清单」到「能力清单」

原文是按技术栈列的(17 个 systemd + 11 个 Podman)。但用户感知到的不是 systemd 和 Podman,而是能力。同一批服务重组后是 9 大能力域:

mindmap root(("自托管<br/>能力全景")) 影音娱乐 Jellyfin 影视 Audiobookshelf 有声书 MPD + Snapcast 音乐 ARM 光驱抓轨 照片记忆 Immich 照片库 智能家居联动 文件与同步 Syncthing 设备同步 Samba 局域网共享 Transmission BT 下载 Gonic + slskd 音乐交换 密码与身份 Vaultwarden 密码库 Forgejo 私有 Git 信息与任务 FreshRSS 订阅 Readeck 稍后读 Vikunja 待办 Actual Budget 记账 监控与告警 Beszel 资源监控 Uptime Kuma 可用性 Gotify 通知中枢 Homepage 总入口 数据与容灾 Backrest 备份 PocketBase 轻后端 基础设施 Caddy 反代与证书 Cockpit 管理面板

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)

关键工作流(”自动”是核心价值):

flowchart LR A["手机拍摄"] -->|"Immich App<br/>后台自动上传"| B["Immich 服务器"] C["Home Assistant<br/>检测到你在家"] -->|"触发场景"| D["开灯 + 放音乐"] B --> E["时间轴 / 人脸 / 地图"] B -->|"Backrest 每日备份"| F["异地加密副本"]

这是最值得投入的域: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 所有服务的可视化入口面板,显示每个服务的在线状态 「我现在该点哪个?」

告警闭环(这三者如何协同):

flowchart TB A["Uptime Kuma<br/>探针发现 502"] -->|"通知"| B["Gotify<br/>推送到手机"] C["Beszel<br/>发现磁盘 92% / 内存飙升"] -->|"通知"| B D["Backrest<br/>备份失败"] -->|"通知"| B B --> E["手机通知栏"] E --> F["你处理 → Homepage 定位 → SSH 修复"]

这是整套方案里投入产出比最高的部分: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:出门在外访问家里的一切

sequenceDiagram participant U as 手机 participant V as VPN/Tailscale participant C as Caddy participant J as Jellyfin U->>V: 连 VPN,拿到内网 IP U->>C: https://jellyfin.内网域名 C->>J: reverse_proxy 到 8096 J-->>U: 视频流 Note over U,J: 全程不出公网,不经过任何第三方

场景 B:照片自动备份 + 异地容灾

sequenceDiagram participant P as 手机 participant I as Immich participant B as Backrest participant R as 异地 Restic 仓库 P->>I: 拍摄后自动上传 Note over I: 存在 /srv/immich B->>I: 每日定时读取新增 B->>R: 加密上传(S3/B2/SFTP) Note over R: 异地副本,服务器全毁也不丢

场景 C:服务挂了 60 秒内知道并修好

sequenceDiagram participant K as Uptime Kuma participant G as Gotify participant M as 手机 participant H as Homepage K->>K: 探针连续失败 K->>G: 发送告警 G->>M: 推送通知 M->>H: 打开面板,看哪个服务红了 M->>M: SSH 上去 systemctl --user restart xxx

场景 D:新人/家人怎么用(零门槛)

flowchart LR A["家人打开 Homepage"] --> B["看到所有服务卡片<br/>绿色=在线"] B --> C["点 Jellyfin 卡片<br/>→ 电视上直接播放"] B --> D["点 Vikunja 卡片<br/>→ 看到要交电费"] B --> E["忘记密码<br/>→ Vaultwarden App 自动填充"]

场景 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 运维的三个层次

flowchart TB subgraph Row1[" "] direction LR subgraph L1["① 观测层 —— 知道发生了什么"] direction TB A["Beszel<br/>资源趋势"] B["Uptime Kuma<br/>服务在线"] C["日志 journalctl"] D["Backrest<br/>备份状态"] end subgraph L2["② 控制层 —— 能改能修"] direction TB E["systemctl<br/>启停"] F["Caddyfile<br/>改配置"] G["Quadlet<br/>改容器"] H["SSH / Cockpit"] end end subgraph Row2[" "] direction LR subgraph L3["③ 恢复层 —— 出事能回到过去"] direction TB I["Backrest<br/>时间点恢复"] J["Syncthing<br/>版本历史"] K["重装流程文档化"] end end Row1 --> Row2

关键认知:这三层缺一层,自托管就会退化。

  • 没有观测 → 你只能等用户投诉才知道坏了(最糟的运维模式)。
  • 没有控制 → 知道坏了但改不动,只能重装。
  • 没有恢复 → 知道坏了也修不好,只能重买硬件(最贵的失败)。

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 备份分层

flowchart LR A["数据源<br/>Immich 照片"] --> B["Backrest 计划任务<br/>Restic 增量快照"] B --> C["本地仓库<br/>/srv/backup-repo"] B --> D["异地仓库<br/>S3 / B2 / SFTP"] C --> E["恢复演练<br/>每月抽检"] D --> E

三层数据分级:

等级 内容 备份策略
🔴 不可再生 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 自动续期失败的三种典型原因:

  1. 80 端口被占用或不通 → HTTP-01 验证失败。
  2. DNS 记录未生效 → 验证请求打不到你的机器。
  3. 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

必做的两件事:

  1. 限制 journald 占用(否则日志把根分区写满,全盘服务挂掉):
# /etc/systemd/journald.conf
[Journal]
SystemMaxUse=500M
MaxRetentionSec=2week
sudo systemctl restart systemd-journald
sudo journalctl --vacuum-size=500M
  1. 给媒体库设增长预期:按当前速率估算 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 标准排障流程

flowchart TB A["发现异常"] --> B["确认范围<br/>单个服务?全部?"] B -->|全部| C["查主机层<br/>电源/网络/磁盘/内存"] B -->|单个| D["查服务层<br/>systemctl status"] C --> E["查资源<br/>df / free / dmesg"] D --> F["查日志<br/>journalctl -n 100"] E --> G{"能修吗"} F --> G G -->|能| H["修复 + 记录"] G -->|不能| I["回滚<br/>备份/旧二进制/重装"] H --> J["复盘<br/>加监控/改配置防复发"] I --> J

命令速查(按顺序试):

# 服务层
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 运维成熟度自查

flowchart LR L1["L0 能用<br/>装完能访问"] --> L1a["✓ 服务能开<br/>✗ 挂了不知道"] L1 --> L2["L1 能看<br/>有监控有告警"] L2 --> L2a["✓ 挂了知道<br/>✗ 修不动/恢复不了"] L2 --> L3["L3 能修<br/>有流程有回滚"] L3 --> L3a["✓ 知道+能修<br/>✗ 数据恢复没验证"] L3 --> L4["L4 能扛<br/>备份+演练+迁移"] L4 --> L4a["✓ 观测/控制/恢复<br/>三层齐备"]

自评:

维度 达成标准
观测 手机关 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 等)请自行评估合规与成本。


文章作者: growdu
版权声明: 本博客所有文章除特別声明外,均采用 CC BY 4.0 许可协议。转载请注明来源 growdu !
这篇还发到了
今日头条 drafted
  目录