bastilimbach/docker-magicmirror

MagicMirror² Docker镜像

镜像概述

MagicMirror²是一款开源模块化智能镜子平台，通过该Docker镜像可轻松部署服务器模式的MagicMirror²，无需图形界面即可运行，将普通镜子转变为集日程、天气、新闻等功能于一体的个人助手。

核心功能

• 模块化架构：支持丰富的可安装模块，灵活扩展功能
• 服务器模式：无需图形界面，通过浏览器访问即可使用
• 自定义配置：支持挂载配置文件、模块目录和自定义CSS
• 时区同步：通过环境变量或卷挂载同步主机时区
• 版本管理：提供latest（稳定版）、develop（开发版）及特定版本标签

使用场景

• 家庭智能镜子：走廊、浴室等场景，显示个人日程、天气提醒
• 个人助手终端：通过浏览器访问获取实时信息
• 开发测试：快速部署MagicMirror²进行模块开发和测试

配置说明

环境变量

卷挂载

构建参数

配置文件修改要点

若自定义配置，需确保以下属性设置正确：

javascript
var config = {
    address: "0.0.0.0", // 允许所有接口访问
    port: 8080, // 与Docker端口映射一致
    ipWhitelist: [] // 允许所有IP访问（或设置为Docker子网）
}

Docker部署示例

Docker Run命令

bash
docker run  -d \
    --publish 80:8080 \
    --restart always \
    --volume ~/magic_mirror/config:/opt/magic_mirror/config \
    --volume ~/magic_mirror/modules:/opt/magic_mirror/modules \
    --volume /etc/localtime:/etc/localtime:ro \
    --name magic_mirror \
    bastilimbach/docker-magicmirror

Docker Compose配置

yml
version: '3'
services:
  magicmirror:
    container_name: magicmirror
    image: bastilimbach/docker-magicmirror
    restart: unless-stopped
    volumes:
      - /etc/localtime:/etc/localtime:ro
      - ~/magic_mirror/config:/opt/magic_mirror/config
      - ~/magic_mirror/modules:/opt/magic_mirror/modules
    ports:
      - 8888:8080

注意事项

• 时区设置：若使用Raspberry Pi显示镜像内容，需在主机上通过sudo raspi-config选择Localisation options设置正确时区
• 自定义CSS：需提前创建custom.css文件再挂载，避免Docker生成文件夹
• 版本选择：根据需求选择latest（稳定）、develop（开发）或特定版本标签
• 端口映射：修改端口时需同步配置文件中的port参数和Docker命令的publish参数