iotlcm/docs/deploy/prerequisites.md

title, description, outline

title	description	outline
环境准备	部署 IotLCM 所需的硬件、系统、Docker 与网络条件	deep

环境准备

硬件要求

按数据规模选择：

场景	CPU	内存	磁盘	说明
试用 / 演示	2 核	4 GB	40 GB	少量卡片，建议停用定时同步任务
生产（中小规模）	4 核	8 GB	200 GB	万级卡片，开启全量同步
生产（大规模）	8 核+	16 GB+	500 GB+	十万级卡片，建议数据库独立部署

磁盘估算：MySQL 数据约 1~2 KB/张卡；日志随同步任务量增长，建议单独挂载并配置轮转。

生产 8 GB 场景的内存分配参考：

服务	占用
MySQL	1~2 GB
Redis	200~500 MB
RabbitMQ	300~500 MB
worker-svr	500 MB~1 GB（与并发同步卡片数相关）
其余业务服务	各 100~200 MB

系统要求

项	要求
操作系统	Linux x86_64（CentOS 7+ / Ubuntu 20.04+ / Debian 11+）
内核	3.10 以上
文件系统	ext4 / xfs
时区	建议 Asia/Shanghai，与 docker-compose.yml 的 TZ 保持一致

Docker 要求

组件	最低版本	说明
Docker Engine	20.10	需支持 healthcheck 与 profiles
Docker Compose	v2.0（插件版）	使用 docker compose 而非 docker-compose

验证：

docker version
docker compose version

docker compose version 需 ≥ v2.0。若只有 docker-compose（v1），请升级到 Compose V2 插件。

镜像仓库

平台镜像发布在阿里云容器镜像服务，仓库类型为公开，无需登录即可拉取。

项	值
公网地址	crpi-qflrqrxoohlkkvgc.cn-chengdu.personal.cr.aliyuncs.com
VPC 地址	crpi-qflrqrxoohlkkvgc-vpc.cn-chengdu.personal.cr.aliyuncs.com
命名空间	iotlcm
地域	西南1（成都）

业务镜像路径为：

crpi-qflrqrxoohlkkvgc.cn-chengdu.personal.cr.aliyuncs.com/iotlcm/iotlcm-admin-svr:1.0.3
crpi-qflrqrxoohlkkvgc.cn-chengdu.personal.cr.aliyuncs.com/iotlcm/iotlcm-openapi:1.0.3
...

docker-compose.yml 里的镜像地址已预置为上述公网地址，一般无需修改。

::: tip 基础组件也在同一仓库 MySQL、Redis、RabbitMQ、Consul、nginx 同样托管在 library/ 命名空间下，不从 Docker Hub 直连（公网不稳定且 tag 会漂）。版本已在编排文件中固定，必须与仓库里实际同步的标签一致。 :::

::: warning 基础组件需先同步 部署前 library/ 下必须已有这五个镜像，否则拉取失败。同步方法见自建镜像的「同步基础组件」一节。 :::

::: tip 阿里云 VPC 地址 若部署在阿里云同地域 ECS 上，可把编排文件里的镜像前缀改为 VPC 地址，走内网流量、不消耗公网带宽：

image: 'crpi-qflrqrxoohlkkvgc-vpc.cn-chengdu.personal.cr.aliyuncs.com/library/mysql:8.0'

:::

网络与防火墙

仅需对外开放反向代理端口（默认 80 / 443），其余服务端口应限制为内网访问。

# 示例：firewalld 仅放行 80/443
firewall-cmd --permanent --add-service=http
firewall-cmd --permanent --add-service=https
firewall-cmd --reload

::: tip 默认只监听本机 admin-svr、admin-ui、openapi、app-server、app-web、docs 默认绑定 127.0.0.1，只能本机访问。对外需通过反向代理，见可选服务。 :::

外部依赖（可选）

服务	用途	不配置的影响
TDengine 3.x	存流量历史数据	历史流量查询不可用，主流程正常
短信服务商	发送验证码	无法发送短信
微信支付	在线支付	支付功能不可用
飞书	运维通知	不启动 bot 即可

TDengine 需开启 WebSocket 接口（默认 6041），在 docker-compose.yml 中配置：

TDENGINE_HOST=tdengine.example.com
TDENGINE_PORT=6041
TDENGINE_USER=root
TDENGINE_PASSWORD=
TDENGINE_DAILY_DB=iotlcm_daily
TDENGINE_MONTHLY_DB=iotlcm_monthly

不使用时全部留空。