一个支持 Android USB Host 与浏览器 Web Serial 的 USB 继电器云端控制与实时日志平台。
USB Relay Cloud 将本地 USB 继电器硬件接入云端,实现多客户端实时状态同步与操作日志审计。
- Android App:通过 USB Host +
usb-serial-for-android驱动 CH340 串口,控制 LCUS-1 继电器 - Web Client:Chrome / Edge 通过 Web Serial API 直接驱动 CH340 串口
- Spring Boot:REST 管理设备、状态和事件;WebSocket 实时广播变更
- CH340 + LCUS-1:已验证的硬件组合(VID
1A86/ PID7523,9600 8N1) - 云端状态:
relay_state记录每设备最新指令状态 - 实时 WebSocket:多客户端实时同步,AUTH 帧鉴权 + sequence gap replay
- 操作日志:
relay_eventappend-only 审计日志 - 硬件事件日志:
hardware_event独立记录 USB 插拔 / 连接 / 断开 / 失败
V1 — Release Candidate
测试状态:
| 项 | 结果 |
|---|---|
| Backend Maven test | 42/42 passed ✅ |
| Backend Maven package | BUILD SUCCESS ✅ |
| Frontend typecheck | passed ✅ |
| Frontend Vitest | 125/125 passed ✅ |
| Frontend Vite build | passed ✅ |
| Android cap sync | passed ✅ |
| Android Gradle assembleDebug | BUILD SUCCESSFUL ✅ |
| Flyway / MySQL 检查 | 待人工确认(本地 MySQL 密码不匹配) |
| Spring Boot 启动验证 | 待人工确认(依赖 MySQL) |
graph TB
subgraph Client["客户端(同一套 Vue 3 逻辑)"]
Android["Android App<br/>Capacitor + Kotlin"]
Web["Web Client<br/>Chrome / Edge"]
end
subgraph Hardware["硬件层"]
CH340["CH340 USB 转串口<br/>VID: 1A86 / PID: 7523"]
LCUS["LCUS-1 单路继电器<br/>9600 8N1"]
end
Android -->|"USB Host"| CH340
Web -->|"Web Serial API"| CH340
CH340 -->|"RX/TX"| LCUS
Android -->|"HTTPS REST"| SpringBoot
Android -->|"WSS WebSocket"| SpringBoot
Web -->|"HTTPS REST"| SpringBoot
Web -->|"WSS WebSocket"| SpringBoot
subgraph Cloud["云端"]
SpringBoot["Spring Boot 3.4<br/>REST + WebSocket + JWT"]
MySQL["MySQL 8<br/>Flyway V1/V2/V3"]
end
SpringBoot -->|"JDBC"| MySQL
事件闭环:
sequenceDiagram
participant Client
participant SpringBoot as Spring Boot
participant MySQL as MySQL
participant WS as WebSocket
Client->>SpringBoot: 1. POST /api/devices/{id}/events (Bearer JWT)
SpringBoot->>MySQL: 2. INSERT relay_event + UPSERT relay_state (事务)
MySQL-->>SpringBoot: 3. commit
SpringBoot->>WS: 4. 广播 RELAY_STATE_CHANGED
WS-->>Client: 5. 其他在线客户端收到变更
广播永远发生在数据库事务提交之后。
V1 使用同一套客户端业务逻辑,部署在不同平台:
| 平台 | 本地 USB 能力 | 工作模式 |
|---|---|---|
| Android App | ✅ USB Host | 可连接本地继电器 + 云端同步 |
| Web (Chrome/Edge) | ✅ Web Serial | 可连接本地继电器 + 云端同步 |
| Web (其他浏览器) | ❌ 无 Web Serial | 仅查看云端状态和日志 |
V1 不是:Server → Remote Device Agent 远程控制。远程控制属于 V2 Roadmap。
| 项目 | 值 |
|---|---|
| 继电器 | LCUS-1 单路 |
| USB 转串口 | CH340 |
| VID | 1A86 |
| PID | 7523 |
| 波特率 | 9600 |
| 数据位 | 8 |
| 停止位 | 1 |
| 校验 | NONE |
| ON 指令 | A0 01 01 A2 |
| OFF 指令 | A0 01 00 A1 |
| 状态回读 | 无已验证协议 |
LCUS-1 没有经过验证的硬件状态回读协议。串口 write 成功只表示软件已写入命令,不代表实体触点已确认状态。因此数据模型始终区分:
commandedState:ON/OFF(指令状态)commandStatus:SUCCESS/FAILED(执行结果)hardwareState:V1 固定为UNKNOWN(不声称物理触点状态)
UI 使用 "Last Command" 展示,不会把写入成功显示成硬件确认。
- JWT 登录认证(BCrypt 哈希,无公开注册)
- 设备管理(ADMIN 可创建设备,设备自注册)
- 本地继电器控制(ON / OFF)
- HardwareProfile 自动匹配(VID/PID 优先,normalizeUsbId 标准化)
- 自动 USB 扫描与连接状态机(8 状态)
- 串口连接(Android USB Host / Web Serial / Electron 预留)
- command status(SUCCESS 才更新 relay_state,FAILED 不污染状态)
- WebSocket 实时同步(多客户端)
- eventId 幂等(重复提交返回 idempotentReplay=true)
- gap replay(断线重连后按 sequence 补发)
- SYNC_COMPLETE(补发完成通知)
- relay_event(append-only 操作日志)
- hardware_event(USB 插拔 / 连接 / 断开 / 失败日志)
- ACL(OWNER / CONTROL / VIEWER,ADMIN 全访问)
- 客户端 EventOutbox(本地待同步队列,自动重试 + 去重)
- 登录进度条(真实阶段驱动:验证 → 同步设备 → 建立连接)
- Java 21
- Spring Boot 3.4.5
- Spring Security + JWT (jjwt 0.12.6)
- Spring WebSocket
- MyBatis-Plus 3.5.12
- MySQL 8
- Flyway
- Maven
- Vue 3 Composition API
- TypeScript
- Vite
- Pinia
- Vue Router
- Axios
- Vitest
- Capacitor 8
- Kotlin
- Android USB Host API
usb-serial-for-android- CH340 / LCUS-1 raw bytes
- Web Serial API(Chrome / Edge / secure context)
- Docker / Docker Compose
- Nginx
- Ubuntu 24.04(Native 部署)
USB-Relay-Cloud/
├─ client/
│ ├─ src/
│ │ ├─ api/ # authApi, deviceApi, eventApi, hardwareEventApi, healthApi, http
│ │ ├─ components/ # ConnectionBadge, EventLogList, HardwareInfoPanel,
│ │ │ # LocalRelayPanel, RelayControlPanel, StatePanel
│ │ ├─ config/ # authStorage, runtimeConfig
│ │ ├─ layouts/ # AppLayout
│ │ ├─ router/ # Vue Router
│ │ ├─ services/
│ │ │ ├─ relay/ # RelayService, EventOutbox, LocalRelayProvider,
│ │ │ │ # CloudRelayProvider, HardwareProfile, HardwareStatus
│ │ │ └─ websocket/ # RelayWebSocketClient, message parser
│ │ ├─ stores/ # authStore, connectionStore, deviceStore,
│ │ │ # eventStore, hardwareEventStore, relayStore
│ │ ├─ types/ # api.ts
│ │ ├─ utils/ # format, id
│ │ └─ views/ # LoginView, DashboardView, DevicesView, LogsView, SettingsView
│ ├─ android/ # Capacitor Android 工程
│ ├─ electron/ # Electron 集成预留说明
│ ├─ public/
│ ├─ package.json
│ ├─ vite.config.ts
│ └─ tsconfig.json
├─ server/
│ ├─ src/main/java/com/absolutezero/usbrelaycloud/
│ │ ├─ common/ # ApiResponse, PageResponse, enums
│ │ ├─ config/ # Application, CORS, JWT, MybatisPlus, WebSocket, Bootstrap, Presence
│ │ ├─ controller/ # Auth, Device, Health
│ │ ├─ dto/ # Login, RelayCommand, RelayEventCreate, HardwareEventCreate, Heartbeat
│ │ ├─ entity/ # Device, DeviceUser, HardwareEvent, RelayEvent, RelayState, SysUser
│ │ ├─ exception/ # BusinessException, GlobalExceptionHandler, ResourceNotFound
│ │ ├─ mapper/ # MyBatis-Plus Mapper
│ │ ├─ security/ # AuthService, JwtService, SecurityConfig, JwtAuthenticationFilter, ...
│ │ ├─ service/ # DeviceService, RelayEventService, HardwareEventService, ...
│ │ ├─ vo/ # Response objects
│ │ └─ websocket/ # RelayWebSocketHandler, RelayWebSocketMessage
│ ├─ src/main/resources/
│ │ ├─ application.yml
│ │ ├─ application-dev.yml
│ │ ├─ application-prod.yml
│ │ └─ db/migration/ # V1, V2, V3
│ ├─ src/test/
│ └─ pom.xml
├─ deploy/
│ ├─ docker-compose.yml
│ ├─ .env.example
│ ├─ nginx/ # Docker Nginx 配置
│ ├─ native/ # Native Ubuntu 部署(systemd, nginx.conf, env.example)
│ └─ scripts/ # start.sh, stop.sh, verify-closed-loop.mjs
├─ docs/
│ ├─ architecture.md
│ ├─ api.md
│ ├─ database.md
│ ├─ deployment.md
│ └─ protocol.md
├─ .github/workflows/ci.yml
├─ LICENSE
└─ README.md
- JDK 21
- Maven 3.9+
- Node.js 22+
- npm 10+
- MySQL 8
复制部署环境并修改数据库密码(不要提交该文件):
cp deploy/.env.example deploy/.env
# 编辑 deploy/.env 设置 MYSQL_ROOT_PASSWORD 等变量如果不使用 Docker Compose,直接运行 Spring Boot:
$env:DB_URL="jdbc:mysql://127.0.0.1:3306/usb_relay_cloud?useUnicode=true&characterEncoding=utf8&connectionTimeZone=UTC"
$env:DB_USERNAME="<YOUR_DB_USERNAME>"
$env:DB_PASSWORD="<YOUR_DB_PASSWORD>"
$env:SERVER_PORT="8080"
$env:JWT_SECRET="<YOUR_JWT_SECRET>" # >= 32 chars
$env:APP_BOOTSTRAP_ADMIN_USERNAME="admin"
$env:APP_BOOTSTRAP_ADMIN_PASSWORD="<YOUR_ADMIN_PASSWORD>"
$env:APP_CORS_ALLOWED_ORIGINS="*"
cd server
mvn spring-boot:runHealth 检查:
Invoke-RestMethod http://localhost:8080/api/healthcd client
npm install
npm run dev -- --host 0.0.0.0开发地址:http://localhost:5173
开发环境 API 和 WebSocket 地址在 client/.env.development 中配置。
cd client
npm run build
npx cap sync android
cd android
$env:ANDROID_HOME="<YOUR_ANDROID_SDK>" # 或写入 android/local.properties
.\gradlew.bat assembleDebugAPK 输出路径:
client/android/app/build/outputs/apk/debug/app-debug.apk
debug APK 使用内嵌 dist 静态资源,首次安装默认服务器地址为 https://relay.evezero.cn
(见 §13.4),可在登录页「服务器设置」中随时改成局域网地址后重新登录。
USB 扫描 / 授权 / 开关继电器的真机验收步骤见 §13.2。
| 变量 | 说明 | 示例 |
|---|---|---|
DB_URL |
MySQL JDBC 连接串 | jdbc:mysql://127.0.0.1:3306/usb_relay_cloud |
DB_USERNAME |
数据库用户名 | <YOUR_DB_USERNAME> |
DB_PASSWORD |
数据库密码 | <YOUR_DB_PASSWORD> |
SERVER_PORT |
Spring Boot 端口 | 8080 |
JWT_SECRET |
JWT 签名密钥(≥ 32 字符) | <YOUR_JWT_SECRET> |
APP_BOOTSTRAP_ADMIN_USERNAME |
初始管理员用户名 | admin |
APP_BOOTSTRAP_ADMIN_PASSWORD |
初始管理员密码 | <YOUR_ADMIN_PASSWORD> |
APP_CORS_ALLOWED_ORIGINS |
CORS 允许来源 | *(开发) |
SPRING_PROFILES_ACTIVE |
激活配置 | dev / prod |
Flyway migration 位于 server/src/main/resources/db/migration/。
| Migration | 内容 |
|---|---|
V1__initialize_relay_cloud.sql |
device、relay_state、relay_event |
V2__add_authentication.sql |
sys_user、device_user |
V3__add_hardware_event.sql |
hardware_event |
严禁修改已执行的 migration。 新需求只能新增 V4__xxxx.sql。
核心表:
| 表 | 说明 |
|---|---|
device |
设备注册 |
relay_state |
每设备最新指令状态(仅 SUCCESS 才 UPSERT) |
relay_event |
append-only 事件审计日志(eventId 幂等) |
sys_user |
系统用户(global_role: ADMIN / USER) |
device_user |
设备级授权(role: OWNER / CONTROL / VIEWER) |
hardware_event |
硬件生命周期事件(USB 插拔 / 连接 / 断开 / 失败) |
详细字段和索引见 docs/database.md。
relay_event 是 append-only 审计表,正常业务不 UPDATE、不 DELETE。
relay_state 的 lastEventId / commandedState / commandStatus 仅在事件 commandStatus = SUCCESS 时更新;FAILED
事件不污染状态。
- 本地串口 CONNECTED 才能控制:
canControl = 本地串口已连接 && !写入中; 与云端 device、relay_state、WebSocket、heartbeat 全部无关 - UNKNOWN 不等于禁止控制:LCUS-1 无状态回读,刚连接时
commandedState=UNKNOWN, 此时开关依然可操作,第一次成功后本地状态才变为 ON / OFF - 云端不可用不影响本地控制:未关联云端设备(
deviceId=null)时只做本地 USB 写入, 云端事件标记为NOT_REQUIRED;云端 POST 失败只影响日志同步,不回滚已成功的硬件动作 - 无 optimistic update:先执行本地 USB write,成功后才更新状态
- write success 才产生 SUCCESS:串口写入失败 → FAILED,不更新 relay_state
- FAILED 不改变 relay_state:失败事件只记录日志,不污染状态
- USB 拔出不等于 OFF:拔出只写 hardware_event,不伪造 relay OFF
- LCUS-1 无状态回读:不声称物理触点状态,
hardwareState始终为 UNKNOWN - WebSocket AUTH 帧强制:连接后 5 秒内必须发送 AUTH 帧,否则关闭
- JWT_SECRET ≥ 32 字符:生产环境必须设置,dev profile 有默认值仅供本地
- 管理员账号:首次启动
sys_user为空时通过环境变量创建(BCrypt 哈希) - Spring Boot / MySQL 不暴露公网:Native 部署仅监听 127.0.0.1,外部通过 Nginx
同一套 Vue 代码在四个环境里运行,绝不能混用同一种 USB 接口:
| 运行环境 | 平台判定 | USB 链路 |
|---|---|---|
| Capacitor Android App | Capacitor.isNativePlatform() === true |
AndroidUsbRelayAdapter → Kotlin UsbRelayPlugin → UsbManager → usb-serial-for-android |
| PC 浏览器(Chrome / Edge) | web |
WebSerialRelayAdapter → navigator.serial(仅已授权设备 + 手势选择) |
| Android WebView(非 Capacitor) | web |
没有 USB 能力,UI 明确提示改用 Android 客户端 |
| Electron | window.desktopAPI.isElectron |
ElectronSerialRelayAdapter(IPC 契约已就绪,串口实现待补) |
Android App 内不会调用 navigator.serial / navigator.usb:Android WebView 没有 Web Serial,
即使有也无法访问 USB Host。
Vue (LocalRelayPanel)
→ RelayService.scanAndMatch()
→ LocalRelayProvider
→ AndroidUsbRelayAdapter
→ Capacitor Plugin "UsbRelay" (Kotlin)
→ UsbManager.getDeviceList()
→ UsbSerialProber.getDefaultProber() (驱动识别)
→ UsbSerialPort.open() / write()
→ CH340 → LCUS-1
要点:
- 扫描结果包含
deviceId / vendorId / productId / manufacturer / productName / serialNumber / driverName / supported / hasPermission,UsbManager能看到的设备一定会出现在列表里; 没有兼容串口驱动时显示「检测到 USB 设备,但未找到兼容串口驱动」,而不是空列表。 - CH340 识别优先使用
UsbSerialProber,其次才回退到 VID/PID;驱动名为 CH340/CH341 时即使 PID 是变体也能匹配 LCUS-1 配置。 - 权限流程:扫描 → 选择设备 →
connect()→UsbManager.hasPermission()→ 未授权则弹出系统 授权对话框(PendingIntent.FLAG_IMMUTABLE)→ 授权成功后openDevice();权限不会被假定为永久有效。 - 连接状态机明确区分
NO_DEVICE/DETECTED/PERMISSION_REQUIRED/CONNECTING/CONNECTED/DISCONNECTED/ERROR。只有CONNECTED表示UsbDeviceConnection已获得、SerialPort.open()成功、9600 8N1 已配置; 继电器开关的可用性只看它(canControl = CONNECTED && !写入中), 不要求账号里已注册云端设备、不要求relay_state存在、不要求 WebSocket 在线。 - 插拔:Kotlin 侧注册
ACTION_USB_DEVICE_ATTACHED/ACTION_USB_DEVICE_DETACHED(RECEIVER_NOT_EXPORTED), 插入自动重新扫描,拔出关闭串口并刷新 UI,不需要重启 App。 - 调试日志:Android Logcat 统一 TAG
UsbRelay;前端「本地硬件 → 调试信息」可查看同一批关键事件 (平台、设备数、VID/PID、驱动、权限、打开/写入结果与原始异常)。 - 明文流量:
debug构建允许http://192.168.x.x:8080局域网调试;release构建保持usesCleartextTraffic=false,默认只允许 HTTPS。
Web Serial API 需要:
- Chrome / Edge 浏览器
- HTTPS secure context(或
localhost开发例外)
浏览器不允许网页枚举系统里全部串口,因此 Web 端把「发现设备」拆成两个明确动作:
- 选择新串口设备 =
navigator.serial.requestPort():必须在用户点击事件的同步调用栈里执行 (不能放在setTimeout、Promise 延迟回调、WebSocket 回调、mounted、后台 scan 或自动重试里), 由浏览器弹出原生串口选择窗口,用户选中 CH340 后该设备才进入列表 - 刷新已授权设备 =
navigator.serial.getPorts():只返回此前授权给当前 Origin 的串口, 不授权就是空列表(这是浏览器安全模型,不是程序 Bug)
没有已授权设备时 UI 提示「尚未授权串口设备,请点击『选择新串口设备』」,不会只留一个空下拉框;
浏览器不支持 Web Serial('serial' in navigator === false)时提示
「当前浏览器不支持 Web Serial。请使用最新版桌面 Chrome / Edge,或使用 Android / Electron 客户端。」
设备信息与型号识别:
- 列表展示
usbVendorId/usbProductId(来自port.getInfo()),CH340 常见VID 1A86 - 不强制
PID=7523:CH340/CH341 变体、克隆板、甚至浏览器未暴露 PID 时, 只要平台已识别为可用串口,都会使用「通用 USB 串口继电器(9600 8N1)」配置连接 (UI 会显示为通用配置,不谎称识别成 LCUS-1) navigator.serial的connect/disconnect事件用于刷新已授权设备状态; 注意connect事件不代表已获得首次授权,首次仍必须由用户点击触发requestPort()
物理拔出(Web Serial 生命周期):
- 事件回调读取
event.port(不是event.target,后者是navigator.serial) - 拔出的端口就是当前连接端口时,立即执行统一断连流程:
physicalConnected=false→ 清理 writer(abort/releaseLock)→port.close()(设备已拔出时允许抛错)→ 清空activePort→ 状态置为SERIAL_DEVICE_DISCONNECTED→ 通知 Provider / UI - 拔出的不是当前端口时只刷新设备列表,不影响当前连接
getPorts()会一直返回「已授权但已拔出」的端口,因此每个端口额外带physicallyPresent标记:false时 UI 显示「已拔出」并禁用「连接」, 重新插入(connect事件)后清除标记,只有再次open()成功才回到 CONNECTED- 每次写入前二次校验
activePort/writable,写入过程中掉线会把状态置为 DISCONNECTED 并释放 writer 锁,relayState保持 UNKNOWN,不产生成功事件
失败指令与云端同步边界:
- 串口未连接 / 已拔出时不写 USB、不上传任何
relay_event(避免无硬件却产生日志与广播) - 真正尝试过写入但失败时,才上传
commandStatus=FAILED的审计事件 (currentState与action一致以通过服务端校验),服务端不会更新relay_state
局域网 HTTP(如 http://192.168.x.x:5173)可能无法使用 Web Serial。这是浏览器安全限制,不是程序 Bug。
登录页提供「服务器设置」入口,不依赖登录状态:Token 失效、401/403/500、DNS 失败、连接失败时都能进入。
优先级(唯一实现在 client/src/config/runtimeConfig.ts):
用户保存的 serverUrl > VITE_DEFAULT_SERVER_BASE_URL > 平台默认值
├─ Android:DEFAULT_SERVER_URL = https://relay.evezero.cn
└─ Web:当前页面同源地址(/api、/ws/relay)
- 地址持久化到 WebView/浏览器的 localStorage,关闭 App、重启手机后依然存在
- REST 与 WebSocket 都由同一个根地址派生:
https://host→https://host/api与wss://host/ws/relay - 所有请求在发起时动态读取地址(
getApiBaseUrl()),保存后立即生效,不需要重启或重新安装 APK - 切换服务器(host/origin 变化)时清除旧 access token 并断开 WebSocket,回到登录页;
serverUrl本身保留 - 连通性自检使用公开接口,不需要 Token、不携带 Authorization:
GET /api/health(=/api/health/=/api/public/health) - 测试结果按真实 HTTP 状态分类:
200 + status=UP→ 连接成功;401→ 「服务器可以访问,但健康检查接口需要认证,请检查服务端安全配置」;403→ CORS / 来源白名单问题;5xx、DNS、连接被拒绝、超时、证书错误分别提示 - 健康检查使用独立的 axios 实例(无 JWT 拦截器、无 401 自动登出), 不会被包装成 NetworkError
服务端 CORS 与 Android App 来源:
- Capacitor Android WebView 的请求 Origin 固定为
https://localhost(默认androidScheme=https+hostname=localhost,本项目在client/capacitor.config.ts中已显式声明) - 服务端
CorsConfig在APP_CORS_ALLOWED_ORIGINS之外内置放行https://localhost/http://localhost/capacitor://localhost与本地 Vite 开发地址,避免「浏览器能访问、App 被 CORS 403 拒绝」 - 预检允许
GET/POST/PUT/PATCH/DELETE/OPTIONS与Authorization/Content-Type/Accept/Origin/X-Requested-With allowCredentials=true时使用allowedOriginPatterns(回显来源), 不会产生Access-Control-Allow-Origin: *的非法组合
构建 Android APK 默认地址:
不设置 VITE_DEFAULT_SERVER_BASE_URL → Android 首装默认 https://relay.evezero.cn
设置 VITE_DEFAULT_SERVER_BASE_URL → 覆盖为自定义默认值(仅默认值,用户保存值永远优先)
cd server
mvn clean test # 42 tests
mvn clean package # BUILD SUCCESS, JAR: server/target/usb-relay-cloud-server-0.1.0-SNAPSHOT.jarcd client
npm run typecheck # vue-tsc --noEmit
npm test -- --run # 125 tests
npm run build # vite buildcd client
npx cap sync android
cd android
.\gradlew.bat clean assembleDebug # BUILD SUCCESSFUL# 需要 Server 和 MySQL 已启动
node deploy/scripts/verify-closed-loop.mjs脚本覆盖:login → 401 → WS AUTH → POST → 幂等 → 实时广播 → gap replay。
V1 支持两套等价的生产部署方案。两套方案都遵守同样的安全约束:对外只开放 Nginx 端口,Spring Boot 8080 与 MySQL 3306 不暴露公网。
Internet
-> Host:8088 -> Nginx:80
-> /api/ -> Spring Boot:8080 (Docker 内网)
-> /ws/ -> Spring Boot:8080 (Docker 内网)
-> / -> Vue static files
-> MySQL:3306 (Docker 内网,不暴露)
cd deploy
cp .env.example .env
chmod 600 .env
# 编辑 .env 设置 JWT_SECRET, ADMIN 密码等
sh scripts/start.shInternet
-> :80 (或 :443 + TLS) -> Nginx (Host)
-> /api/ proxy_pass http://127.0.0.1:8080
-> /ws/ proxy_pass http://127.0.0.1:8080 (WebSocket Upgrade)
-> / -> /var/www/usb-relay-cloud (Vue dist)
-> systemd -> java -jar (127.0.0.1:8080,非 root)
-> mysql.service (127.0.0.1:3306)
部署文件位于 deploy/native/:
| 文件 | 安装位置 | 用途 |
|---|---|---|
usb-relay-cloud.service |
/etc/systemd/system/ |
systemd 服务 |
usb-relay-cloud.env.example |
/etc/usb-relay-cloud/usb-relay-cloud.env |
Spring Boot 敏感配置(chmod 600) |
nginx.conf |
/etc/nginx/sites-available/usb-relay-cloud |
Nginx 反代 + WebSocket |
详细 Ubuntu 24.04 部署流程见 docs/deployment.md。
- 当前主要为单 admin 使用模式
- V1 尚未实现正式多用户注册管理
- 无远程 Device Agent command(Cloud-to-Device 远程控制未实现)
- LCUS-1 无硬件状态回读,
hardwareState始终为 UNKNOWN - Web Serial 受浏览器 secure context 限制(局域网 HTTP 不可用)
- Android App 没有后台常驻、开机启动或 Foreground Service
以下仅为 Roadmap,V1 未实现:
- 多账号、用户注册 / 管理
- RBAC 细粒度权限
- Device ACL 管理 UI
- Device Agent(远程设备代理)
- Remote Command(远程下发控制)
relay_command表 + command ACK- Audit Log(actor / executor 审计)
- Admin Console
- Refresh Token
MIT License — 见 LICENSE。
Copyright (c) 2026 AbsoluteZero