关于 Beaconbox

这是什么站

Beaconbox 是一台家庭机架的施工记录：一台 8GB 内存的树莓派 4B、一块 2TB USB 固态硬盘，以及一组承担 DNS、影音、文件、监控和远程访问的容器，服务的是四口之家。这里的每一页写的都是那台机器上真实跑着的东西，镜像标签、端口和挂载路径都和在役配置一致。

它是写给已经刷好 SD 卡、但希望接下来四十个决定不用自己做的人看的：给服务分哪个端口才不会撞、预留多少内存才不至于让树莓派开始换页、以及断电重启后哪些东西会坏。

一条内容是写出来的

每项服务在发布前，都先在参考机上连续跑满三周。这段观察期才是「能启动的容器」和「能长期活下去的容器」之间的区别：文中给的内存数字是 docker stats 稳定后的峰值再加约三成余量，而不是项目 README 里印的那个数。

端口的选择原则是不让两个服务打架。项目本身有众所周知默认端口的就保留默认，因为一个有文档可查的端口胜过一个人为整齐的端口——Grafana 留在 3000，Immich 留在 2283，Home Assistant 留在 8123，Navidrome 留在 4533。其余端口来自三个分段，从数字本身就能看出来：53xx 给 DNS，80xx 给挂在 Caddy 后面的网页前端，22xxx 给文件同步。Caddy 占据 80 和 443，也是这台机架上唯一会面对公网的东西。

凡是翻车过的地方都写下来。详情页上的「踩过的坑」才是真正有用的部分：写了十八个月密集日志之后挂掉的 SD 卡、悄悄退化成模拟执行、慢了四倍的 arm64 镜像，还有开机时比网络先起来、把全家断网的那个 DNS 容器。

参考机配置

板子：树莓派 4B，8GB，金属外壳被动散热，从 USB 固态盘启动而不是 SD 卡——长时间运行的树莓派里，卡是最常见的单点故障。

软件：64 位 Raspberry Pi OS（Bookworm），内核 6.6，Docker Engine 加 compose 插件，再往上没有编排层。单节点上跑 Kubernetes 是第二份工作，不是业余项目。

供电：每块板一条 5V 3A，固态硬盘盒单独用 60W USB-C 供电，整体挂在一台小 UPS 上，免得电压一掉正好卡在写盘中间把文件系统写坏。

发布节奏

条目按排期分批上线，不做一次性堆砌。发布日未到的条目不会出现在列表、搜索和站点地图里，它的网址在到期之前一律返回 404。你今天能读到的，就是今天已经验证过的。

纠错

如果某一步在你的板子上走不通，请把条目名、板子型号和内核版本发到 [email protected]。附上具体报错行的反馈会优先处理；内容实质变动时，条目上的日期也会随之更新。