docs: 更新部署文档为容器化方案

- deploy/README.md: systemd → Podman 容器化部署
- CLAUDE.md: 更新部署命令、TDengine URL、.env 加载方式

CLAUDE.md

@@ -55,7 +55,7 @@ iot-platform/
 ### TDengine (Time-Series Database)
 - Used for high-frequency IoT telemetry ingestion
 - Connection pool: HikariCP via `TDengineService`
-- Connects to `jdbc:TAOS://localhost:6030/`
+- Connects to `jdbc:TAOS://127.0.0.1:6031/`
 - Super-table pattern with column caching (`stableColumnCache`)
 
 ### Redis
@@ -71,7 +71,7 @@ iot-platform/
 - `iot-platform/src/main/resources/application.yml` — Main config (port 8887, Redis, MyBatis, Actuator)
 - `iot-platform/src/main/resources/application-druid.yml` — Database connection (Druid pool, master/slave)
 - `iot-platform/src/main/resources/logback-spring.xml` — Logging config with rolling
-- `.env` — Environment variables (passwords, credentials) loaded by systemd or start.sh
+- `.env` — Environment variables (passwords, credentials) loaded by start-container.sh
 
 ## Environment Variables
 
@@ -134,18 +134,18 @@ Implementations:
 
 ## Deployment
 
-Production deployment uses systemd on online180 (47.104.204.180).
+Production deployment uses Podman containers on online180 (47.104.204.180).
 
 ```bash
 # Deploy from local
 cd deploy
-./deploy.sh --build          # Build and deploy
+./deploy.sh --build          # Build, build image, and deploy
 ./deploy.sh --jar <path>     # Deploy specific jar
 
-# Server management
-systemctl status iot-platform
-systemctl restart iot-platform
-journalctl -u iot-platform -f
+# Container management
+podman ps | grep iot-platform
+podman logs -f iot-platform
+podman restart iot-platform
 ```
 
 See `deploy/README.md` for full deployment documentation.

deploy/README.md

@@ -2,42 +2,53 @@
 
 ## 概述
 
-本项目使用 systemd 管理进程，通过 `deploy.sh` 脚本实现一键构建、上传、备份、健康检查和自动回滚。
+本项目使用 Podman 容器化部署，通过 `deploy.sh` 脚本实现一键构建、上传、构建镜像、健康检查和自动回滚。
 
 ## 服务器环境
 
 - **服务器**: online180 (47.104.204.180)
 - **OS**: Alibaba Cloud Linux 3
-- **Java**: OpenJDK 1.8.0_412
+- **容器运行时**: Podman 4.9.4 (docker 兼容)
+- **Java**: OpenJDK 1.8 (容器内)
 - **安装目录**: `/opt/iot-platform/`
-- **服务名称**: `iot-platform`
+- **容器名称**: `iot-platform`
 
 ## 目录结构
 
 ```
 /opt/iot-platform/
 ├── iot-platform.jar          # 当前运行版本
+├── Dockerfile                # 容器镜像构建定义
+├── start-container.sh        # 容器启动脚本（加载 .env）
 ├── .env                      # 环境变量（密码、凭据）
 ├── backup/                   # 版本备份（自动创建）
 ├── bin/
 │   ├── deploy.sh             # 一键部署脚本（本地运行）
 │   └── health-check.sh       # 健康检查脚本
 ├── config/                   # 线上专属配置
-└── logs/                     # 日志输出
+└── logs/                     # 日志输出（宿主机挂载）
 ```
 
 ## 快速开始
 
 ### 首次部署（服务器初始化）
 
-如果服务器上还没有安装 systemd 服务，执行初始化：
+确保服务器上已有 `/opt/iot-platform/` 目录，并包含 `Dockerfile`、`.env`、`start-container.sh`：
+
+```bash
+# 从本地同步必要文件到服务器
+scp deploy/setup-server.sh root@47.104.204.180:/opt/iot-platform/
+scp .env root@47.104.204.180:/opt/iot-platform/
+scp Dockerfile root@47.104.204.180:/opt/iot-platform/
+scp start-container.sh root@47.104.204.180:/opt/iot-platform/
+ssh root@47.104.204.180 "chmod +x /opt/iot-platform/start-container.sh"
+```
+
+然后执行首次部署：
 
 ```bash
 cd deploy
-scp setup-server.sh root@47.104.204.180:/tmp/
-scp iot-platform.service root@47.104.204.180:/tmp/
-scp ../.env root@47.104.204.180:/tmp/iot-platform.env
-ssh root@47.104.204.180 "chmod +x /tmp/setup-server.sh && /tmp/setup-server.sh"
+./deploy.sh --build
 ```
 
 ### 日常部署
@@ -53,9 +64,9 @@ cd deploy
 1. 本地执行 `mvn clean package`
 2. 上传 jar 到服务器
 3. 备份当前版本（带时间戳）
-4. 停止 systemd 服务
-5. 替换 jar
-6. 启动服务
+4. 停止并删除旧容器
+5. 替换 jar 并构建新镜像
+6. 启动容器（host 网络模式）
 7. 健康检查（`/actuator/health`）
 8. 失败则自动回滚到上一个版本
 
@@ -104,20 +115,26 @@ DRUID_PASSWORD=...
 ## 服务器管理
 
 ```bash
-# 查看状态
-systemctl status iot-platform
+# 查看容器状态
+podman ps | grep iot-platform
 
-# 重启
-systemctl restart iot-platform
+# 查看实时日志
+podman logs -f iot-platform
 
-# 停止
-systemctl stop iot-platform
+# 查看最后 100 行日志
+podman logs --tail 100 iot-platform
 
-# 查看日志
-journalctl -u iot-platform -f
+# 查看宿主机上的日志文件（和容器内同步）
+tail -f /opt/iot-platform/logs/iot-platform.$(date +%Y-%m-%d).*.log
 
-# 查看历史日志
-journalctl -u iot-platform --since "1 hour ago"
+# 停止容器
+podman stop iot-platform
+
+# 删除容器
+podman rm iot-platform
+
+# 重启容器
+podman restart iot-platform
 ```
 
 ## 健康检查
@@ -142,10 +159,22 @@ curl -s http://47.104.204.180:8887/actuator/health
 
 ```bash
 ssh root@47.104.204.180
-systemctl stop iot-platform
+
+# 停止并删除当前容器
+podman stop iot-platform && podman rm iot-platform
+
+# 恢复旧版本 jar
 ls /opt/iot-platform/backup/          # 查看可用备份
 cp /opt/iot-platform/backup/iot-platform-XXXX.jar /opt/iot-platform/iot-platform.jar
-systemctl start iot-platform
+
+# 重新构建镜像并启动
+cd /opt/iot-platform && podman build -t iot-platform:latest .
+podman run -d \
+    --name iot-platform \
+    --network host \
+    --restart unless-stopped \
+    -v /opt/iot-platform/logs:/opt/iot-platform/logs \
+    localhost/iot-platform:latest
 ```
 
 ## 配置文件说明
@@ -153,6 +182,8 @@ systemctl start iot-platform
 | 文件 | 说明 |
 |------|------|
 | `deploy.sh` | 一键部署脚本（本地执行） |
-| `setup-server.sh` | 服务器初始化脚本（服务器执行） |
+| `setup-server.sh` | 服务器初始化脚本 |
 | `health-check.sh` | 健康检查脚本 |
-| `iot-platform.service` | systemd 服务定义 |
+| `Dockerfile` | 容器镜像构建定义 |
+| `start-container.sh` | 容器内启动脚本（加载 .env） |
+| `iot-platform.service` | systemd 服务定义（已废弃，保留备用） |