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

- website/:VitePress 官网工程(首页/功能/对比/快速开始/部署运维/教程/社区),与文档站同构
- 两种形态由 SITE_BASE 决定:/www/ 子路径(过渡)与 / 根路径(独立域名),内容同源
- deploy/:新增 with-website profile、网关 /www/ 路由、多域名 website vhost 段
- Makefile:新增 website 镜像条目与 make website 目标
- 教程页给出部署/使用两支视频的元数据与录制要求,官网留有教程入口
This commit is contained in:
技小云
2026-11-04 10:41:05 +08:00
committed by MiFaZhan
parent e98f8561f7
commit d78379486c
23 changed files with 3293 additions and 1 deletions
+82
View File
@@ -0,0 +1,82 @@
---
title: 快速开始
description: 三步把 iotLCM 开源版跑起来
outline: deep
---
# 快速开始
## 前置条件
| 项 | 要求 |
| --- | --- |
| 操作系统 | Linux(x86_64 / arm64) |
| Docker | 20.10 以上,含 Compose V2(`docker compose version` 可用) |
| 内存 | 建议 4 GB 以上 |
| 磁盘 | 建议 40 GB 以上(含镜像与数据库) |
| 端口 | 3306 / 6379 / 5672 / 6041 / 6030 / 8500 默认占用,起步前先确认空闲 |
## 第一步:取代码
```bash
git clone https://git.5iot.com/iotlcm-public/iotlcm.git
cd iotlcm
```
## 第二步:起栈
```bash
cd deploy
docker compose up -d
```
不需要复制或修改任何文件,编排里已带可用的默认配置。首次启动会自动:
1. MySQL 建库并导入 schema(13 个脚本按序执行:建表 → 结构补齐 → 创建应用账号 → 重置种子账号口令 → 导入通道模板、字典、菜单等种子数据),约 30 秒 ~ 1 分钟
2. TDengine 自动建库建表(流量历史库)
3. 其余服务依次启动并向 Consul 注册
观察进度:
```bash
docker compose logs -f mysql
```
看到 `[initdb] 应用账号 u_iotlcm 已创建` 与 `[initdb] 种子账号口令已统一重置` 表示初始化完成。
## 第三步:登录
部署完成后访问 `http://127.0.0.1:8009`,账号 `admin`,初始口令见 `deploy/README.md`。
> **正式使用前必须修改默认口令**:数据库、Redis、RabbitMQ、admin 账号口令与 JWT 密钥。清单见部署手册的「上线前必改」。
## 端口对照
| 服务 | 宿主机端口 | 说明 |
| --- | --- | --- |
| 管理端 | 8009 | Web 管理平台 |
| 对外接口 | 8000 | OpenAPI V3 与兼容接口 |
| 用户端 | 8018 | 小程序 / H5 |
| 文档站 | 8019 | 使用手册与接口文档,必须带 `/docs/` 路径 |
| 运营商对接 | 8110 / 8310 | 通道协议适配 |
| 通道缓存 | 8510 | 缓存转发 |
| MySQL | 3306 | 库名 `db_iotlcm` |
| Redis | 6379 | 缓存与运行状态 |
| RabbitMQ | 5672 / 15672 | 队列与管理界面 |
| TDengine | 6041 / 6030 | 时序库 |
| Consul | 8500 | 服务注册 |
编排默认把业务端口绑定在 `127.0.0.1`,需要局域网或公网访问时,改用反向代理编排或并入宿主机已有的 nginx。
## 停止与清理
```bash
docker compose down # 停止,数据保留
docker compose down -v # 停止并删除数据卷(不可恢复)
```
## 下一步
- [部署与运维](/guide/deploy) — 生产部署前的必改项、可选组件、离线部署与排错
- [教程视频](/guide/tutorial) — 跟着录屏走一遍
- [功能](/features) — 平台能做什么