automaticacore/automatica

Automatica.Core 镜像文档

镜像概述和主要用途

Automatica.Core是一款基于.NET Core开发的开源楼宇管理系统，支持跨平台运行（Windows、Mac、Linux及树莓派等）。它能够连接多种自动化系统，通过强大的规则引擎实现设备联动，并提供丰富的可视化界面，适用于智能家居中枢、小型楼宇自动化等场景。

核心功能和特性

• 多平台支持：基于.NET Core框架，可在Windows、Mac、Linux及树莓派等设备上稳定运行
• 丰富驱动生态：内置多种设备驱动，包括KNX、ZWave、ModBus、EnOcean、Ikea Tradfri、Apple HomeKit、OpenWeatherMap等
• 灵活逻辑模块：提供比较运算、数学计算、时间控制、消息通知等逻辑功能，支持自定义自动化规则
• 多数据库兼容：支持SQLite（默认）和MySQL数据库，满足不同部署环境的数据存储需求
• 容器化部署：提供官方Docker镜像，简化部署流程，支持通过Docker Compose快速搭建系统

使用场景和适用范围

• 智能家居中枢：整合各类智能设备（照明、空调、安防等），实现场景化自动化控制
• 小型楼宇管理：监控和管理办公或商业场所的能源消耗、环境参数等
• 能源监控系统：通过FroniusSymo等驱动采集太阳能发电数据，结合OpenWeatherMap实现能源分析
• 自动化实验平台：支持自定义驱动和逻辑开发，适合物联网爱好者进行二次开发

使用方法和配置说明

镜像获取

官方Docker镜像可从Docker Hub获取：

docker pull docker.xuanyuan.run/automaticacore/automatica:latest-develop

基本运行命令

console
docker run -it -p 5001:5001 --name automatica docker.xuanyuan.run/automaticacore/automatica:latest-develop

数据库配置

系统支持SQLite和MySQL两种数据库，通过环境变量进行配置。

SQLite配置（默认）

SQLite适合单机部署，需挂载数据目录以持久化存储：

console
docker run -it \
    -p 5001:5001 \
    --mount type=bind,source=~/automatica-db,target=/app/database \
    -e DATABASE_TYPE="sqlite" \
    -e "ConnectionStrings:AutomaticaDatabaseSqlite=Data Source=/app/database/automatica.core.db" \
    --name automaticacore \
    docker.xuanyuan.run/automaticacore/automatica:latest-develop

MySQL配置

适用于多实例或需要远程数据库的场景，需先部署MySQL/MariaDB服务：

console
docker run -it \
    -p 5001:5001 \
    -e DATABASE_TYPE="mysql" \
    -e "ConnectionStrings:AutomaticaDatabaseMaria=Server=<数据库地址>;User Id=<用户名>;Password=<密码>;Database=<数据库名>" \
    --name automaticacore \
    docker.xuanyuan.run/automaticacore/automatica:latest-develop

Docker Compose配置

推荐使用docker-compose配合Nginx反向代理部署：

yaml
version: '3.3'

services:
  automatica:
    image: docker.xuanyuan.run/automaticacore/automaticacore:develop-latest
    restart: always
    ports:
      - "5001:5001"
      
  nginx:
    image: docker.xuanyuan.run/automaticacore/automaticacore_proxy:develop-latest
    restart: always
    ports:
      - "80:80"
    links:
      - automatica

环境变量说明

注意事项

• 首次启动时，数据库初始化可能需要3-5分钟，请耐心等待
• 使用SQLite时务必挂载数据目录，避免容器重启导致数据丢失
• 部分驱动（如ZWave）可能需要映射USB设备，需添加--device=/dev/ttyUSB0等参数
• 系统默认端口为5001，可通过-p <本地端口>:5001映射到其他端口

相关资源

• 官方文档：[***]
• 镜像仓库：https://hub.docker.com/r/automaticacore/automaticacore
• 源代码：https://github.com/automatica-core/automatica
• 在线演示：可通过项目状态页查看演示服务运行状态