amorphic/sparkcc-hq

sparkcc-hq

基于CodeIgniter 3框架的互联网设备连接中央枢纽，提供设备通信、用户认证、模块化功能扩展等能力。

镜像概述

sparkcc-hq是一个预集成常用插件的CodeIgniter 3应用框架，旨在作为联网设备的中央管理节点，支持设备数据交互、用户权限控制与模块化功能扩展。

核心功能

• Ion-Auth认证：提供用户身份验证与权限管理能力
• REST Server接口：通过/api路径处理设备通信请求
• HMVC模块化架构：通过/modules目录实现功能模块的独立安装与运行（菜单配置位于config/menu.php）
• 插件与钩子机制：支持模块插入JavaScript/CSS资源，类似WordPress的扩展方式
• 模板与小部件：使用Template.php库渲染HTML，结合小部件实现重复布局（如页面盒子、子组件）
• Inspinia Admin主题：采用Inspinia Admin HTML主题，已拆分为小部件集成到框架中

使用场景

• 物联网设备管理平台
• 小型企业内部设备数据采集系统
• 设备远程监控与交互平台

配置说明

环境变量参数

需设置以下环境变量配置核心参数：

• SPARK_BASE_URL：框架基础URL（对应$config['base_url']）
• MYSQL_HOST：MySQL数据库地址
• MYSQL_USER：MySQL数据库用户名
• MYSQL_PASSWORD：MySQL数据库密码
• MYSQL_DATABASE：MySQL数据库名称
• SMTP_HOST：SMTP服务器地址
• SMTP_PORT：SMTP服务器端口
• SMTP_USER：SMTP认证用户名
• SMTP_PASS：SMTP认证密码

数据库安装

导入/application/sql/*.sql文件到新建的MySQL数据库中。

特殊路径说明

• /uploads目录为外部存储（用于托管上传文件如图片），Docker镜像本身不存储文件。

部署示例

Docker Run命令

bash
docker run -d \
  --name sparkcc-hq \
  -p 8080:80 \
  -e SPARK_BASE_URL=http://your-domain.com \
  -e MYSQL_HOST=mysql-host \
  -e MYSQL_USER=db-user \
  -e MYSQL_PASSWORD=db-pass \
  -e MYSQL_DATABASE=sparkcc_db \
  -e SMTP_HOST=smtp.example.com \
  -e SMTP_PORT=587 \
  -e SMTP_USER=smtp-user@example.com \
  -e SMTP_PASS=smtp-password \
  amorphic/sparkcc-hq

部署后访问http://localhost:8080即可进入应用。