kamasoutra/docker-magicmirror

docker-magicmirror 镜像文档

镜像概述

docker-magicmirror 是一个基于 bastilimbach/docker-magicmirror 构建的个人定制化 Docker 镜像，用于快速部署开源智能镜面项目 MagicMirror。该镜像继承了基础镜像的核心功能，并支持个人化配置，可实现时间、天气、新闻、日历等信息的集成显示，适用于构建家庭或办公场景的智能信息展示系统。

核心功能与特性

基于基础镜像的核心能力

• 模块化架构：采用插件化设计，支持通过模块扩展功能（如天气、新闻、交通等）
• Web界面展示：内置Web服务器，可通过浏览器访问或投屏显示
• 响应式布局：自适应不同屏幕尺寸，支持自定义CSS样式调整界面

个人定制化特点

• 基于官方基础镜像优化，适配个人使用场景的默认配置
• 简化部署流程，减少手动配置步骤
• 保留基础镜像的插件兼容性，支持用户自行扩展功能模块

使用场景

• 家庭智能镜面：部署于浴室镜、玄关镜等位置，显示时间、天气、日程提醒
• 办公信息屏：在办公区域展示团队日历、会议提醒、新闻资讯
• 个人助理设备：作为桌面或壁挂式信息中心，集成多源信息展示

使用方法

基本部署（docker run）

通过以下命令快速启动容器：

bash
docker run -d \
  --name magicmirror \
  -p 8080:8080 \
  -v /path/to/your/config:/opt/magicmirror/config \
  -v /path/to/your/modules:/opt/magicmirror/modules \
  --restart unless-stopped \
  <镜像名称>

参数说明：

• -p 8080:8080：映射容器内Web服务端口（默认8080）
• -v /path/to/your/config:/opt/magicmirror/config：挂载本地配置目录，用于自定义config.js
• -v /path/to/your/modules:/opt/magicmirror/modules：挂载本地模块目录，添加自定义插件

配置文件说明

容器启动时需挂载自定义配置文件config.js（位于/opt/magicmirror/config目录），用于配置显示模块及参数。基础配置示例：

javascript
{
  modules: [
    {
      module: "clock",
      position: "top_left"
    },
    {
      module: "weather",
      position: "top_right",
      config: {
        location: "Beijing",
        apiKey: "YOUR_OPENWEATHER_API_KEY"
      }
    }
  ]
}

扩展模块安装

通过挂载modules目录添加自定义模块：

1. 将第三方模块文件放入本地/path/to/your/modules目录
2. 在config.js中配置模块参数即可启用

注意事项

• 该镜像为个人定制版本，部分配置可能与官方基础镜像存在差异，建议参考基础镜像文档（https://hub.docker.com/r/bastilimbach/docker-magicmirror%EF%BC%89%E8%BF%9B%E8%A1%8C%E6%89%A9%E5%B1%95
• 首次启动需确保挂载的配置文件格式正确，否则可能导致容器启动失败
• 如需持久化数据（如模块缓存），可额外挂载/opt/magicmirror/data目录