技小云
d78379486c
- website/：VitePress 官网工程（首页/功能/对比/快速开始/部署运维/教程/社区），与文档站同构 - 两种形态由 SITE_BASE 决定：/www/ 子路径（过渡）与 / 根路径（独立域名），内容同源 - deploy/：新增 with-website profile、网关 /www/ 路由、多域名 website vhost 段 - Makefile：新增 website 镜像条目与 make website 目标 - 教程页给出部署/使用两支视频的元数据与录制要求，官网留有教程入口
115 lines
4.1 KiB
Markdown
115 lines
4.1 KiB
Markdown
---
|
||
title: 部署与运维
|
||
description: 生产部署前的必改项、可选组件、离线部署与常见问题
|
||
outline: deep
|
||
---
|
||
|
||
# 部署与运维
|
||
|
||
## 一键启动
|
||
|
||
```bash
|
||
git clone https://git.5iot.com/iotlcm-public/iotlcm.git
|
||
cd iotlcm/deploy
|
||
docker compose up -d
|
||
```
|
||
|
||
部署编排与数据库初始化脚本都在仓库的 `deploy/` 目录：
|
||
|
||
```text
|
||
deploy/
|
||
├── docker-compose.yml # 服务编排（含默认口令与端口）
|
||
├── compose.memlimit.yml # 容器内存上限（按机器规格叠加使用）
|
||
├── config/ # 各服务配置 + gateway / nginx 两种入口配置
|
||
├── schema/init.sql # MySQL 初始化（95 表 + 种子数据）
|
||
├── tdengine-init/ # 时序库建库建表（首次启动自动执行）
|
||
└── data/ # 运行数据，首次启动自动创建
|
||
```
|
||
|
||
## 可选组件
|
||
|
||
```bash
|
||
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）：
|
||
|
||
```bash
|
||
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 / 账号，按运营商要求申请 |
|
||
| 对象存储 | 图片与附件的存放位置 |
|
||
|
||
## 离线部署
|
||
|
||
目标机器不能出网时：
|
||
|
||
1. 在有网机器上拉全部镜像并导出：
|
||
|
||
```bash
|
||
docker compose pull
|
||
docker save -o iotlcm-images.tar $(docker compose config --images)
|
||
```
|
||
|
||
2. 拷贝 `iotlcm-images.tar` 与仓库的 `deploy/` 目录到目标机器；
|
||
3. `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 生效。
|