Thinger.io Server Docker镜像文档

1. 镜像概述和主要用途

Thinger.io 是一个开源物联网（IoT）平台，本 Docker 镜像提供了自托管 Thinger.io 服务器的部署方案。通过该镜像，用户可快速搭建私有物联网服务器，实现设备管理、数据采集、处理与可视化等核心功能，适用于需要数据本地化、隐私保护或自定义物联网架构的场景。

2. 核心功能和特性

• 设备管理：支持物联网设备的注册、认证、状态监控及远程控制，兼容多类型硬件设备。
• 数据处理：实时接收设备传感器数据，提供数据存储、查询与分析能力，支持时间序列数据管理。
• API 支持：提供 RESTful API 和 WebSocket 接口，便于与第三方系统（如应用服务、数据分析平台）集成。
• 安全机制：内置设备密钥认证、用户令牌管理、HTTPS 加密等安全功能，保障设备通信与数据传输安全。
• 规则引擎：允许配置自定义业务规则，实现基于设备数据的自动化场景（如阈值告警、设备联动）。
• 轻量化部署：容器化设计简化部署流程，支持跨平台运行（Linux、Windows、macOS），资源占用低。

3. 使用场景和适用范围

• 企业物联网项目：需本地化管理设备数据的企业内部物联网系统，满足数据合规要求。
• 数据隐私场景：对数据存储位置有严格限制的领域（如医疗、工业控制），避免数据上传至第三方云平台。
• 教育与研究：物联网教学、实验环境搭建，或物联网技术研究的原型验证。
• 小型物联网应用：个人开发者或小型团队快速构建物联网应用，降低基础设施成本。

4. 使用方法和配置说明

4.1 前提条件

• 已安装 Docker Engine（20.10+ 版本推荐）及 Docker Compose（可选，用于多容器管理）。
• 宿主机需满足基本资源要求：至少 1GB RAM、10GB 可用磁盘空间，网络环境支持设备接入（开放所需端口）。

4.2 镜像获取

通过 Docker 命令拉取镜像（以下示例使用占位镜像名，实际请替换为官方镜像地址）：

docker pull thinger/server:latest

4.3 基本部署命令

4.3.1 快速启动（默认配置）

docker run -d \
  --name thinger-server \
  -p 80:80 \    # HTTP 端口映射
  -p 443:443 \  # HTTPS 端口映射
  -v thinger_data:/app/data \  # 数据持久化卷
  thinger/server:latest

4.3.2 自定义配置启动

通过环境变量调整核心参数（如管理员账户、数据库配置）：

docker run -d \
  --name thinger-server \
  -p 8080:80 \  # 自定义宿主机 HTTP 端口
  -p 8443:443 \ # 自定义宿主机 HTTPS 端口
  -e ADMIN_USER=iot_admin \          # 管理员用户名
  -e ADMIN_PASSWORD=SecurePass123! \ # 管理员密码
  -e DB_TYPE=mysql \                 # 数据库类型（sqlite/mysql/postgres）
  -e DB_HOST=mysql-host \            # 数据库主机（非 sqlite 时必填）
  -e DB_USER=thinger_dbuser \        # 数据库用户名
  -e DB_PASSWORD=dbpass \            # 数据库密码
  -v $(pwd)/thinger_data:/app/data \ # 宿主机目录挂载（数据持久化）
  thinger/server:latest

4.4 Docker Compose 配置示例

适用于集成外部数据库（如 MySQL）的场景：

version: '3.8'

services:
  thinger-server:
    image: thinger/server:latest
    container_name: thinger-server
    restart: always
    ports:
      - "80:80"   # HTTP 端口映射
      - "443:443" # HTTPS 端口映射
    environment:
      - ADMIN_USER=admin
      - ADMIN_PASSWORD=StrongPassword123!
      - DB_TYPE=mysql
      - DB_HOST=mysql-db
      - DB_PORT=3306
      - DB_NAME=thinger_db
      - DB_USER=thinger_user
      - DB_PASSWORD=db_password
    volumes:
      - thinger_data:/app/data  # 服务器数据卷
    depends_on:
      - mysql-db  # 依赖 MySQL 数据库容器

  mysql-db:
    image: mysql:8.0
    container_name: thinger-mysql
    restart: always
    environment:
      - MYSQL_ROOT_PASSWORD=root_password
      - MYSQL_DATABASE=thinger_db
      - MYSQL_USER=thinger_user
      - MYSQL_PASSWORD=db_password
    volumes:
      - mysql_data:/var/lib/mysql  # 数据库数据卷

volumes:
  thinger_data:  # Thinger.io 服务器数据
  mysql_data:    # MySQL 数据库数据

启动命令：

docker-compose up -d

4.5 环境变量配置说明

4.6 数据持久化

通过挂载卷确保配置、设备数据及日志不丢失：

• 命名卷（推荐）：由 Docker 管理，自动创建并维护：

  docker run -d \
    --name thinger-server \
    -v thinger_data:/app/data \  # 命名卷挂载（数据存储路径）
    thinger/server:latest
  

• 宿主机目录挂载：手动指定宿主机目录，便于直接访问数据：

  mkdir -p ./thinger_data
  docker run -d \
    --name thinger-server \
    -v $(pwd)/thinger_data:/app/data \  # 宿主机目录挂载
    thinger/server:latest
  

5. 注意事项

• 安全加固：生产环境需修改默认管理员密码，配置 SSL 证书（替换容器内默认证书），并限制容器网络访问权限。
• 性能优化：设备数量超过 100 台时，建议使用 MySQL 或 PostgreSQL 数据库，避免 SQLite 性能瓶颈。
• 版本更新：更新镜像前需备份数据卷（thinger_data），避免数据丢失。
• 端口冲突：若宿主机 80/443 端口被占用，通过 -p 参数映射至其他端口（如 -p 8080:80）。

6. 故障排除

• 容器启动失败：检查环境变量配置（如数据库连接参数）、端口占用情况（netstat -tuln）及数据卷权限（宿主机目录需可读可写）。
• 设备连接失败：确认服务器端口已开放（防火墙配置），设备密钥与服务器地址匹配，且网络连通性正常。
• 日志查看：通过 docker logs -f thinger-server 查看实时日志，定位错误原因。