TopStack 文档

主题

在 Docker 环境下安装 ​

Topstack 支持在 Docker + Compose 环境下安装。下面介绍操作步骤。

安装准备 ​

需要同时安装 docker engine 和 docker compose 插件。

在线安装

步骤请参考官网说明：

安装 docker

安装 docker-compose

离线安装

下载 docker 离线安装包

执行以下命令，解压到当前目录并进行安装：

shell
tar zxvf docker-linux-x86.tar.gz
cd docker-linux-x86
chmod 777 ./install.sh
./install.sh

安装 TopStack ​

下载 TopStack Docker Compose 程序包。

解压程序包 ​

安装执行以下命令，解压程序包到根目录：

shell
#  解压 topstack 程序包
tar zxvf topstack.tar.gz -C /

解压完成后，会自动在根目录下生成 /topstack 目录。

离线镜像（可选） ​

如果服务器运行环境无法访问互联网，需要下载离线镜像，默认提供的 docker-compose.yml 配置中用到了以下 3 个镜像：

加载离线镜像

shell
docker load -i topstack-latest.tar.gz
docker load -i influxdb-1.8-alpine.tar.gz
docker load -i redis-6-alpine.tar.gz

容器配置 ​

为方便用户快速部署，我们默认在 /topstack/docker-compose.yml 中加入了 topstack 中用到的中间件容器，包括 nats、redis、influxdb，用户可以根据自己的实际情况进行修改。

yaml
version: '3'
services:
  redis:
    restart: always
    image: redis:6.0.9
    container_name: redis
    command: redis-server --requirepass iotopo_topstack
    # ports:
    #   - "6379:6379"

  influxdb:
    restart: always
    image: influxdb:1.8-alpine
    container_name: influxdb
    privileged: true
    # ports:
    #   - 8086:8086
    #   - 8088:8088
    volumes:
      - ./influxdb:/var/lib/influxdb

  topstack:
    restart: always
    image: swr.cn-north-4.myhuaweicloud.com/iotopo/topstack:latest
    #离线镜像请改为下面的镜像名称
    #image: topstack:latest
    container_name: topstack
    ports:
      - "8000:80"
      - "1883:1883"
    depends_on:
      - nats
      - influxdb
      - redis
    volumes:
      - ./storage:/iotopo/topstack/storage
      - ./db:/iotopo/topstack/db
      # - ./nats.conf:/iotopo/topstack/nats.conf
      # - ./vtx0zULbPg.txt:/iotopo/topstack/static/vtx0zULbPg.txt:ro

启动程序 ​

执行以下命令，启动程序：

javascript
cd /topstack
docker compose up -d

停止程序 ​

执行以下命令，停止程序：

javascript
cd /topstack
docker compose down

验证程序 ​

在浏览器中访问 http://<服务器 IP>:8000，默认用户名 admin 密码 admin，如果可以正常打开网页表示安装成功。

激活软件 ​

在浏览器打开软件的控制台管理界面，选择【平台管理】->【平台设置】，切换到“授权”选项卡，点击“激活”按钮，弹出激活对话框。

详细步骤请参考：激活软件

软件升级 ​

执行以下命令更新程序：

cd /iotopo
docker pull swr.cn-north-4.myhuaweicloud.com/iotopo/topstack:latest
docker compose up -d