套餐: 入门套件 {#starter}

适合小型办公室或单个房间，面积 500 平方米以内。快速上手，硬件需求最少。

部署完成后你可以：

• 实时查看资产/人员位置
• 在网页地图上可视化展示
• 支持区域定位或三角定位

覆盖范围： 约 500 平方米 · LoRaWAN 覆盖半径 2 公里

步骤 1: 部署 BLE 信标 {#beacons type=manual required=true}

在室内各处安装 BLE 信标作为定位参考点。

接线

根据定位精度选择安装数量：

• 三角定位（米级精度）：每个区域至少 3 个信标
• 区域定位（判断在不在）：每个区域 1 个信标即可

安装要求：

• 安装高度：2.5-3 米（避免被人体遮挡）
• 信标间距：10-15 米
• 避免安装在金属表面附近

安装步骤：

1. 规划信标位置，画一张简单的布局图
2. 用双面胶或螺丝固定信标
3. 记录每个信标的 MAC 地址和安装位置（后面配置要用）

MAC 地址印在信标背面，格式如 AA:BB:CC:DD:EE:FF

故障排查

步骤 2: 设置 LoRaWAN 网关 {#gateway type=manual required=true}

连接网关，建立追踪器与定位应用之间的通信。

接线

安装步骤：

1. 网关通电，连接网络（以太网或 WiFi）
2. 使用 SenseCraft App 扫码绑定网关
3. 等待 LED 常亮绿色，表示网关就绪

放置建议：

• 放在场地中央位置，覆盖范围最大
• 室内覆盖半径约 500 米，室外可达 2 公里
• 避免放在金属柜子里或地下室

故障排查

步骤 3: 部署定位应用程序 {#app_server type=docker_deploy required=true config=devices/app_local.yaml}

部署目标: 本机部署 {#app_server_local type=local config=devices/app_local.yaml default=true}

将室内定位应用程序部署到您的本地电脑。

接线

1. 确保 Docker Desktop 已安装并运行
2. 确保端口 5173 可用

部署完成

1. 访问 http://localhost:5173，使用 admin / 83EtWJUbGrPnQjdCqyKq 登录
2. 上传楼层地图，在地图上标记信标位置（输入 MAC 地址）
3. 配置 LoRaWAN 网络服务器的 Webhook 指向 http://你的IP:5173/api/webhook

故障排查

部署目标: 远程部署 {#app_server_remote type=remote config=devices/app_remote.yaml}

通过 SSH 将室内定位应用程序部署到远程服务器。

接线

1. 将目标设备连接到网络
2. 获取设备 IP 地址
3. 获取 SSH 凭据（用户名/密码）
4. 确保远程服务器已安装 Docker

部署完成

1. 访问 http://<设备IP>:5173，使用 admin / 83EtWJUbGrPnQjdCqyKq 登录
2. 上传楼层地图，在地图上标记信标位置（输入 MAC 地址）
3. 配置 LoRaWAN 网络服务器的 Webhook 指向 http://<设备IP>:5173/api/webhook

故障排查

步骤 4: 配置并激活追踪器 {#tracker type=manual required=true}

配置追踪器，在信标附近走动测试定位是否正常。

接线

1. 长按电源键 3 秒开机，绿灯闪烁表示正在入网
2. 入网成功后绿灯熄灭，追踪器进入工作状态
3. 打开 SenseCraft App，蓝牙连接追踪器
4. 设置工作模式为"BLE 扫描"
5. 选择正确的 LoRaWAN 区域（如 CN470、US915、EU868）
6. 保存配置
7. 走到信标附近，按追踪器按钮触发上报
8. 在定位应用网页上查看位置是否正确显示

故障排查

套餐: 标准配置 {#standard}

适合中型场所（500-2000 平方米），如仓库、办公楼、零售店等。

部署完成后你可以：

• 实时查看资产/人员位置
• 多区域覆盖，米级定位精度
• 网页地图可视化，支持历史轨迹回放

覆盖范围： 约 2000 平方米 · 支持多个房间/楼层

步骤 1: 部署 BLE 信标 {#beacons type=manual required=true}

在室内各处安装 BLE 信标作为定位参考点。

接线

根据定位精度选择安装数量：

• 三角定位（米级精度）：每个区域至少 3 个信标
• 区域定位（判断在不在）：每个区域 1 个信标即可

安装要求：

• 安装高度：2.5-3 米（避免被人体遮挡）
• 信标间距：10-15 米
• 避免安装在金属表面附近

安装步骤：

1. 规划信标位置，画一张简单的布局图
2. 用双面胶或螺丝固定信标
3. 记录每个信标的 MAC 地址和安装位置（后面配置要用）

MAC 地址印在信标背面，格式如 AA:BB:CC:DD:EE:FF

故障排查

步骤 2: 设置 LoRaWAN 网关 {#gateway type=manual required=true}

连接网关，建立追踪器与定位应用之间的通信。

接线

安装步骤：

1. 网关通电，连接网络（以太网或 WiFi）
2. 使用 SenseCraft App 扫码绑定网关
3. 等待 LED 常亮绿色，表示网关就绪

放置建议：

• 放在场地中央位置，覆盖范围最大
• 室内覆盖半径约 500 米，室外可达 2 公里
• 避免放在金属柜子里或地下室

故障排查

步骤 3: 部署定位应用程序 {#app_server type=docker_deploy required=true config=devices/app_local.yaml}

部署目标: 本机部署 {#app_server_local type=local config=devices/app_local.yaml default=true}

将室内定位应用程序部署到您的本地电脑。

接线

1. 确保 Docker Desktop 已安装并运行
2. 确保端口 5173 可用

部署完成

1. 访问 http://localhost:5173，使用 admin / 83EtWJUbGrPnQjdCqyKq 登录
2. 上传楼层地图，在地图上标记信标位置（输入 MAC 地址）
3. 配置 LoRaWAN 网络服务器的 Webhook 指向 http://你的IP:5173/api/webhook

故障排查

部署目标: 远程部署 {#app_server_remote type=remote config=devices/app_remote.yaml}

通过 SSH 将室内定位应用程序部署到远程服务器。

接线

1. 将目标设备连接到网络
2. 获取设备 IP 地址
3. 获取 SSH 凭据（用户名/密码）
4. 确保远程服务器已安装 Docker

部署完成

1. 访问 http://<设备IP>:5173，使用 admin / 83EtWJUbGrPnQjdCqyKq 登录
2. 上传楼层地图，在地图上标记信标位置（输入 MAC 地址）
3. 配置 LoRaWAN 网络服务器的 Webhook 指向 http://<设备IP>:5173/api/webhook

故障排查

步骤 4: 配置并激活追踪器 {#tracker type=manual required=true}

配置追踪器，在信标附近走动测试定位是否正常。

接线

1. 长按电源键 3 秒开机，绿灯闪烁表示正在入网
2. 入网成功后绿灯熄灭，追踪器进入工作状态
3. 打开 SenseCraft App，蓝牙连接追踪器
4. 设置工作模式为"BLE 扫描"
5. 选择正确的 LoRaWAN 区域（如 CN470、US915、EU868）
6. 保存配置
7. 走到信标附近，按追踪器按钮触发上报
8. 在定位应用网页上查看位置是否正确显示

故障排查

套餐: 企业版 {#enterprise}

适合大型场所（2000 平方米以上），如工厂、医院、园区等。

部署完成后你可以：

• 园区级实时定位追踪
• 高精度三角定位
• 可扩展到数千个追踪目标

覆盖范围： 2000+ 平方米 · 增加网关可覆盖多栋建筑

步骤 1: 部署 BLE 信标 {#beacons type=manual required=true}

在室内各处安装 BLE 信标作为定位参考点。

接线

根据定位精度选择安装数量：

• 三角定位（米级精度）：每个区域至少 3 个信标
• 区域定位（判断在不在）：每个区域 1 个信标即可

安装要求：

• 安装高度：2.5-3 米（避免被人体遮挡）
• 信标间距：10-15 米
• 避免安装在金属表面附近

安装步骤：

1. 规划信标位置，画一张简单的布局图
2. 用双面胶或螺丝固定信标
3. 记录每个信标的 MAC 地址和安装位置（后面配置要用）

MAC 地址印在信标背面，格式如 AA:BB:CC:DD:EE:FF

故障排查

步骤 2: 设置 LoRaWAN 网关 {#gateway type=manual required=true}

连接网关，建立追踪器与定位应用之间的通信。

接线

安装步骤：

1. 网关通电，连接网络（以太网或 WiFi）
2. 使用 SenseCraft App 扫码绑定网关
3. 等待 LED 常亮绿色，表示网关就绪

放置建议：

• 放在场地中央位置，覆盖范围最大
• 室内覆盖半径约 500 米，室外可达 2 公里
• 避免放在金属柜子里或地下室

故障排查

步骤 3: 部署定位应用程序 {#app_server type=docker_deploy required=true config=devices/app_local.yaml}

部署目标: 本机部署 {#app_server_local type=local config=devices/app_local.yaml default=true}

将室内定位应用程序部署到您的本地电脑。

接线

1. 确保 Docker Desktop 已安装并运行
2. 确保端口 5173 可用

部署完成

1. 访问 http://localhost:5173，使用 admin / 83EtWJUbGrPnQjdCqyKq 登录
2. 上传楼层地图，在地图上标记信标位置（输入 MAC 地址）
3. 配置 LoRaWAN 网络服务器的 Webhook 指向 http://你的IP:5173/api/webhook

故障排查

部署目标: 远程部署 {#app_server_remote type=remote config=devices/app_remote.yaml}

通过 SSH 将室内定位应用程序部署到远程服务器。

接线

1. 将目标设备连接到网络
2. 获取设备 IP 地址
3. 获取 SSH 凭据（用户名/密码）
4. 确保远程服务器已安装 Docker

部署完成

1. 访问 http://<设备IP>:5173，使用 admin / 83EtWJUbGrPnQjdCqyKq 登录
2. 上传楼层地图，在地图上标记信标位置（输入 MAC 地址）
3. 配置 LoRaWAN 网络服务器的 Webhook 指向 http://<设备IP>:5173/api/webhook

故障排查

步骤 4: 配置并激活追踪器 {#tracker type=manual required=true}

配置追踪器，在信标附近走动测试定位是否正常。

接线

1. 长按电源键 3 秒开机，绿灯闪烁表示正在入网
2. 入网成功后绿灯熄灭，追踪器进入工作状态
3. 打开 SenseCraft App，蓝牙连接追踪器
4. 设置工作模式为"BLE 扫描"
5. 选择正确的 LoRaWAN 区域（如 CN470、US915、EU868）
6. 保存配置
7. 走到信标附近，按追踪器按钮触发上报
8. 在定位应用网页上查看位置是否正确显示

故障排查

部署完成

室内定位系统已就绪！

访问系统

• 访问地址： http://<服务器IP>:5173
• 登录账号： admin / 83EtWJUbGrPnQjdCqyKq

初始设置

1. 上传楼层地图图片
2. 在地图上标记信标位置（输入 MAC 地址）
3. 配置 LoRaWAN 网络服务器的 Webhook

快速验证

• 带着追踪器走到信标附近
• 按追踪器按钮触发位置上报
• 在网页看板上查看实时位置更新

后续步骤

• 查看 Wiki 文档
• GitHub 仓库
• 体验在线演示