← 返回项目库

Mycodo 中文环境监控与自动化平台

Mycodo 是面向树莓派的开源环境监控与自动化平台，将传感器输入、执行器输出和控制逻辑连接起来。

本交付版本基于固定上游提交构建，提供中文 Web 管理界面、输入与输出设备管理、PID 控制器、方法曲线和测量设置。适合温室、菌菇房、水培、实验设备等需要持续采集环境数据并执行自动控制的场景。

真实界面

项目截图

共 6 张

m1-max - 实时测量 - Mycodo 8.15.12
m1-max - 输入 - Mycodo 8.15.12
m1-max - 输出 - Mycodo 8.15.12
m1-max - 功能 - Mycodo 8.15.12
m1-max - 设置: 一般 - Mycodo 8.15.12
m1-max - 测量设置 - Mycodo 8.15.12

Capabilities

核心功能

✓中文 Web 管理界面与多主题支持
✓输入设备与多通道环境测量管理
✓GPIO、PWM、命令等输出设备控制
✓PID、条件、触发器等自动化控制功能
✓实时测量、历史数据和可配置仪表盘
✓方法曲线与 PID 设定点跟踪
✓告警、日志、备份和系统配置工具
✓REST API 与可扩展的自定义模块结构

适用场景

温室和菌菇房的温度、湿度自动调节
水培、鱼缸和栽培系统的传感器监测与泵阀控制
实验设备、烘箱或热循环设备的设定点控制
树莓派物联网项目的本地化环境数据采集

适合谁

温室与种植运营者、物联网开发者、实验室工程师、树莓派爱好者和需要环境自动化的技术服务商。

商业化思路

开源自托管；可围绕部署、硬件接入、控制策略配置和持续运维提供服务。

你会拿到什么

  • ✓固定提交版本的完整 GPLv3 源码包
  • ✓中文核心界面真实运行截图与交互验收证据
  • ✓依赖安装、编译检查和许可证门禁结果
  • ✓本地预览演示数据说明与已知限制

部署流程

  1. 1在隔离 Python 3.9+ 环境中安装 install/requirements.txt 依赖，并按目标硬件补齐 GPIO、传感器与 InfluxDB 服务。
  2. 2执行 Mycodo 数据库初始化，配置管理员、输入、输出、控制器和测量存储，再使用项目提供的服务启动方式运行 Web UI。
  3. 3上线前在目标树莓派上连接实际硬件，验证采集值、输出状态、PID 控制方向、告警和备份恢复。

真实验证结果

已通过 6 个真实运行中文界面、HTTP、可见正文、控制台、坏图和横向溢出质量门。

部署前须知

本地预览使用 SQLite 演示数据库，演示设备不会连接真实 GPIO；实时页面在没有 Mycodo daemon 和 InfluxDB 时会显示无数据。上游方法列表引用的可选 Highcharts 文件未包含在本仓库，因此本交付将方法编辑作为交互证据而非目录截图。

部署难度

较高

最低配置

建议使用 Debian 系树莓派或兼容 Linux 主机，并准备 Python 3.9+、SQLite/InfluxDB 与 GPIO 或其他传感器接口；本地预览可在 macOS 上运行。

开源许可证

GNU General Public License v3.0

最后验证

2026-08-31

技术栈

PythonFlaskSQLAlchemySQLiteFlask-BabelBootstrap

授权说明

源码包原样保留上游 LICENSE.txt 和版权信息。本站仅按 GPLv3 许可提供源码再分发，并披露本交付中的中文翻译补齐与本地预览适配；下游再分发须继续遵守 GPLv3。

Release notes

版本记录

1 个已发布版本

vcn-4e7ba6ea41d4 当前推荐

固定上游提交的首个中文交付版本；补齐核心中文界面文案和本地预览适配，加入可复现演示数据并完成真实页面验收。

部署要求：Python 3.9+；本地预览可使用 SQLite，生产环境需按硬件和采集规模配置 GPIO、InfluxDB、系统服务及安全访问策略。

已知问题：演示数据库和登录审计路径仅用于本地预览，不随源码包发布；真实传感器读数、GPIO 控制、后台 daemon 和 InfluxDB 需要在目标硬件环境单独验收。

登录后领取