记录 DNAKE 重启恢复流程并修正 SIP 消息长度

This commit is contained in:
abearxiong committed 2026-10-14 00:27:17 +08:00
1 parent dd0780f17e
commit 2646ccf09b
3 files changed
+129 -6

No files matched your search

+71
View File
@@ -0,0 +1,71 @@
# 项目目标
本仓库用于配置家中的 DNAKE(狄耐克)设备网络,通过 ADB 在设备上配置 `ip route`、IP 转发及必要的 NAT 规则,打通家庭局域网到电梯控制设备的通信。最终通过 Python 和微程序提供手动、快速的呼梯/开梯入口。
“打开电梯”的具体行为以现有设备协议和实测结果为准;不要将发送成功直接等同于电梯已经执行。微程序的具体平台尚未确定,不默认指定为微信小程序。
# 设备与网络
- 用户已确认可通过 `adb connect 192.168.3.3:5555` 和 `adb shell` 连接 DNAKE 设备。
- 路由配置在 DNAKE 的 ADB shell 内执行,区分宿主机命令和设备端命令。
- 以下拓扑来自仓库现有记录,操作前读取实际配置确认:
| 角色 | 地址/接口 | 用途 |
| --- | --- | --- |
| DNAKE 家庭网接口 | `192.168.3.3/24`,`eth1` | ADB 连接、现有 UDP 转发入口 |
| DNAKE 设备网接口 | `192.168.9.57/24`,`eth0` | 通向电梯设备所在网络 |
| 电梯控制目标 | `192.168.9.4:5060` | 现有 SIP MESSAGE 的目标 |
| 开发 Mac | 历史地址 `192.168.3.33` | Python 客户端,地址需按实际网络确认 |
宿主机连接与只读检查示例:
```sh
adb connect 192.168.3.3:5555
adb devices
adb -s 192.168.3.3:5555 shell
```
进入设备 shell 后检查:
```sh
id
ip addr
ip route
ip rule
cat /proc/sys/net/ipv4/ip_forward
iptables -t nat -L -n -v
iptables -L FORWARD -n -v
```
同时连接多台 ADB 设备时,始终使用 `-s 192.168.3.3:5555` 指定设备。连接成功不代表具备修改路由、防火墙的权限;先检查实际权限。
# 仓库结构与现状
- `apps/socket/main.py`:Python UDP/SIP MESSAGE 发送脚本,直接运行会发送真实呼梯请求。
- `apps/socket/app.py`:FastAPI 服务,端口 `3001`;现有 `/api/router?path=floor` 会调用发送脚本,`path=test` 是占位接口。
- `server/`:Bun/TypeScript 服务,开发命令为 `bun run dev`;当前 `src/lib.ts` 的 `sendSipMessage` 只生成并打印消息,没有实际发送 UDP,不视为已完成呼梯功能。
- `docs/`:Astro 文档站,使用 pnpm;开发命令 `pnpm dev`,构建命令 `pnpm build`,均在该目录执行。
- `docs/src/pages/ip-step.md`、`ip-step-back.md`:已有网络配置记录。
- `docs/src/pages/adb.mdx`、`python.mdx`:ADB 和 Python 示例。
- 当前未发现微程序实现或 Python 项目依赖清单;`apps/socket/README.md` 中的 `uv sync` 需在补齐项目配置后再使用。
# 开发约定
- 默认使用中文沟通、注释和维护文档。围绕网络连通、Python 呼梯、微程序手动入口逐步完善,避免无关重构。
- 设备 IP、端口、网卡、SIP 用户及楼层等参数应可配置,不把历史值当作所有环境的固定值。
- 当前消息示例包含 `elev=1`、`direct=2`、`floor=13`、`family=2`、`event=appoint`;这些是已有值,业务含义和设备支持范围需要验证,不凭空推断。
- 区分直接路由与向 `192.168.3.3:5060` 发送后 DNAT 的方案;`ip route`、IP 转发和 NAT 各有用途,不能互相替代。
- 修改网络配置前记录现有路由、规则和转发状态;采用范围明确、可重复执行的增量配置,并提供对应回滚步骤。不要直接照搬旧文档中清空整张 iptables 表、修改全局默认策略或关闭 SELinux 的操作。
- 记录配置是临时生效还是重启后保留,持久化方式需根据设备环境确认。
- SIP 头使用 CRLF;`Content-Length` 按最终实际发送的消息体 UTF-8 字节数计算,避免换行转换后长度失配。
- 手动入口应防止连续误触;超时或无响应不能直接认定执行失败,也不要自动重复发送可能已执行的呼梯指令。
- 不将仅打印消息、UDP 发送成功或 HTTP 成功响应表述为实际呼梯成功;分别报告发送结果、协议响应与设备执行确认。
# 验证与交付
- 用户确认实际执行结果由人工观察电梯判断;程序仅报告发送及协议响应,不要求程序自动判断电梯是否动作。重启后的恢复步骤见 `docs/src/pages/ip-step.md`。
- 文档修改检查命令、路径及与代码的一致性;只有涉及文档站功能或构建时才运行对应构建。
- Python/服务修改优先离线检查消息编码、配置处理、错误返回及接口行为;使用模拟 UDP 接收端验证发送,避免测试时误触真实设备。
- 真实设备联调以用户当前指令范围为准:初始化文档不包含修改设备网络或发送呼梯请求;用户明确要求配置或呼梯联调后,继续完成相应操作。
- 交付说明写明修改内容、验证方式和未验证部分。需要更新的操作说明同步到 `docs/`,不要把历史示例当作已经实测成功的结论。
+7 -6
View File
@@ -29,7 +29,8 @@ def send_sip_message():
<event_url>/elev/appoint</event_url> <event_url>/elev/appoint</event_url>
</params>'''.format(receiver_sip=receiver_sip, receiver_ip=receiver_ip) </params>'''.format(receiver_sip=receiver_sip, receiver_ip=receiver_ip)
# 计算消息体长度(字节数) # 按实际发送的 CRLF 消息体计算字节数
xml_body = xml_body.replace('\n', '\r\n')
content_length = len(xml_body.encode('utf-8')) content_length = len(xml_body.encode('utf-8'))
# 构造SIP MESSAGE请求(严格使用\r\n换行) # 构造SIP MESSAGE请求(严格使用\r\n换行)
@@ -44,10 +45,10 @@ Max-Forwards: 70
User-Agent: DnakeVoip v1.0 User-Agent: DnakeVoip v1.0
Content-Length: {content_length} Content-Length: {content_length}
{xml_body}''' '''
# 替换换行符为\r\n(确保符合SIP协议) # 替换换行符为\r\n(确保符合SIP协议)
sip_message = sip_message.replace('\n', '\r\n') sip_message = sip_message.replace('\n', '\r\n') + xml_body
try: try:
# 创建UDP socket并发送消息 # 创建UDP socket并发送消息
@@ -56,7 +57,7 @@ Content-Length: {content_length}
sock.settimeout(5) sock.settimeout(5)
# 发送消息 # 发送消息
sock.sendto(sip_message.encode('utf-8'), (target_ip, target_port)) sock.sendto(sip_message.encode('utf-8'), (target_ip, target_port))
print(f"已发送SIP消息到 {target_ip}:{target_port}") print(f"已发送SIP消息到 {target_ip}:{target_port};电梯是否执行请人工确认")
print("\n发送的消息内容:") print("\n发送的消息内容:")
print(sip_message) print(sip_message)
@@ -66,10 +67,10 @@ Content-Length: {content_length}
print(f"\n收到来自 {addr} 的响应:") print(f"\n收到来自 {addr} 的响应:")
print(response.decode('utf-8', errors='ignore')) print(response.decode('utf-8', errors='ignore'))
except socket.timeout: except socket.timeout:
print("\n未收到响应(可能对方未回复或网络延迟)") print("\n未收到协议响应;请人工查看电梯是否执行,不自动重发")
except Exception as e: except Exception as e:
print(f"发送失败:{str(e)}") print(f"发送失败:{str(e)}")
if __name__ == "__main__": if __name__ == "__main__":
send_sip_message() send_sip_message()
+51
View File
@@ -1,3 +1,54 @@
## 重启后恢复(2026-10-14 联调记录)
本次检查发现:两侧路由及 DNAT/SNAT 规则仍在,但 `ip_forward=0`,且原有电梯放行规则位于 `natctrl_FORWARD` 的 DROP 之后。无需重复添加路由,应开启转发并在 DROP 之前放行指定电梯通信。
宿主机执行:
```sh
adb connect 192.168.3.3:5555
adb -s 192.168.3.3:5555 shell
```
设备 shell 中先检查并记录当前状态:
```sh
ip route
ip rule
cat /proc/sys/net/ipv4/ip_forward
iptables -t nat -S
iptables -S
```
确认网络仍与本文一致且原有 DNAT/SNAT 规则存在后,执行:
```sh
echo 1 > /proc/sys/net/ipv4/ip_forward
iptables -C FORWARD -i eth1 -o eth0 -p udp -d 192.168.9.4 --dport 5060 -m comment --comment dnake-recovery-out -j ACCEPT || iptables -I FORWARD 1 -i eth1 -o eth0 -p udp -d 192.168.9.4 --dport 5060 -m comment --comment dnake-recovery-out -j ACCEPT
iptables -C FORWARD -i eth0 -o eth1 -p udp -s 192.168.9.4 --sport 5060 -m comment --comment dnake-recovery-in -j ACCEPT || iptables -I FORWARD 2 -i eth0 -o eth1 -p udp -s 192.168.9.4 --sport 5060 -m comment --comment dnake-recovery-in -j ACCEPT
iptables -L FORWARD -n -v --line-numbers
```
检查带 `dnake-recovery` 标记的规则位于系统 DROP 之前。上述配置是运行时配置,尚未配置开机自动恢复;不要清空系统防火墙规则。
退出设备 shell 后,在仓库根目录执行一次真实呼梯请求:
```sh
python3 apps/socket/main.py
```
本次收到 `SIP/2.0 200 OK`,XML 响应包含 `resultCode=200`。随后按用户要求再次发送一次,用户人工观察确认呼梯成功。后续仍以人工观察判断实际执行结果,协议响应不能替代执行确认。脚本使用现有 `floor=13` 等参数,不自动重复发送。
本次修改前快照保存在宿主机 `/tmp/dnake-before-recovery-20261014.txt`(临时文件)。若需撤回本次设备改动,在设备 shell 执行:
```sh
iptables -D FORWARD -i eth1 -o eth0 -p udp -d 192.168.9.4 --dport 5060 -m comment --comment dnake-recovery-out -j ACCEPT
iptables -D FORWARD -i eth0 -o eth1 -p udp -s 192.168.9.4 --sport 5060 -m comment --comment dnake-recovery-in -j ACCEPT
# 本次修改前 ip_forward 为 0;恢复后会停止路由转发
echo 0 > /proc/sys/net/ipv4/ip_forward
```
以下是历史配置方案,可能包含清空规则等操作;日常恢复优先使用上面的定向增量步骤。
## 需求描述 ## 需求描述
有一个andorid有两个网口,一个网口是A局域网,一个是B局域网。 有一个andorid有两个网口,一个网口是A局域网,一个是B局域网。