Files

T

技小云 d78379486c feat: 新增开源版官网骨架 website/，并接入部署编排与网关路由

- website/：VitePress 官网工程（首页/功能/对比/快速开始/部署运维/教程/社区），与文档站同构
- 两种形态由 SITE_BASE 决定：/www/ 子路径（过渡）与 / 根路径（独立域名），内容同源
- deploy/：新增 with-website profile、网关 /www/ 路由、多域名 website vhost 段
- Makefile：新增 website 镜像条目与 make website 目标
- 教程页给出部署/使用两支视频的元数据与录制要求，官网留有教程入口

2026-11-04 10:41:05 +08:00

4.1 KiB

Raw Blame History

title, description, outline

title	description	outline
部署与运维	生产部署前的必改项、可选组件、离线部署与常见问题	deep

部署与运维

一键启动

git clone https://git.5iot.com/iotlcm-public/iotlcm.git
cd iotlcm/deploy
docker compose up -d

部署编排与数据库初始化脚本都在仓库的 deploy/ 目录：

deploy/
├── docker-compose.yml      # 服务编排（含默认口令与端口）
├── compose.memlimit.yml    # 容器内存上限（按机器规格叠加使用）
├── config/                 # 各服务配置 + gateway / nginx 两种入口配置
├── schema/init.sql         # MySQL 初始化（95 表 + 种子数据）
├── tdengine-init/          # 时序库建库建表（首次启动自动执行）
└── data/                   # 运行数据，首次启动自动创建

可选组件

docker compose --profile with-mock up -d     # 运营商接口挡板
docker compose --profile with-bot up -d      # 飞书通知（运维自用）
docker compose --profile with-nginx up -d    # 自带反向代理（多域名入口）
docker compose --profile with-gateway up -d  # 单端口入口（默认对外 5051）

多个 profile 可组合。

单端口入口（with-gateway）

只暴露一个端口时用它。容器内监听 80，宿主机端口由 GATEWAY_PORT 控制（默认 5051）：

docker compose --profile with-gateway up -d
GATEWAY_PORT=8088 docker compose --profile with-gateway up -d

路由：

路径	目标
`/`	管理端
`/docs/`	文档站
`/openapi/`	对外 API
`/route/open/`	运营商能力代理

小程序 / H5 端的静态资源是根路径部署的，不能挂在同一域名的子路径下，需要单独域名或单独端口。

多域名入口（with-nginx）

宿主机已有 nginx 或面板时不启动这个容器，把 deploy/config/nginx/iotlcm.conf 里的 location 段落并入宿主机配置即可。

线上暴露到公网

80 / 443 入站在多数办公宽带上被运营商封禁，评估过三种可行形态：

形态	适用	代价
高位端口 NAT	内部验收、演示	地址带端口，不适合对外正式发布
独立子域 + 反代	有公网 IP 的服务器	需要域名解析与证书
云主机统一入口	正式对外发布	需要域名（以及国内服务器的备案）

上线前必改

项	说明
数据库口令	MySQL 的 root 与应用账号口令
Redis 口令	缓存层口令
RabbitMQ 口令	队列层口令
admin 口令	种子账号初始口令统一重置过，必须改
JWT 密钥	管理端与用户端签发令牌用
运营商通道凭据	通道配置的 appKey / appSecret / 账号，按运营商要求申请
对象存储	图片与附件的存放位置

离线部署

目标机器不能出网时：

在有网机器上拉全部镜像并导出：

docker compose pull
docker save -o iotlcm-images.tar $(docker compose config --images)

拷贝 iotlcm-images.tar 与仓库的 deploy/ 目录到目标机器；
docker load -i iotlcm-images.tar 后再 docker compose up -d。

细节见文档站的部署章节。

常见问题

现象	原因与处置
MySQL 初始化中途失败	schema 只在数据卷为空时执行，改完脚本必须清空卷才会重跑：`docker compose down && sudo rm -rf ./data/mysql && docker compose up -d`
访问 8019 端口白屏	文档站必须带 `/docs/` 路径，裸端口会白屏
偶发 502	容器重建后 upstream IP 变化，nginx 未重新解析；配置已带 `resolver` + `resolve`，若仍出现，重启网关容器即可
通道调用报 IP 鉴权失败	运营商侧需要报备出口 IP，未报备则拒绝调用
端口被占用	编排里业务端口默认绑 `127.0.0.1`，改端口映射即可避开冲突

监控

Consul 提供服务注册与健康探针，Prometheus 指标入口在编排内已开。日志按服务落在 deploy/data/logs/ 下，配合 logrotate 生效。

4.1 KiB Raw Blame History Unescape Escape