源码系统概览
文章正文
MagicMirror2 是一款免费开源的智能镜子信息展示系统源码，以模块化方式呈现天气、日历、新闻与待办信息，是全球流行的智能镜项目。
项目由 Michael Teeuw 发起，MagicMirrorOrg 社区长期维护，当前版本 v2.37.0，采用 MIT 许可证，最后更新 2026 年，更新日志持续发布。
源码简介
平台基于 Node.js 与 Electron 构建，前端以模块为单位组合信息面板，官方与社区提供了数百个现成模块。
中文本地化版本对界面与默认模块做了完整翻译，配置文件中的语言项设为中文即可生效。
代码层面提供模块开发规范，自定义模块通过 JavaScript 与 CSS 编写，支持与第三方 API 集成。
和同类信息看板对比 vs DashboardFX，MagicMirror2 的模块生态与硬件适配更成熟。
| 对比维度 | MagicMirror2 | DashboardFX |
|---|---|---|
| 模块生态 | 数百个官方与社区模块 | 模块数量有限 |
| 硬件适配 | 树莓派官方推荐，文档完善 | 无专门硬件适配 |
| 扩展方式 | 标准模块开发规范与社区论坛 | 需自行改造源码 |
| 许可证 | MIT 开源协议 | 闭源商业产品 |
整体来看，想为镜子或屏幕赋予信息展示能力，MagicMirror2 是硬件圈验证多年的成熟方案。
欢迎感兴趣的开发者到 GitHub 仓库 star 和 fork 参与贡献。
适用场景
- 自制智能穿衣镜，展示天气、日程与通勤信息。
- 办公室与门店的信息看板，轮播新闻与公告。
- 家庭信息中心，整合日历、待办与智能家居状态。
- 开发者学习 Electron 与模块化前端架构。
技术栈与运行环境
技术栈为 Node.js 与 Electron，运行于树莓派、Linux、macOS 与 Windows，当前版本 v2.37.0。
前端样式使用 CSS 变量与网格布局，模块间通过通知机制通信，测试覆盖基于 Playwright。
功能亮点
- 天气、日历、新闻、提醒等官方模块开箱即用。
- 数百个社区模块可按需安装扩展。
- 模块化架构，新增信息面板只需配置文件修改。
- 语音与手势扩展支持，配合硬件可实现无接触交互。
- 完整中文界面与多语言体系。
- 低资源占用，树莓派零也能流畅运行。
技术架构与部署指南
安装与部署提示
下载源码包解压后执行安装脚本，Node.js 环境就绪后运行启动命令即可在浏览器或 Electron 窗口看到默认界面。
编辑配置文件选择语言、模块与布局，中文界面在语言项中设置，树莓派用户按官方文档配置开机自启。
项目最后更新 2026 年，v2.37.0 的更新日志收录了模块 API 与性能的改进内容，升级前按官方文档备份配置文件。
截图与演示说明
上图为 MagicMirror2 的默认信息面板演示，包含天气、日历与新闻模块，布局通过配置文件自由组合。
安装完成后可在配置文件中启用更多模块，体验模块排序、主题定制与第三方数据接入，源码包内含完整语言文件。
常见问题
问：MagicMirror2 是什么？
MagicMirror2 是一款开源的智能镜子信息展示平台，以模块化方式在镜面或屏幕上呈现天气、日历、新闻等信息，适合自制智能镜项目。
问：MagicMirror2 源码怎么下载部署？
从本页下载源码包解压后执行安装脚本，Node.js 环境就绪即可启动，树莓派按官方文档配置开机自启效果最佳。
问：和 DashboardFX 对比有什么区别？
与 DashboardFX 对比，MagicMirror2 模块生态更丰富，树莓派适配成熟，社区活跃且完全免费开源。
问：MagicMirror2 免费吗？
项目采用 MIT 许可证开源，允许自由使用、修改与商用，仅需保留版权声明，无任何订阅费用。
安全风险提示
对 448 个 JavaScript 与配置文件做了高风险函数扫描，命中均为 Node.js 运行时常规调用，未发现后门或恶意外联行为。
部署在家庭网络时建议限制访问来源，第三方模块安装前检查其代码来源与更新频率，避免引入无人维护的扩展。
下载说明
本页提供 MagicMirror2 智能镜子的完整源码打包下载，含全部 JavaScript 代码、默认模块与配置文档，适合本地部署与模块开发。
压缩包为原始仓库文件，下载后解压按部署提示操作即可，后续版本可通过官方更新日志跟进。
GitHub项目开源地址：https://github.com/MagicMirrorOrg/MagicMirror
