途强物联转 Traccar - Home Assistant 集成
将途强物联（www.tuqiang.net）GPS 定位设备的位置数据实时转发至您自建的 Traccar 服务器。
本集成以轻量级后台服务形式运行，不会在 Home Assistant 中创建任何实体，仅负责定时获取途强平台设备位置并通过 Traccar 的 OsmAnd 协议上报。
功能特点
-
支持途强物联平台（tuqiang.net）账号登录 -
自动获取账号下所有设备列表，可自由勾选需要转发的设备
-
自定义 Traccar 服务器地址（支持 HTTP/HTTPS）
-
可选设备标识前缀，便于多车管理
-
可配置上报间隔（10～3600 秒）
-
纯后台运行，零实体占用
安装
方式一：通过 HACS 自定义仓库（推荐）
- 确保已安装 HACS
- 在 HACS 中点击「集成」→ 右上角菜单 →「自定义存储库」
- 填写仓库地址：
https://github.com/lambilly/ha_tuqiang_traccar，类别选择「集成」 - 点击添加，然后在 HACS 中搜索「途强物联转Traccar」并安装
- 重启 Home Assistant
方式二：手动安装
- 下载本仓库最新 Release 中的
tuqiang_traccar.zip并解压 - 将
custom_components/tuqiang_traccar文件夹复制到您 Home Assistant 配置目录下的custom_components目录中 - 重启 Home Assistant
配置
第一步：添加集成
- 在 Home Assistant 中，前往「设置」→「设备与服务」→「添加集成」
- 搜索「途强物联转Traccar」并点击
第二步：输入途强物联账号
| 字段 | 说明 |
|---|---|
| 用户名 | 您的途强物联登录账号 |
| 密码 | 对应的登录密码 |
第三步：选择要转发的设备
系统会列出您账号下所有设备（IMEI + 设备名称），勾选需要转发到 Traccar 的设备即可。
第四步：配置 Traccar 服务器
| 字段 | 说明 |
|---|---|
| Traccar 服务器地址 |
必填，格式如 http://192.168.1.100:5055 注意：端口应为 Traccar 客户端接入端口（默认 5055），而非 Web 管理端口（默认 8082） |
| 设备标识前缀（可选） | 可在此填写一个字符串，最终上报的设备标识将为 前缀+IMEI，例如前缀 car_，则设备 ID 为 car_1234567890
|
| 上报间隔（秒） | 数据获取与上报的时间间隔，建议 30～60 秒 |
点击提交后，集成即开始运行。
在 Traccar 中添加设备
在 Traccar 网页管理后台中：
- 进入设备管理页面
- 点击「添加设备」
- 填写设备名称（任意）
-
标识符一栏填写与集成配置一致的 ID：
- 若未设置前缀：直接填写途强设备的 IMEI
- 若设置了前缀：填写
前缀 + IMEI（例如car_1234567890）
- 保存即可，稍后即可看到设备位置更新。
常见问题
1. 为什么集成中没有生成任何实体？
本集成设计为纯数据转发工具，不会在 Home Assistant 中产生 device_tracker 或 sensor 实体。若您需要在 HA 中查看设备位置，建议使用 Traccar 官方集成 或直接在 Traccar 中查看。
2. 设备位置长时间不更新？
- 检查途强平台中设备是否在线
- 检查 Traccar 服务器地址及端口是否可达（可尝试在浏览器中访问
http://your-server:5055/，应返回空白页或状态信息） - 查看 Home Assistant 日志（设置 → 系统 → 日志），搜索
tuqiang_traccar查看详细错误
3. Traccar 中看不到设备位置？
- 确认 Traccar 服务器已添加对应标识符的设备
- 检查 Traccar 日志，查看是否有来自 Home Assistant IP 的请求记录
- 尝试将上报间隔缩短至 10 秒以快速测试
4. 登录失败，提示“invalid_auth”？
- 请确认用户名密码无误，且账号可在途强官方 App 或网页正常登录
- 如账号开启了二次验证，请暂时关闭后再尝试（途强平台部分账号可能要求短信验证）
许可
本项目基于 MIT 协议开源，详见 LICENSE 文件。
作者
lambilly
- GitHub: @lambilly
致谢
- Home Assistant
- Traccar
- 途强物联平台