thingsboard/summary/08-Java启动方式说明.md

# ThingsBoard Java 启动方式说明

## 1. 核心结论

**ThingsBoard 最终还是用 `java -jar` (或 `java -cp`) 启动的！**

DEB 包**不是替代** Java 启动方式，而是用来**安装和管理文件**的。

## 2. 启动流程

### 2.1 完整流程

```
DEB 包安装 → 文件安装到系统 → 启动脚本执行 → java -jar 启动应用
   ↓              ↓                  ↓              ↓
管理文件      设置权限          加载配置      运行 Java
```

### 2.2 实际启动命令

查看 `msa/tb-node/docker/start-tb-node.sh`，第 69 行：

```bash
exec java -cp ${jarfile} $JAVA_OPTS \
    -Dloader.main=org.thingsboard.server.ThingsboardServerApplication \
    -Dlogging.config=${LOGGING_CONFIG} \
    org.springframework.boot.loader.launch.PropertiesLauncher
```

**这就是标准的 Java 启动方式！**

## 3. DEB 包的作用

### 3.1 DEB 包做什么

DEB 包的作用是**文件管理和安装**，不是启动方式：

1. **文件安装**: 将 JAR 文件、配置文件、脚本复制到标准位置
   ```
   /usr/share/thingsboard/bin/thingsboard.jar  ← JAR 文件
   /usr/share/thingsboard/conf/thingsboard.yml ← 配置文件
   /usr/bin/start-tb-node.sh                   ← 启动脚本
   ```

2. **权限设置**: 自动设置正确的文件权限和所有者
   ```bash
   chown -R thingsboard:thingsboard /usr/share/thingsboard
   chmod 555 /usr/share/thingsboard/bin/thingsboard.jar
   ```

3. **依赖检查**: 检查是否安装了 Java 17

4. **系统集成**: 注册 systemd 服务（可选）

### 3.2 DEB 包不做什么

- ❌ **不启动应用**: DEB 包安装后不会自动启动
- ❌ **不替代 Java**: 最终还是用 `java` 命令启动
- ❌ **不改变启动方式**: 启动方式仍然是标准的 Java 启动

## 4. 两种使用场景对比

### 4.1 场景1：直接使用 JAR（不用 DEB）

```bash
# 手动下载 JAR
wget https://github.com/thingsboard/thingsboard/releases/download/v4.2.1/thingsboard-4.2.1-boot.jar

# 直接启动
java -jar thingsboard-4.2.1-boot.jar \
    --spring.config.name=thingsboard
```

**优点**: 简单直接  
**缺点**: 
- 需要手动管理文件位置
- 需要手动设置权限
- 需要手动管理配置文件

### 4.2 场景2：使用 DEB 包安装（ThingsBoard 采用）

```bash
# 1. 安装 DEB 包（自动管理文件）
dpkg -i thingsboard-4.2.1.deb

# 2. 启动（启动脚本内部还是用 java -jar）
start-tb-node.sh
# 或
systemctl start thingsboard
```

**优点**:
- ✅ 标准化文件位置
- ✅ 自动设置权限
- ✅ 配置文件管理
- ✅ 系统服务集成

**缺点**: 多了一个安装步骤

## 5. 启动脚本详解

### 5.1 start-tb-node.sh 分析

```bash
#!/bin/bash

# 1. 定义 JAR 文件路径（DEB 包安装后的位置）
jarfile=${pkg.installFolder}/bin/${pkg.name}.jar
# 实际路径: /usr/share/thingsboard/bin/thingsboard.jar

# 2. 加载配置文件（DEB 包安装的配置文件）
CONF_FOLDER="/usr/share/thingsboard/conf"
source "${CONF_FOLDER}/${pkg.name}.conf"

# 3. 切换到工作目录
cd ${pkg.installFolder}/bin

# 4. 启动应用（标准的 Java 启动方式）
exec java -cp ${jarfile} $JAVA_OPTS \
    -Dloader.main=org.thingsboard.server.ThingsboardServerApplication \
    -Dlogging.config=${LOGGING_CONFIG} \
    org.springframework.boot.loader.launch.PropertiesLauncher
```

### 5.2 为什么用 `java -cp` 而不是 `java -jar`

ThingsBoard 使用 `java -cp` + `PropertiesLauncher` 的原因：

1. **支持外部配置**: 可以加载外部配置文件
2. **支持扩展**: 可以加载 `extensions/` 目录下的扩展
3. **灵活启动**: 可以指定不同的主类（安装、升级、运行）

### 5.3 等效的启动命令

如果不用启动脚本，等效的命令是：

```bash
java -cp /usr/share/thingsboard/bin/thingsboard.jar \
    -Dloader.main=org.thingsboard.server.ThingsboardServerApplication \
    -Dlogging.config=/usr/share/thingsboard/conf/logback.xml \
    org.springframework.boot.loader.launch.PropertiesLauncher
```

## 6. Docker 中的使用

### 6.1 Dockerfile 流程

```dockerfile
# 1. 安装 DEB 包（文件管理）
COPY thingsboard.deb /tmp/
RUN dpkg -i /tmp/thingsboard.deb

# 2. 设置启动命令（Java 启动）
CMD ["start-tb-node.sh"]
```

### 6.2 启动脚本最终执行

启动脚本 `start-tb-node.sh` 最终执行：

```bash
java -cp /usr/share/thingsboard/bin/thingsboard.jar \
    -Dloader.main=org.thingsboard.server.ThingsboardServerApplication \
    ...
```

**所以最终还是 `java -jar` (或 `java -cp`) 启动！**

## 7. 为什么不直接用 `java -jar`

### 7.1 传统方式的问题

如果直接用 `java -jar`：

```bash
java -jar thingsboard.jar
```

**问题**:
- 配置文件在哪里？
- 日志文件写在哪里？
- 如何管理多个配置文件？
- 如何加载扩展？

### 7.2 ThingsBoard 的解决方案

使用 `java -cp` + `PropertiesLauncher`：

```bash
java -cp thingsboard.jar \
    -Dloader.main=... \
    -Dlogging.config=... \
    org.springframework.boot.loader.launch.PropertiesLauncher
```

**优势**:
- ✅ 可以指定外部配置文件路径
- ✅ 可以加载扩展目录
- ✅ 可以灵活切换主类（安装/运行/升级）

## 8. 总结

### 8.1 关键点

1. **DEB 包 ≠ 启动方式**
   - DEB 包是**文件安装工具**
   - 启动方式仍然是**标准的 Java 启动**

2. **最终启动命令**
   ```bash
   java -cp ${jarfile} ... PropertiesLauncher
   ```
   这就是标准的 Java 启动方式！

3. **DEB 包的价值**
   - 标准化文件位置
   - 自动权限管理
   - 配置文件管理
   - 系统服务集成

### 8.2 类比理解

可以这样理解：

```
DEB 包 = Windows 的安装程序（.exe）
  ↓
安装 → 把文件放到 C:\Program Files\ThingsBoard\
  ↓
启动 → 双击 thingsboard.exe（实际上还是运行 Java）
```

**DEB 包是"安装程序"，不是"启动程序"！**

### 8.3 完整流程

```
源码编译
  ↓
打包成 JAR（Java 应用）
  ↓
打包成 DEB（安装包）
  ↓
Dockerfile 安装 DEB（文件管理）
  ↓
启动脚本执行 java -cp（启动应用）← 这里才是真正的启动！
```

**所以，ThingsBoard 还是用标准的 `java -jar`/`java -cp` 方式启动的，DEB 包只是用来管理文件安装的！**