适合 500 平方米以内的小型办公室或单个房间。室内用 BLE 信标定位，室外用追踪器自带的 GNSS 定位，画在同一张地图上，并支持进出围栏告警。
使用限制： 本系统不是安全认证系统，位置可能延迟、错误或缺失（LoRaWAN 上行可能丢包，GNSS 在室内不可用，BLE 定位在金属环境下会变差）。不要把它作为人身安全场景的唯一控制手段。
把蓝牙信标固定安装在室内，作为定位参考点。只靠 GNSS 覆盖的区域（院子、道路、停车场）不需要放信标。
| 现象 | 处理 |
|---|---|
| 信标指示灯不亮 | 更换电池 |
| 定位不准 | 增加信标数量或缩小间距 |
| 追踪器扫不到信标 | 调整安装位置，避免过高或被遮挡 |
| 人在楼里但一直显示"室外" | 把该信标的 MAC 加进地图配置，未配置的信标不参与室内判定 |
接入网关，打通追踪器与定位应用之间的无线链路。
| 现象 | 处理 |
|---|---|
| 指示灯不亮 | 检查电源适配器与线缆 |
| 红灯闪烁 | 检查网线或 WiFi 配置 |
| App 扫码失败 | 确认网关已联网 |
| 追踪器数据不上报 | 确认网关与追踪器频段一致 |
部署定位应用。部署前先准备好应用镜像（见套餐说明）。
把定位应用部署到本机。
.pmtiles 地图文件放到 compose 文件旁边的 data/pmtiles 目录osmOpenStreetMap 栅格瓦片需要主机联网；离线（PMTiles）改读本地归档。
./data/pmtiles存放 .pmtiles 归档的主机目录，以只读方式挂到 /app/uploads/pmtiles。只有底图选离线 PMTiles 时才用。归档不在别处就保持默认值。
| 现象 | 处理 |
|---|---|
| 部署失败 | 启动 Docker Desktop |
| 找不到镜像 | 从上游分支构建镜像并在本地打同名 tag |
| 端口被占用 | 关掉占用 5173 的程序或换端口 |
| 网页打不开 | 等几分钟后刷新 |
http://localhost:5173，用 admin / 12345678 登录（登录后在「配置 → 认证」修改默认密码）配置追踪器，确认室内和室外两种定位数据都能上报。
| 现象 | 处理 |
|---|---|
| 开机后一直闪烁 | 检查网关是否在线、频段是否一致 |
| 网页上看不到追踪器 | 检查面板里的网络服务器 / SenseCAP 接入设置 |
| 位置不更新 | 按键触发上报，或调整上报周期 |
| 室内位置显示错误 | 检查平面图上的信标标注 |
| 不切到室外 | 需要 20 s 内 3 次 GNSS 定位且 15 s 内没有扫到已配置信标；靠窗位置可能来回切换 |
把平面图对齐到室外地图，让室内外轨迹显示在同一个视图。不需要室内外同屏时可以跳过。
admin 登录.pmtiles 地图）原点要放在你关心的区域 2 km 以内。
| 现象 | 处理 |
|---|---|
| 保存返回 422 | 纬度不能超过 85°，缩放必须大于 0 |
| 保存返回 403 | 换 admin 登录 |
| 刷新后参数丢失 | 重新保存，确认出现 "Registration saved." |
| 填完坐标后地图一片纯蓝 | 手动把视野移回站点再填一次 |
| 旋转/缩放把手不出现 | 退出后重新进入配准模式 |
刷新浏览器，重新进入配准模式并选中同一张图，四个参数仍是保存值；这张图上的设备轨迹与室外轨迹显示在同一张地图上。
在室外地图上画一个围栏，设备进出时告警。围栏里不需要放信标。
radius_mlocation_mode 设为 geo，指向该围栏，选择方向| 现象 | 处理 |
|---|---|
| 完全不告警 | 穿越不足 3 条上行或不足 10 s，把围栏画大些或缩短上报周期 |
| 告警偏晚 | 属正常，需要连续 3 个点且跨度至少 10 s |
| 重启后立刻来一条告警 | 检查是否重复配置了同一条规则 |
time_range 不起作用 | 属正常，geo 模式下不使用该字段 |
| 仍然强制要选信标 | 把 location_mode 改成 geo |
进入和离开各出现一条告警，在边界上徘徊不产生告警。告警出现在面板的告警列表里。
定位面板已就绪。点击下方在浏览器中打开。
| 现象 | 处理 |
|---|---|
| 页面无法加载 | 确认前一个部署步骤已成功，服务运行正常 |
| 主机/端口错误 | 部署到远程设备时，用实际设备 IP 更新地址 |
| 地图下拉里没有"室外" | 用室外版镜像 tag 重新部署 |
系统已就绪。
适合 500-2000 平方米的中型场地，例如仓库、办公楼或门店。室内用 BLE 信标定位，室外用追踪器自带的 GNSS 定位，画在同一张地图上，并支持进出围栏告警。
使用限制： 本系统不是安全认证系统，位置可能延迟、错误或缺失（LoRaWAN 上行可能丢包，GNSS 在室内不可用，BLE 定位在金属环境下会变差）。不要把它作为人身安全场景的唯一控制手段。
把蓝牙信标固定安装在室内，作为定位参考点。只靠 GNSS 覆盖的区域（院子、道路、停车场）不需要放信标。
| 现象 | 处理 |
|---|---|
| 信标指示灯不亮 | 更换电池 |
| 定位不准 | 增加信标数量或缩小间距 |
| 追踪器扫不到信标 | 调整安装位置，避免过高或被遮挡 |
| 人在楼里但一直显示"室外" | 把该信标的 MAC 加进地图配置，未配置的信标不参与室内判定 |
接入网关，打通追踪器与定位应用之间的无线链路。
| 现象 | 处理 |
|---|---|
| 指示灯不亮 | 检查电源适配器与线缆 |
| 红灯闪烁 | 检查网线或 WiFi 配置 |
| App 扫码失败 | 确认网关已联网 |
| 追踪器数据不上报 | 确认网关与追踪器频段一致 |
部署定位应用。部署前先准备好应用镜像（见套餐说明）。
把定位应用部署到本机。
.pmtiles 地图文件放到 compose 文件旁边的 data/pmtiles 目录osmOpenStreetMap 栅格瓦片需要主机联网；离线（PMTiles）改读本地归档。
./data/pmtiles存放 .pmtiles 归档的主机目录，以只读方式挂到 /app/uploads/pmtiles。只有底图选离线 PMTiles 时才用。归档不在别处就保持默认值。
| 现象 | 处理 |
|---|---|
| 部署失败 | 启动 Docker Desktop |
| 找不到镜像 | 从上游分支构建镜像并在本地打同名 tag |
| 端口被占用 | 关掉占用 5173 的程序或换端口 |
| 网页打不开 | 等几分钟后刷新 |
http://localhost:5173，用 admin / 12345678 登录（登录后在「配置 → 认证」修改默认密码）配置追踪器，确认室内和室外两种定位数据都能上报。
| 现象 | 处理 |
|---|---|
| 开机后一直闪烁 | 检查网关是否在线、频段是否一致 |
| 网页上看不到追踪器 | 检查面板里的网络服务器 / SenseCAP 接入设置 |
| 位置不更新 | 按键触发上报，或调整上报周期 |
| 室内位置显示错误 | 检查平面图上的信标标注 |
| 不切到室外 | 需要 20 s 内 3 次 GNSS 定位且 15 s 内没有扫到已配置信标；靠窗位置可能来回切换 |
把平面图对齐到室外地图，让室内外轨迹显示在同一个视图。不需要室内外同屏时可以跳过。
admin 登录.pmtiles 地图）原点要放在你关心的区域 2 km 以内。
| 现象 | 处理 |
|---|---|
| 保存返回 422 | 纬度不能超过 85°，缩放必须大于 0 |
| 保存返回 403 | 换 admin 登录 |
| 刷新后参数丢失 | 重新保存，确认出现 "Registration saved." |
| 填完坐标后地图一片纯蓝 | 手动把视野移回站点再填一次 |
| 旋转/缩放把手不出现 | 退出后重新进入配准模式 |
刷新浏览器，重新进入配准模式并选中同一张图，四个参数仍是保存值；这张图上的设备轨迹与室外轨迹显示在同一张地图上。
在室外地图上画一个围栏，设备进出时告警。围栏里不需要放信标。
radius_mlocation_mode 设为 geo，指向该围栏，选择方向| 现象 | 处理 |
|---|---|
| 完全不告警 | 穿越不足 3 条上行或不足 10 s，把围栏画大些或缩短上报周期 |
| 告警偏晚 | 属正常，需要连续 3 个点且跨度至少 10 s |
| 重启后立刻来一条告警 | 检查是否重复配置了同一条规则 |
time_range 不起作用 | 属正常，geo 模式下不使用该字段 |
| 仍然强制要选信标 | 把 location_mode 改成 geo |
进入和离开各出现一条告警，在边界上徘徊不产生告警。告警出现在面板的告警列表里。
定位面板已就绪。点击下方在浏览器中打开。
| 现象 | 处理 |
|---|---|
| 页面无法加载 | 确认前一个部署步骤已成功，服务运行正常 |
| 主机/端口错误 | 部署到远程设备时，用实际设备 IP 更新地址 |
| 地图下拉里没有"室外" | 用室外版镜像 tag 重新部署 |
系统已就绪。
适合 2000 平方米以上的大型园区、多楼层建筑，以及室内外都要覆盖的站点。室内用 BLE 信标定位，室外用追踪器自带的 GNSS 定位，画在同一张地图上，并支持进出围栏告警。
使用限制： 本系统不是安全认证系统，位置可能延迟、错误或缺失（LoRaWAN 上行可能丢包，GNSS 在室内不可用，BLE 定位在金属环境下会变差）。不要把它作为人身安全场景的唯一控制手段。
把蓝牙信标固定安装在室内，作为定位参考点。只靠 GNSS 覆盖的区域（院子、道路、停车场）不需要放信标。
| 现象 | 处理 |
|---|---|
| 信标指示灯不亮 | 更换电池 |
| 定位不准 | 增加信标数量或缩小间距 |
| 追踪器扫不到信标 | 调整安装位置，避免过高或被遮挡 |
| 人在楼里但一直显示"室外" | 把该信标的 MAC 加进地图配置，未配置的信标不参与室内判定 |
接入网关，打通追踪器与定位应用之间的无线链路。
| 现象 | 处理 |
|---|---|
| 指示灯不亮 | 检查电源适配器与线缆 |
| 红灯闪烁 | 检查网线或 WiFi 配置 |
| App 扫码失败 | 确认网关已联网 |
| 追踪器数据不上报 | 确认网关与追踪器频段一致 |
部署定位应用。部署前先准备好应用镜像（见套餐说明）。
把定位应用部署到本机。
.pmtiles 地图文件放到 compose 文件旁边的 data/pmtiles 目录osmOpenStreetMap 栅格瓦片需要主机联网；离线（PMTiles）改读本地归档。
./data/pmtiles存放 .pmtiles 归档的主机目录，以只读方式挂到 /app/uploads/pmtiles。只有底图选离线 PMTiles 时才用。归档不在别处就保持默认值。
| 现象 | 处理 |
|---|---|
| 部署失败 | 启动 Docker Desktop |
| 找不到镜像 | 从上游分支构建镜像并在本地打同名 tag |
| 端口被占用 | 关掉占用 5173 的程序或换端口 |
| 网页打不开 | 等几分钟后刷新 |
http://localhost:5173，用 admin / 12345678 登录（登录后在「配置 → 认证」修改默认密码）配置追踪器，确认室内和室外两种定位数据都能上报。
| 现象 | 处理 |
|---|---|
| 开机后一直闪烁 | 检查网关是否在线、频段是否一致 |
| 网页上看不到追踪器 | 检查面板里的网络服务器 / SenseCAP 接入设置 |
| 位置不更新 | 按键触发上报，或调整上报周期 |
| 室内位置显示错误 | 检查平面图上的信标标注 |
| 不切到室外 | 需要 20 s 内 3 次 GNSS 定位且 15 s 内没有扫到已配置信标；靠窗位置可能来回切换 |
把平面图对齐到室外地图，让室内外轨迹显示在同一个视图。不需要室内外同屏时可以跳过。
admin 登录.pmtiles 地图）原点要放在你关心的区域 2 km 以内。
| 现象 | 处理 |
|---|---|
| 保存返回 422 | 纬度不能超过 85°，缩放必须大于 0 |
| 保存返回 403 | 换 admin 登录 |
| 刷新后参数丢失 | 重新保存，确认出现 "Registration saved." |
| 填完坐标后地图一片纯蓝 | 手动把视野移回站点再填一次 |
| 旋转/缩放把手不出现 | 退出后重新进入配准模式 |
刷新浏览器，重新进入配准模式并选中同一张图，四个参数仍是保存值；这张图上的设备轨迹与室外轨迹显示在同一张地图上。
在室外地图上画一个围栏，设备进出时告警。围栏里不需要放信标。
radius_mlocation_mode 设为 geo，指向该围栏，选择方向| 现象 | 处理 |
|---|---|
| 完全不告警 | 穿越不足 3 条上行或不足 10 s，把围栏画大些或缩短上报周期 |
| 告警偏晚 | 属正常，需要连续 3 个点且跨度至少 10 s |
| 重启后立刻来一条告警 | 检查是否重复配置了同一条规则 |
time_range 不起作用 | 属正常，geo 模式下不使用该字段 |
| 仍然强制要选信标 | 把 location_mode 改成 geo |
进入和离开各出现一条告警，在边界上徘徊不产生告警。告警出现在面板的告警列表里。
定位面板已就绪。点击下方在浏览器中打开。
| 现象 | 处理 |
|---|---|
| 页面无法加载 | 确认前一个部署步骤已成功，服务运行正常 |
| 主机/端口错误 | 部署到远程设备时，用实际设备 IP 更新地址 |
| 地图下拉里没有"室外" | 用室外版镜像 tag 重新部署 |
系统已就绪。