树莓派5家庭服务器终极方案：同时运行50+个Docker容器全记录

硬件选型与整体配置方案

与绝大多数家庭服务器入门玩家类似，我直接把核心运算平台锁定在可靠性极高的树莓派 5 上。

Image

为了配合树莓派打造私有 NAS 存储，我额外加装了一块 Radxa 五盘位 SATA 扩展板，并在板上装入 4 块 1TB 金士顿固态硬盘，组建 RAID5 磁盘阵列。严格来说 4 块盘组成 RAID5 并非算法层面上的最优排列（按块对齐原则，2 的整数倍盘数性能更佳），但这个方案同时实现了两大核心需求：将分散的存储空间聚合成一个统一卷，且任意一块 SSD 损坏都不会导致数据丢失。整个阵列最终可提供约 2.6TB 的可用空间。

截至目前，我在这块树莓派上 7×24 小时常驻运行着 50 多个 Docker 容器，其中包括配套的数据库、缓存服务、DNS 解析组件以及下面逐一介绍的各类应用。容器数量的确不算少，我也正在做精简梳理：把核心常驻服务与按需启动的辅助容器明确拆分，避免资源争抢。

网络架构、反向代理与安全加固

Pi-hole

https://github.com/pi-hole/docker-pi-hole

Image

用上 Pi-hole 之后，那种告别绝大多数广告的上网体验非常清爽，它也几乎是自建服务圈的标配工具。虽然做不到 100% 阻隔所有广告，但对日常浏览质量的提升极其明显。更重要的是，通过精心配置 DNS 黑名单，它还能拦截恶意网站，防止恶意程序悄悄侵入内网设备。

我目前维护的拦截黑名单收录了近 300 万个域名，但必须注意别把规则设得过于激进，否则容易误封网银等正常服务，需要定期校准白名单。推荐以下这几组 DNS 拦截订阅源：

  • DNS blocklist（覆盖面最广）
https://github.com/hagezi/dns-blocklists
  • AdGuardFilters
https://github.com/adguardteam/adguardfilters
  • OISD
https://oisd.nl/
  • AdFilt
https://github.com/DandelionSprout/adfilt

Nginx Proxy Manager

Image

如果你不想去记住家庭实验室里每一项服务对应的端口号，那么 Nginx Proxy Manager 绝对是刚需。它能让你彻底摆脱对端口的关注，而且只要配置得当，还可以为所有本地服务一键部署 SSL 安全证书，省去大把手工折腾的时间。

对于从事移动端开发的用户，它还有一个非常实用的场景：当你在本地电脑上启动后端服务时，通常需要借助 ngrok 之类的内网穿透工具。而有了 Nginx Proxy Manager，可以把域名直接反向代理到本地后端，完全不需要 ngrok。虽然该工具本身是为局域网访问设计的，但只要配合 Tailscale 或其他内网 VPN，即使你不在家中的 WiFi 环境下，也能通过加密隧道安全地访问所有本地服务，全程 TLS 加密，安全性非常高。

内网服务外向暴露重要提醒
我的绝大多数服务不会直接做端口映射暴露到公网。不经防护就把家庭服务器直接开放在互联网上风险极大。日常远程访问全部依靠 Tailscale 虚拟局域网接入，极少数必须对外开放的服务，会通过 cloudflared 容器搭建 Cloudflare 隧道进行中转。

NetAlertX

https://netalertx.com/

Image

这是一个能精细管控局域网内每一台联网设备的神器。它可以监测智能插座掉线、新设备接入并即时推送告警。我有一次通过告警发现亲戚只是把车停在屋外蹭了家里 WiFi；日常我父亲一回到家中，手机连上内网我就能收到通知，第一时间知道父母到家情况。缺点在于部分手机开启了随机 MAC 地址，每次重连都会被当作新设备，会产生大量冗余通知。

SearXNG

https://docs.searxng.org/admin/installation-docker.html

Image

SearXNG 自己并不抓取网页，而是聚合必应、谷歌、DuckDuckGo 等多家搜索引擎的结果统一展示。它不会受到单一平台的算法偏见或内容审查影响，对隐私极为友好且带有防追踪特性，很适合自己部署后当作主力搜索引擎使用。

系统监控与Docker容器集群管理

Beszel

https://beszel.dev/

Image

随着服务越来越多，有必要直观地查看硬件资源占用情况。Beszel 部署非常简单，上手门槛低，还可以设置多种告警：CPU 或内存使用率超过 80%、硬件温度超出安全阈值时主动推送通知。它支持多设备集群监控，之后若要扩容增加服务器节点，也能统一纳管。

Dockhand

https://dockhand.pro/

Image

Dockhand 可以在单机或多节点环境中批量管理 Docker 容器，能够检测镜像更新、定时自动清理无用镜像、查看容器日志以及统计单个服务的资源占用，是我最近使用频率最高的工具之一。

Homepage

https://gethomepage.dev/

Image

在搭建了数十个自建服务之后，需要一个统一入口仪表板来集中管理。Homepage 基于 YAML 配置文件即可快速成形，内置丰富的小组件，我主要用它展示各服务的实时资源用量与容器运行指标。

开发环境、AI大模型接入与自动化流水线

Infisical

https://infisical.com/docs/self-hosting/overview

我之前专门写过关于 Infisical 的详细文章，其核心价值在于统一托管全项目的环境变量、密钥凭证等敏感配置，在软件开发场景中能极大简化配置管理工作。

n8n

https://docs.n8n.io/hosting

Image

n8n 是开源自建自动化的标杆工具，采用拖拽式设计，几乎可以搭建任意自动化流程，并且支持嵌入 Python、JavaScript 自定义代码块。我曾用它实现过长音频批量转写、自动生成 PDF 文档等复杂任务。

LiteLLM

https://docs.litellm.ai/docs/proxy/docker_quick_start

Image

LiteLLM 可以看作自建版的 OpenRouter，用来统一汇总各家大模型服务商的 API 密钥。你不需要给每个应用分别配置密钥，只需要为每个厂商设置一条上游密钥，由 LiteLLM 生成虚拟密钥进行分发。

所有 AI 调用接口均无缝兼容标准 OpenAI 格式，还支持统计 Token 消耗、单密钥额度管控以及分组权限限制。对于那些原生不支持某款大模型但兼容 OpenAI 接口的软件，LiteLLM 能完美填补兼容性缺口。

Open WebUI

https://docs.openwebui.com/getting-started

Image

自建版 ChatGPT/Claude/Gemini 交互前端，既可以直接填入 API 密钥，也能对接 LiteLLM 网关做代理调用。一个突出的功能是：同一条提示词可以同时调用多个大模型并行返回结果进行对比；它还支持接入 Ollama 本地模型服务。受限于树莓派算力，无法直接运行大型本地模型，我将台式机上的 Ollama 服务暴露到局域网，让树莓派上的 Open WebUI 远程调用台式机 GPU 算力来驱动本地大模型。

Code-server

https://github.com/coder/code-server

Image

在浏览器中直接运行完整的 VS Code 编辑器。外出时随便用一台设备就能修改项目配置文件；我最常用的场景就是通过它编辑 docker-compose.yml，无需 SSH 登录服务器敲命令行编辑器，在网页里可视化操作非常便捷。

CloudBeaver

https://github.com/dbeaver/cloudbeaver/

Image

CloudBeaver 是网页版 DBeaver 数据库管理工具，能在浏览器内连接并运维各类数据库，方便将工作数据库和后端服务数据库集中到一个界面管理。

效率提升与文档数字化管理

Karakeep

https://docs.karakeep.app/installation/docker

Image

此前我长期使用 Mozilla 旗下的 Pocket 网页稍后读工具，该服务关停后我改用 Karakeep 作为替代。它支持自定义收藏分组、段落划线批注、RSS 订阅源同步，还能接入大模型实现自动内容标签分类，除了网页文章外也可以保存笔记、B 站视频链接。

Slash

https://github.com/yourselfhosted/slash

Image

Slash 能让你脱离浏览器账号同步的束缚，统一管理常用网站书签，支持标签分类和自定义快捷指令一键打开对应网页。

Paperless-ngx

https://docs.paperless-ngx.com/setup/

Image

Paperless-ngx 是全能的文档数字化管理系统，可以把发票、合同、收据扫描后自动分类打标、记录往来方信息，依靠机器学习不断优化自动归档规则。内置 OCR 文字识别，可直接搜索 PDF 和扫描图片里的文字；还配有移动端 APP，随时拍照上传纸质单据。此外，它能够绑定邮箱，自动抓取邮件附件里的电子账单、银行回执并归入档案库。

Speakr

https://murtaza-nasir.github.io/speakr/

Image

Speakr 对接 Whisper 语音转写模型与大模型文本分析，上传会议录音后可以生成干净的文稿，也支持实时录制麦克风和电脑系统音频。会议结束后会自动解析文稿、梳理待办事项，通过自定义提示词可生成精简纪要。它还搭载本地 RAG 知识库，能够全局检索过往所有会议记录，甚至提取通话中提到的日程事项一键添加日历。

多媒体影音中心与数据存储备份

Immich

https://docs.immich.app/install/docker-compose/

Image

Immich 是对标 Google Photos 的自建相册服务，支持人脸识别、自定义相册、基于地理位置的照片地图时间线、多用户账号以及安全分享，完全可以当作商用云相册的绝佳平替。

重要硬件说明：树莓派 5 的算力足够运行人脸识别、物体识别等 AI 任务，但在批量上传照片或视频转码时资源占用会急剧升高。建议不要一次性大批量导入图库，操作期间尽量暂停其他高负载容器；移动端 APP 能后台自动备份手机相册，有效防止手机数据丢失。

Jellyfin

https://jellyfin.org/docs/general/installation/container

Image

用 Jellyfin 搭建个人版 Netflix，可以在全设备上串流播放本地的电影、剧集和音乐。它完全开源免费，部署简单，智能电视端也有完善的客户端支持。

Ryot

https://ryot.io/

Image

Ryot 用来记录看过的影视剧、动画、单机游戏进度，也可以录入健身打卡计划，我主要用它归档已看完以及计划观看的影视内容。

Duplicati

https://docs.duplicati.com/platform-specific-guides/using-duplicati-from-docker

Image

Duplicati 负责为整套服务器架构做自动化备份，每 3 天增量打包容器的持久化数据卷、环境配置文件、编排模板以及数据库备份文件。主服务数据放在独立硬盘上，备份文件自动存入 RAID 阵列，以免主存储硬件损坏导致数据丢失。远期计划是落地 3-2-1 备份规范：每月异地冷备份一份至 AWS Glacier 低价归档云存储用于灾难恢复。它兼容本地磁盘、SSH/SFTP、FTP、谷歌云盘、Dropbox、S3 对象存储等几乎所有备份目标。

其他实用小工具推荐

Umami

https://docs.umami.is/docs/install

Image

轻量隐私统计工具，用于替代谷歌分析，可以查看访客地域、来源、浏览器、推广渠道等数据，常驻内存仅约 250MB。

Wallos

https://wallosapp.com/

Image

Wallos 专门管理各类订阅账单，录入会员订阅周期和支付方式后，会在到期续费前推送提醒，帮助你及时清理无用订阅项目。

DumbAssets

https://github.com/DumbWareio/DumbAssets

Image

这是一个固定资产台账工具，核心功能是录入设备保修单 PDF，并在保修期临近时自动提醒维保和质保到期。

Mealie

https://mealie.io/

Image

Mealie 相当于电子菜谱本，可以留存手写菜谱、从网页扒取美食配方，还附带每周排餐计划和自动生成采购清单的功能。

Manyfold

https://manyfold.app/get-started/installation

Image

Manyfold 是 3D 打印模型素材库，可以分类管理打印文件、进行版本迭代归档，避免文件杂乱堆放。

其他无可视化网页界面、仅作为底层依赖运行的容器：

  • Evolution api：接管 WhatsApp 账号，对接 n8n 实现语音转文字、消息总结、自动回复
  • Gotenberg：网页截图、PDF 批量生成与合并
  • Hometube：视频批量下载归档工具
  • Uptime Kuma：传统站点存活监控，现已逐步被 Dockhand 替代
  • Cronmaster：通过网页面板可视化管理 cron 定时任务
  • Speedtest tracker：定期测速监控宽带带宽，网速低于阈值时告警

已经退役与替换的旧服务

Plex

https://www.plex.tv/

曾经的主力影音服务，后来因官方限制免费内网穿透、大幅涨价终身授权，我迁移到了完全开源免费的 Jellyfin。Plex 的原生界面优化确实更好，但以我的个人需求来说 Jellyfin 已经绰绰有余。

ByteStash

https://github.com/jordan-dalby/ByteStash

原本用于存放代码片段与常用提示词，后来内容全部迁移至 Obsidian 知识库，该服务直接下线。

Forgejo

https://forgejo.org/

自建私有 GitHub 代码仓库，虽然可以本地托管代码与 CI 流水线，但 GitHub 免费版完全满足我的使用需求，因此不再单独部署。

Home Assistant

https://www.home-assistant.io/

家中有智能灯光、通断开关、语音开机电脑，但日常使用 Alexa 语音助手已足够；而且 Home Assistant 闲置内存占用过高，最终卸载不再部署。

Portainer & Watchtower

https://www.portainer.io/
https://containrrr.dev/watchtower

经典容器管理加自动更新的组合，因为 Watchtower 长期停更无人维护，我换成了功能更全面的 Dockhand。

File Browser

https://filebrowser.org/

文件管理工具，之后直接配置 Samba 局域网共享，手机自带文件管理器就能访问服务器文件，该工具便成了冗余组件，已废弃。

CRM Monica

https://www.monicahq.com/

私人社交人脉关系管理系统，实际很难坚持手动录入每条人际往来记录，需要时直接在 Obsidian 搭建关联图谱即可，无需单独部署。

Homarr

https://homarr.dev/

模块化仪表盘主页，自定义自由度极高，但内存开销偏大，最终迁移至更轻量化的 Homepage。

未来规划与扩展方向

整套服务器架构还在持续迭代，机柜中已经新增 ZimaBlade 设备用于硬件扩容，同时正在测试 Hermes Agent 等前沿工具，后面会单开文章细讲。如果你也在使用上述任意一项自建工具，或是计划上手部署，欢迎在评论区交流～