用Docker Compose打造家庭智能媒体中心：从混乱到有序的路由器改造指南

一、家庭网络的"设备混战"：你的路由器是否不堪重负？

周末的家庭影院时间总是伴随着一阵手忙脚乱：客厅的智能电视需要连接NAS播放电影，孩子的平板要访问家庭相册，妻子的笔记本电脑正在备份工作文件——而这一切都依赖于那台小小的路由器。当你同时启动下载工具、文件共享和智能家居控制服务时，是否经常遇到服务崩溃、连接中断或设备冲突？

这种"设备混战"的根源在于传统路由器的单服务管理模式：每个应用需要单独配置、独立启动，不仅占用大量系统资源，还难以协调服务间的依赖关系。本文将通过Docker Compose技术，把你的ImmortalWrt路由器改造成一个井然有序的家庭服务中心，让所有设备和谐共处。

💡 经验技巧：家庭网络中常见的服务冲突往往源于端口占用和资源竞争，Docker的容器隔离技术能从根本上解决这个问题。

二、方案设计：Docker Compose如何驯服复杂服务？

什么是Docker Compose？

Docker Compose是一个用于定义和运行多容器Docker应用的工具。通过一个YAML格式的配置文件，你可以声明式地定义所有服务组件，然后使用单个命令创建和启动所有服务。这种方式特别适合在资源有限的路由器环境中管理多个服务。

核心优势解析

![Docker Compose工作原理]

• 统一管理：通过一个配置文件管理所有服务，避免分散配置的混乱
• 依赖处理：自动处理服务间的启动顺序和依赖关系
• 资源隔离：每个服务运行在独立容器中，避免相互干扰
• 一键操作：单个命令即可完成所有服务的启动、停止和重启

核心配置项详解

⚙️ 服务定义卡片

services:
  web:              # 服务名称，自定义标识
    image: nginx     # 容器镜像，格式为[名称]:[版本]
    ports:           # 端口映射，格式为"宿主机端口:容器端口"
      - "8080:80"
    volumes:         # 数据卷挂载，实现持久化存储
      - ./html:/usr/share/nginx/html
    restart: unless-stopped  # 重启策略，确保服务持续运行

⚙️ 网络配置卡片

networks:
  media_network:    # 自定义网络名称
    driver: bridge  # 网络驱动类型，bridge为默认值

⚙️ 数据卷配置卡片

volumes:
  db_data:          # 命名卷，用于持久化数据库数据
  media_files:      # 命名卷，用于存储媒体文件

💡 经验技巧：使用命名卷（Named Volume）而非绑定挂载（Bind Mount）可以获得更好的移植性和管理体验，尤其适合路由器这类嵌入式设备。

三、实践准备：搭建Docker环境

在开始部署多容器应用前，需要确保你的ImmortalWrt系统已安装Docker及Docker Compose环境。

🔧 第一步：更新软件源并安装Docker

opkg update
opkg install docker docker-compose

🔧 第二步：启动Docker服务并设置开机自启

/etc/init.d/docker start
/etc/init.d/docker enable

🔧 第三步：验证安装是否成功

docker --version
docker-compose --version

如果输出类似Docker version 20.10.x, build xxxxx和docker-compose version 2.x.x的信息，则表示安装成功。

Docker服务的配置文件位于package/utils/docker/files/docker.init，如需高级配置可在此文件中调整。

💡 经验技巧：在资源有限的路由器上，建议禁用Docker的自动更新功能，避免占用过多系统资源。可通过修改/etc/config/docker文件中的相关配置实现。

四、分步实施：打造家庭媒体中心

场景设计：家庭媒体中心架构

我们将构建一个包含以下服务的家庭媒体中心：

• 网页控制台（WebUI）：提供可视化管理界面
• 媒体共享服务（Samba）：实现跨设备文件共享
• 下载服务（Transmission）：后台下载媒体文件
• 媒体服务器（Plex）：组织和流式传输媒体内容

这些服务将通过Docker Compose统一管理，形成一个协同工作的媒体生态系统。

实施步骤

🔧 第一步：创建项目目录结构

mkdir -p /mnt/sda1/media-center/{config,downloads,media}
cd /mnt/sda1/media-center

这个目录结构将用于存储所有服务的配置文件和数据：

• config：存放各服务的配置文件
• downloads：Transmission下载文件存放位置
• media：媒体文件存储目录，将通过Samba共享

🔧 第二步：编写docker-compose.yml配置文件

创建并编辑配置文件：

version: '3'

services:
  # 网页控制台
  webui:
    image: linuxserver/webtop
    container_name: media-webui
    ports:
      - "3000:3000"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./config/webui:/config
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
    restart: unless-stopped
    networks:
      - media_network

  # 媒体文件共享
  samba:
    image: dperson/samba
    container_name: media-samba
    ports:
      - "139:139"
      - "445:445"
    volumes:
      - ./media:/media
    command: '-s "Media:/media:rw:guest"'
    restart: unless-stopped
    networks:
      - media_network

  # 下载服务
  transmission:
    image: linuxserver/transmission
    container_name: media-transmission
    ports:
      - "9091:9091"
      - "51413:51413"
      - "51413:51413/udp"
    volumes:
      - ./config/transmission:/config
      - ./downloads:/downloads
      - ./media:/media
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
      - TRANSMISSION_WEB_HOME=/combustion-release/
    restart: unless-stopped
    networks:
      - media_network

  # 媒体服务器
  plex:
    image: linuxserver/plex
    container_name: media-plex
    ports:
      - "32400:32400"
    volumes:
      - ./config/plex:/config
      - ./media:/media
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
      - VERSION=docker
    restart: unless-stopped
    networks:
      - media_network

networks:
  media_network:
    driver: bridge

volumes:
  config:
  downloads:
  media:

🔧 第三步：启动服务

docker-compose up -d

这个命令将自动拉取所需镜像并启动所有服务。首次运行可能需要几分钟时间，具体取决于你的网络速度。

🔧 第四步：验证服务状态

docker-compose ps

正常情况下，所有服务的状态都应显示为"Up"。如果有服务显示为"Exit"，可以通过以下命令查看日志排查问题：

docker-compose logs <服务名称>

![服务状态检查]

💡 经验技巧：对于资源有限的路由器，建议不要同时启动所有服务。可以通过docker-compose up -d <服务名称>命令单独启动需要的服务。

五、避坑指南：常见问题解决方案

1. 端口冲突问题

现象：服务启动失败，日志中出现"address already in use"错误。

解决方案：

• 检查系统中已占用的端口：netstat -tuln
• 修改配置文件中的端口映射，例如将"8080:80"改为"8081:80"
• 停止占用冲突端口的系统服务：/etc/init.d/<服务名> stop

2. 存储容量不足

现象：服务运行缓慢或崩溃，日志中出现"no space left on device"错误。

解决方案：

• 检查磁盘空间使用情况：df -h
• 清理未使用的Docker镜像：docker system prune -a
• 将数据目录迁移到外部存储设备，如USB硬盘

3. 权限问题

现象：服务无法读写文件，日志中出现"permission denied"错误。

解决方案：

• 调整宿主机目录权限：chmod -R 775 ./media
• 在配置文件中修改PUID和PGID为当前用户的ID：id -u和id -g
• 使用user: root参数以root权限运行容器（不推荐，仅作为临时解决方案）

💡 经验技巧：定期执行docker system prune -a可以清理未使用的镜像和容器，释放宝贵的存储空间。建议每周执行一次。

六、场景扩展：从媒体中心到家庭服务器

你的路由器媒体中心可以轻松扩展为功能全面的家庭服务器，以下是一些实用的扩展方向：

1. 智能家居控制中心

添加Home Assistant服务，实现对智能家居设备的统一管理：

homeassistant:
  image: homeassistant/home-assistant
  container_name: home-assistant
  ports:
    - "8123:8123"
  volumes:
    - ./config/homeassistant:/config
  environment:
    - TZ=Asia/Shanghai
  restart: unless-stopped
  networks:
    - media_network

2. 家庭监控系统

通过Zoneminder服务实现家庭安防监控：

zoneminder:
  image: dlandon/zoneminder.master
  container_name: zoneminder
  ports:
    - "8080:80"
  volumes:
    - ./config/zoneminder:/config
    - ./media/footage:/var/cache/zoneminder
  environment:
    - TZ=Asia/Shanghai
    - PUID=1000
    - PGID=1000
  restart: unless-stopped
  networks:
    - media_network

3. 私有云存储

添加Nextcloud服务，打造个人私有云：

nextcloud:
  image: nextcloud
  container_name: nextcloud
  ports:
    - "8081:80"
  volumes:
    - ./config/nextcloud:/var/www/html
    - ./media/cloud:/var/www/html/data
  environment:
    - MYSQL_PASSWORD=nextcloud
    - MYSQL_DATABASE=nextcloud
    - MYSQL_USER=nextcloud
    - MYSQL_HOST=nextcloud-db
  restart: unless-stopped
  depends_on:
    - nextcloud-db
  networks:
    - media_network

nextcloud-db:
  image: mariadb
  container_name: nextcloud-db
  volumes:
    - ./config/nextcloud-db:/var/lib/mysql
  environment:
    - MYSQL_ROOT_PASSWORD=nextcloud
    - MYSQL_PASSWORD=nextcloud
    - MYSQL_DATABASE=nextcloud
    - MYSQL_USER=nextcloud
  restart: unless-stopped
  networks:
    - media_network

💡 经验技巧：扩展服务时，注意路由器的硬件资源限制。建议先添加必要服务，观察系统负载后再逐步扩展其他功能。

七、进阶路线图：从新手到专家

第1周：基础部署
  - 完成Docker环境搭建
  - 部署基础媒体服务组合

第2-3周：系统优化
  - 配置资源限制
  - 实现自动备份
  - 设置监控告警

第1-2个月：功能扩展
  - 添加智能家居控制
  - 部署私有云存储
  - 实现多设备同步

第3-6个月：高级应用
  - 配置服务高可用
  - 实现跨网络访问
  - 优化能源消耗

通过这个进阶路线，你可以在半年内将普通路由器改造成功能强大的家庭服务器，充分发挥ImmortalWrt系统的潜力。记住，家庭服务器的构建是一个持续优化的过程，根据实际需求和使用体验不断调整配置，才能打造最适合自己的家庭网络生态。

八、总结

本文介绍了如何使用Docker Compose在ImmortalWrt路由器上构建家庭媒体中心，通过容器化技术解决了多服务管理的复杂性。从环境搭建到服务部署，再到问题排查和功能扩展，我们覆盖了构建家庭服务器的全过程。

Docker Compose的优势在于它的简洁性和灵活性，让即使是没有专业背景的用户也能轻松管理复杂的服务组合。随着智能家居和家庭网络需求的增长，这种技术将成为家庭网络管理的必备技能。

无论你是想打造家庭媒体中心、私有云存储，还是智能家居控制中心，Docker Compose都能为你提供一个可靠、灵活的基础平台。现在就动手改造你的路由器，开启智能家居生活的新篇章吧！