mumblebaj/magicmirror

MagicMirror Docker镜像

这是一个轻量级、可自定义的MagicMirror² Docker镜像，专为树莓派和ARM兼容设备设计。您可以通过卷挂载轻松扩展MagicMirror的配置、样式和模块。

🚀 核心功能

• 基于Debian Trixie（支持ARM架构）
• 集成MagicMirror² 2.37.0版本
• 预装Node.js 22 LTS
• 以服务器模式运行MagicMirror²
• 支持挂载自定义config.js、custom.css和模块目录
• 最小化镜像体积和构建依赖

🧰 使用场景

• 家庭智能镜子：展示时间、天气、日历等日常信息
• 办公信息终端：显示团队日程、公告或监控数据
• 个人学习助手：展示待办事项、新闻或学习资源

📋 配置说明

1. 安装Docker

在运行容器前，请先安装Docker：

树莓派（Raspbian/Ubuntu）

bash
# 更新系统
sudo apt-get update && sudo apt-get upgrade -y
# 安装Docker
curl -fsSL https://get.docker.com -o get-docker.sh && sudo sh get-docker.sh
# 将用户加入docker组（可选）
sudo usermod -aG docker $USER
# 启动并设置开机自启
sudo systemctl start docker && sudo systemctl enable docker
# 验证安装
docker --version

Ubuntu（桌面/服务器）

bash
# 更新系统
sudo apt-get update && sudo apt-get upgrade -y
# 安装依赖
sudo apt-get install apt-transport-https ca-certificates curl software-properties-common -y
# 添加GPG密钥
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
# 添加仓库
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
# 安装Docker
sudo apt-get update && sudo apt-get install docker-ce -y
# 验证安装
docker --version

Windows（Docker Desktop）

1. 从https://www.docker.com/%E4%B8%8B%E8%BD%BDDocker Desktop安装包
2. 运行安装程序，按提示启用WSL 2
3. 打开命令提示符验证：docker --version

macOS（Docker Desktop）

1. 从https://www.docker.com/%E4%B8%8B%E8%BD%BDDocker Desktop安装包
2. 将Docker应用拖入Applications文件夹
3. 启动Docker并验证：docker --version

2. 文件夹结构

创建如下目录结构：

my-magic-mirror-container  # 自定义名称
├── config/                # 存放config.js
│   └── config.js
├── custom-css/            # 存放custom.css
│   └── custom.css
├── modules/               # 存放自定义模块
│   └── MMM-ExampleModule/

3. Docker Compose配置（推荐）

在根目录创建docker-compose.yml：

yaml
services:
  magicmirror:
    image: docker.xuanyuan.run/mumblebaj/magicmirror:latest
    container_name: magicmirror
    ports:
      - "8080:8080"
    volumes:
      - ./config:/home/pi/MagicMirror/config
      - ./custom-css:/home/pi/MagicMirror/css/custom
      - ./modules:/home/pi/MagicMirror/custom-modules
    restart: unless-stopped

4. 启动容器

bash
docker compose up -d

5. 访问应用

打开浏览器访问：http://localhost:8080（确保config.js中ipWhitelist为空数组）

6. 停止容器

bash
docker compose down -v

✅ 许可证

本项目基于MIT许可证，详情见LICENSE文件。

🙋‍♂️ 贡献

欢迎提交PR和问题，随时fork并改进！

📝 LICENSE（MIT）

text
MIT License

Copyright (c) 2025 [mumblebaj]

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights 
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 
copies of the Software, and to permit persons to whom the Software is 
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in 
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 
SOFTWARE.