3步打造家庭智能网关：ImmortalWrt容器编排实战指南

一、家庭网络的"多任务困境"：你是否也遇到这些问题？

当你在路由器上安装了智能家居控制、网络存储、广告过滤等多个服务时，是否经常面临：服务启动顺序混乱、端口冲突、资源占用过高导致路由器卡顿？传统的单容器管理方式就像在小船上堆满货物，稍不注意就会"翻船"。而Docker Compose正是解决这种混乱的"集装箱管理系统"，让你的ImmortalWrt路由器变身高效家庭智能网关。

💡 核心价值：通过容器编排技术，实现多服务的统一管理、资源隔离和一键部署，让低功耗路由器发挥专业服务器的性能。

二、5分钟准备：Docker环境快速部署

在开始前，请确保你的ImmortalWrt系统已安装必要组件。通过SSH登录路由器后执行以下命令：

📌 opkg update && opkg install docker docker-compose

环境验证三步骤：

1. 检查Docker服务状态：/etc/init.d/docker status
2. 验证Compose版本：docker-compose --version
3. 查看系统配置文件：cat /etc/config/docker

⚠️ 注意事项：若启动失败，检查系统日志：logread | grep docker，常见问题为存储空间不足或内核版本不兼容。系统Docker配置文件位于package/network/services/docker/files/，可根据硬件配置调整资源限制。

三、手把手配置家庭智能网关：3服务协同案例

我们将搭建包含智能家居控制、网络安全防护和自动数据备份的三服务系统，形成完整的家庭智能生态。

步骤1：创建项目结构

mkdir -p /mnt/sda1/smart-gateway/{config,backups,logs}
cd /mnt/sda1/smart-gateway

步骤2：编写docker-compose.yml配置文件

version: '3.8'

# 自定义网络隔离不同服务
networks:
  smart-home:
    driver: bridge
  security:
    internal: true  # 安全服务不暴露外部访问

services:
  # 智能家居控制中心
  homeassistant:
    image: homeassistant/home-assistant:stable
    container_name: smart-home-core
    restart: unless-stopped
    ports:
      - "8123:8123"  # Web管理界面
    volumes:
      - ./config/homeassistant:/config
      - /etc/localtime:/etc/localtime:ro
    environment:
      - TZ=Asia/Shanghai
    networks:
      - smart-home
    deploy:
      resources:
        limits:
          cpus: '0.6'  # 限制CPU占用
          memory: 512M  # 限制内存使用

  # 网络安全防护
  adguardhome:
    image: adguard/adguardhome
    container_name: network-security
    restart: unless-stopped
    ports:
      - "53:53/tcp"   # DNS服务
      - "53:53/udp"
      - "3000:3000"   # 管理界面
    volumes:
      - ./config/adguard:/opt/adguardhome/conf
      - ./config/adguard/data:/opt/adguardhome/data
    networks:
      - security
    depends_on:
      - homeassistant

  # 自动备份服务
  duplicati:
    image: linuxserver/duplicati
    container_name: data-backup
    restart: unless-stopped
    ports:
      - "8200:8200"
    volumes:
      - ./config/duplicati:/config
      - ./backups:/backups
      - /mnt/sda1:/source  # 备份源目录
    environment:
      - PUID=0
      - PGID=0
      - TZ=Asia/Shanghai
    networks:
      - smart-home

步骤3：启动与验证服务

📌 docker-compose up -d
📌 docker-compose ps # 查看服务状态
📌 docker-compose logs -f homeassistant # 实时查看日志

📝 任务清单：

• [ ] 创建项目目录结构
• [ ] 编写docker-compose.yml配置
• [ ] 启动服务并验证运行状态
• [ ] 访问各服务Web界面完成初始化

四、避坑指南：90%用户会遇到的5个问题

故障树分析：服务异常排查路径

服务启动失败
├─ 配置错误
│  ├─ YAML格式问题 → 使用 yamllint 检查
│  └─ 端口冲突 → 执行 netstat -tulpn 查看占用
├─ 资源不足
│  ├─ 内存溢出 → 增加swap或调整memory限制
│  └─ 存储空间不足 → df -h 检查挂载点
└─ 依赖问题
   ├─ 网络不通 → 检查DNS配置
   └─ 权限不足 → 添加PUID/PGID参数

性能优化三原则：

1. 资源限制：为每个服务设置合理的CPU和内存限制，避免单个服务耗尽资源
2. 存储选择：将数据目录挂载到外部USB存储，减少内部Flash磨损
3. 镜像选择：优先使用alpine版本镜像，减少存储空间占用

五、进阶拓展：从手动管理到自动化运维

资源监控：实时掌握系统状态

创建监控脚本monitor.sh：

#!/bin/sh
echo "=== 容器资源使用情况 ==="
docker stats --no-stream --format "table {{.Name}}\t{{.CPUPerc}}\t{{.MemUsage}}"
echo "\n=== 磁盘空间 ==="
df -h | grep /mnt

添加定时任务：echo "*/10 * * * * /mnt/sda1/smart-gateway/monitor.sh >> /mnt/sda1/smart-gateway/logs/monitor.log" | crontab -

自动化部署：版本控制与更新

1. 初始化Git仓库：
   📌 git init && git add docker-compose.yml monitor.sh && git commit -m "initial setup"

2. 创建更新脚本update.sh：

#!/bin/sh
git pull
docker-compose pull
docker-compose up -d

3. 设置执行权限：chmod +x update.sh

六、总结：让路由器发挥最大价值

通过Docker Compose编排技术，我们实现了：

• 智能家居控制、网络安全、数据备份三服务协同工作
• 资源隔离与限制，避免服务间相互干扰
• 一键部署与更新，降低维护成本

官方扩展脚本和案例库提供了更多可能性：

• 扩展脚本：contrib/docker-compose/
• 社区案例库：docs/examples/multi-service/

现在，你的ImmortalWrt路由器已经成为功能强大的家庭智能网关。尝试根据需求添加更多服务，打造属于你的个性化家庭服务器吧！