IOTstack 安装与配置指南

1. 项目基础介绍

IOTstack 是一个基于 Docker 的物联网应用栈项目，旨在帮助用户在 Raspberry Pi 上快速搭建和运行物联网应用。项目提供了一个预配置的 Docker Compose 文件，使得搭建过程变得简单快捷。主要编程语言为 Shell 脚本，同时也包含了一些 Dockerfile 文件。

2. 项目使用的关键技术和框架

• Docker: 一个开源的应用容器引擎，可以打包、发布和运行应用。
• Docker Compose: 一个用于定义和运行多容器 Docker 应用程序的工具。
• Node-RED: 一个基于 Node.js 的可视化编程工具，用于连接硬件设备、API 和在线服务。
• Grafana: 一个开源的可视化和分析平台，用于监控和可视化物联网数据。
• InfluxDB: 一个开源的时间序列数据库，适用于监控和物联网应用。
• Postgres: 一个功能强大的开源对象-关系型数据库系统。
• Mosquitto: 一个开源的 MQTT 代理，用于物联网消息传递。
• 以及其他如 Portainer、Adminer、openHAB、Home Assistant 等服务和工具。

3. 项目安装和配置准备工作

在开始安装之前，请确保您已经满足了以下要求：

• 硬件: 一台 Raspberry Pi 3B 或 4B。
• 操作系统: Raspbian (Buster) 或其他基于 Debian 的操作系统。
• 网络: 确保您的 Raspberry Pi 能够连接到互联网。
• 权限: 您需要有 sudo 权限来执行安装脚本。

安装步骤

1. 安装 Git

   在您的 Raspberry Pi 上打开终端，输入以下命令来安装 Git：

   sudo apt-get update
   sudo apt-get install git
   

2. 克隆项目仓库

   使用 Git 克隆 IOTstack 项目到您的 Raspberry Pi：

   git clone https://github.com/gcgarner/IOTstack.git
   

   克隆完成后，项目文件夹会出现在您的当前目录下。

3. 进入项目目录

   切换到 IOTstack 项目目录：

   cd ~/IOTstack
   

4. 运行安装菜单

   运行项目中的菜单脚本来安装 Docker 和其他依赖项：

   ./menu.sh
   

   跟随菜单中的提示操作，选择您需要安装的服务。

5. 构建 Docker Compose 文件

   菜单将引导您选择需要的服务，并生成一个 docker-compose.yml 文件。

6. 启动服务

   在项目目录中，运行以下命令来启动所有服务：

   docker-compose up -d
   

   请注意，首次启动可能会花费较长时间，因为 Docker 需要下载所有所需的服务镜像。

7. 访问服务

   根据 docker-compose.yml 文件中定义的配置，您可以通过浏览器访问如 Node-RED、Grafana 等服务的 Web 界面。

完成以上步骤后，您的 IOTstack 应该已经成功运行，您可以开始探索和开发您的物联网应用了。