本指南详细演示如何利用树莓派CM5结合Docker与Portainer，构建一台集密码管理、私有云、本地AI及智能家居控制于一体的全能家庭服务器。通过详细步骤解析，即使是新手也能轻松实现数据自主掌控与服务高效部署。
智能速览
使用PiHack DevBoard和树莓派CM5配合SSD提升性能
借助Docker和Portainer实现可视化的容器管理
部署Vaultwarden实现本地安全密码管理
利用SSD搭建Nextcloud私有云盘，提升读写速度
本地运行Ollama大模型，推荐使用Gemma 3
配置WireGuard VPN实现家庭网络的安全远程访问
精华内容
树莓派结合容器化技术，能以极低成本打造功能强大的家庭数据中心，以下将从硬件准备到服务部署进行全流程解析。
硬件与系统准备
硬件方面选用PiHack开发板搭配树莓派CM5计算模块，并连接NVMe SSD以保障系统运行和数据读写速度。使用PiBoot工具将系统直接烧录至SSD，确保从高速存储启动。设备连接电脑并通电后，即可通过识别到的存储盘载入Raspberry Pi OS。安装完成后，建议优先更新系统并配置静态IP地址，方便后续远程SSH连接与管理。
容器环境搭建
软件基础环境依托于Docker，它能将服务以隔离容器形式运行，避免冲突。首先安装Docker并通过运行Hello World容器测试环境。随后安装Portainer可视化管理平台，通过Web界面即可轻松管理所有容器。创建本地账户后，即可进入仪表板，这极大降低了后续部署多个服务的复杂度，无需频繁敲击命令行。
部署密码与云服务
首先部署Vaultwarden密码管理器，在Portainer中创建网络并粘贴代码部署栈。为确保证书安全，需通过SSH生成自签名SSL证书，并配置Nginx反向代理。完成后即可通过HTTPS访问本地密码库。随后部署Nextcloud私有云，该服务在SSD支持下能获得更快的文件访问体验。在浏览器输入设备IP及端口，创建账户后即可实现文件在本地网络内的安全存储与多设备同步。
本地AI与智能家居
利用Ollama在本地部署大语言模型，通过Portainer控制台直接与模型交互。在树莓派平台上，推荐运行轻量级且性能优异的Gemma 3模型，下载测试后即可拥有离线AI助手。对于智能设备用户，部署Home Assistant可集中管理家庭网络中的兼容设备。通过简单的初始化设置，即可将照明、传感器等设备接入平台，实现自动化控制。
远程访问配置
为解决外出访问需求，最后部署WireGuard VPN。在SSH中预先创建好服务文件夹并赋予权限，随后在Portainer中部署相关服务栈。部署完成后，仅需在路由器中设置端口转发以允许外部连接。配置成功后，即可在世界任何地点通过加密隧道安全连接回家中的局域网，如同身处家中一般访问所有部署的服务。
通过合理利用树莓派CM5的算力与Docker容器化技术，成功将单台设备升级为功能完备的家庭服务器。这不仅降低了数据上云的成本与风险，更提供了极高的可玩性与扩展性。随着硬件性能的提升，未来或许还能在家庭服务器上尝试更多有趣的服务。
