Docker 部署

使用 Docker 快速部署 TinyIoTHub。

前置要求

• Docker 20.10+
• Docker Compose 2.0+

快速开始

# 克隆项目
git clone https://github.com/tinyiothub/tinyiothub.git
cd tinyiothub/docker

# 申请 SSL 证书（首次部署）
bash init-ssl.sh

# 启动所有服务
docker compose up -d

服务架构

服务	端口	说明
tinyiothub-nginx	80, 443, 8883	反向代理 + MQTT over TLS
tinyiothub-api	3002	API 后端
tinyiothub-mqtt	1883, 9001	Eclipse Mosquitto MQTT Broker

域名

域名	用途
www.tinyiothub.com	主站 (前端 + API)
api.tinyiothub.com	API 服务
mqtt.tinyiothub.com	MQTT Broker (TLS: 8883, WS: 443)
docs.tinyiothub.com	文档站点

配置说明

docker-compose.yml

version: '3.8'

services:
  tinyiothub:
    build: .
    container_name: tinyiothub
    ports:
      - "3001:3001"
      - "3002:3002"
    volumes:
      - ./data:/app/data
      - ./logs:/app/logs
    environment:
      - DATABASE_URL=tinyiothub.db
      - RUST_LOG=info
    restart: unless-stopped

构建镜像

# 构建镜像
docker build -t tinyiothub:latest .

# 运行
docker run -d -p 3001:3001 -p 3002:3002 tinyiothub:latest

数据持久化

推荐将数据目录挂载到宿主机：

volumes:
  - ./data:/app/data

日志管理

查看容器日志：

docker logs -f tinyiothub

网络配置

如需连接外部 MQTT broker：

environment:
  - MQTT__PRIMARY__HOST=192.168.1.124
  - MQTT__PRIMARY__PORT=1883

健康检查

curl http://localhost:3002/api/v1/system/health