JT808 Spring Boot Transport Server

This project has been modernized to a Spring Boot 3 + Netty architecture, supporting both TCP (JT808) and HTTP API channels.

Features

• Dual Channel:
  • TCP (Port 20048): Standard JT808 protocol for device connections.
  • HTTP API (Port 8080): RESTful API for testing or third-party integration.
• Web UI: Built-in Dashboard at http://localhost:8080/.
• Docker Ready: Simple deployment via Docker.

Structure

• src/main/java/com/iot/transport/jt808
  • Jt808Application.java: Spring Boot Entry Point.
  • server/Jt808NettyServer.java: Netty Server Wrapper.
  • controller/DeviceController.java: HTTP API Controller.
  • service/: Business Logic Layer.
  • tcp/: Original JT808 Protocol Logic.
• src/main/resources/static: Frontend Static Files (Vue 3 Dashboard).

How to Run

Local Development

mvn clean spring-boot:run

Access Dashboard: http://localhost:8080/

Docker

1. Build JAR:

mvn clean package -DskipTests

2. Build Image:

docker build -t jt808-server .

3. Run:

docker run -d -p 8080:8080 -p 20048:20048 --name jt808 jt808-server

CI/CD

参考 docs/ci-cd.md 了解如何通过 Gitea Actions + Runner 构建容器、推送镜像并在目标主机上自动部署 jt808-server。

API Usage

Report Location (HTTP): POST /api/v1/device/location

{
  "imei": "123456789012",
  "lat": 30.123456,
  "lon": 120.654321,
  "speed": 60.0
}