Skip to content

首页Wiki

2026年10月15日 smtc2web Windows 安装器卡死 逆向分析报告 ​

项目内容
分析对象smtc2web_*_x64-setup.exe(Tauri v2 / NSIS 安装器)
现象安装/卸载时界面卡死在“创建快捷方式”,进程永不退出
结论installer_hooks.nsh 中 无超时的 SendMessage(HWND_BROADCAST, WM_SETTINGCHANGE) 广播被系统中不泵消息的窗口永久阻塞
影响版本0.4.4、0.5.4、0.6.5、0.6.6(以及任何含旧 hook 的构建)
已修复版本0.6.8(commit 69bb1e1,tag v0.6.8)
验证结果0.6.8 静默安装 9 秒完成,退出码 0;0.6.5 静默安装 4 分钟无任何进展
报告日期2026-10-15

0. 摘要(TL;DR) ​

  1. 安装器本身没有损坏:文件解包、快捷方式(含 AppUserModelID)、uninstall.exe、ARP 注册项都已被正确写入。

  2. 卡死点在安装脚本最后阶段的 PATH 注册 hook:

    nsis
    ; installer_hooks.nsh(旧版本)
    SendMessage ${HWND_BROADCAST} ${WM_SETTINGCHANGE} 0 "STR:Environment"
  3. SendMessage(无超时)向 HWND_BROADCAST 广播时,会同步等待会话内每一个顶层窗口处理完该消息。只要存在一个不泵消息的窗口(卡住的 UWP 应用、GPU 覆盖层、安全软件注入的隐藏窗口……),该调用永不返回 → 安装器主线程阻塞 → 窗口停止响应(WER 记录 AppHang)→ 进度停留在最后一行文字“创建快捷方式”。

  4. 该缺陷自 6f7c603(2026-06-23,首个带 PATH hook 的构建,即 0.4.4)起就存在,是否复现取决于当时系统里有没有僵尸窗口,因此与安装器版本无关、与系统状态有关。这正好解释“以前更新能装、现在装不上”。

  5. 0.6.8 已修复:广播改为 SendMessage … /TIMEOUT=1000(编译为 SendMessageTimeout),并把 PATH 写入从 HKLM 改为 currentUser 下的 HKCU\Environment。已实测通过。


1. 样本与格式判定 ​

1.1 文件清单 ​

版本文件名大小 (B)SHA-256
0.3.2smtc2web_0.3.2_x64-setup.exe12 830 929AE2DB5DD…D1E7A596
0.4.4smtc2web_0.4.4_x64-setup.exe14 562 8359FE6AF6A…AD83B6A91
0.5.4smtc2web_0.5.4_x64-setup.exe4 188 88465B47BD3…892D1FDDA53
0.6.5smtc2web_0.6.5_x64-setup.exe5 130 972BAEB3435…E9FD918780
0.6.6smtc2web_0.6.6_x64-setup.exe4 468 30024EF1C34…B35AC09F39
0.6.8smtc2web_0.6.8_x64-setup.exe4 466 722C4AAC2F4…A9B5C7C6B3

(完整哈希见文末附录;所有安装器与内置 smtc2web.exe 均为 NotSigned,无 Authenticode。)

1.2 容器格式 ​

7z l 判定:

Type        = Nsis
SubType     = NSIS-3 Unicode
Method      = LZMA:23
Solid       = +
Headers Size= 83114            (0.6.5)
Embedded Stub Size = 54272      (0xD400)

载荷文件(各版本一致):

$PLUGINSDIR\System.dll            $PLUGINSDIR\nsDialogs.dll
$PLUGINSDIR\modern-wizard.bmp     $PLUGINSDIR\nsis_tauri_utils.dll
$PLUGINSDIR\StartMenu.dll         $PLUGINSDIR\LangDLL.dll
$PLUGINSDIR\NSISdl.dll            smtc2web.exe      uninstall.exe

内置载荷大小:0.3.2 = 40.0 MB、0.4.4 = 46.8 MB、0.5.4 = 17.6 MB、0.6.5 = 20.8 MB、0.6.6/0.6.8 ≈ 17.4 MB。

1.3 安装位置(本机) ​

C:\Users\AkarinLiu\AppData\Local\smtc2web\smtc2web.exe
C:\Users\AkarinLiu\AppData\Local\smtc2web\uninstall.exe
C:\Users\AkarinLiu\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\smtc2web.lnk
HKCU\Software\Microsoft\Windows\CurrentVersion\Uninstall\smtc2web

2. 静态逆向 ​

2.1 手工解析 NSIS 头部 ​

0xDEADBEEF 在文件中出现两次:一次是 stub 代码里的巧合,真正的 NSIS firstheader 位于 PE 覆盖区起始处。

0xD400  00 00 00 00            ; flags
0xD404  EF BE AD DE            ; signature
0xD408  4E 75 6C 6C 73 6F 66 74 49 6E 73 74    ; "NullsoftInst"
0xD414  AA 44 01 00            ; header size      = 83114
0xD418  DC 76 4D 00            ; stub 之后的长度   = 5076700
0xD41C  5D 00 00 80 00         ; LZMA props (lc=3,lp=0,pb=2, dict=8 MiB)
0xD421  ...                    ; 压缩数据流起点

各版本 header size:0.3.2 = 73958,0.4.4 = 80814,0.5.4 = 83124,0.6.5 = 83114,0.6.6 = 83118,0.6.8 = 85116。

2.2 解出头部(脚本 + 字符串表) ​

数据流是裸 LZMA1,无 EOS 标记,因此必须显式给出解压长度。用一个 LZMA-alone 外壳即可交给 7-Zip 解压:

js
// 解出 NSIS header:props + 8 字节长度 + 数据流
const props = buf.subarray(0xD41C, 0xD421);       // 5d 00 00 80 00
const size  = Buffer.alloc(8);
size.writeBigUInt64LE(BigInt(83114 + 20898174));  // header + 全部载荷
fs.writeFileSync('h.lzma', Buffer.concat([props, size, buf.subarray(0xD421)]));
// 7z x h.lzma -o out     -> out/h 的前 83114 字节即 NSIS header

注意:不能用 -1(未知长度)——该流没有结束标记,7-Zip 会直接拒绝;长度给多了会在末尾报一次 Data Error,但前面的数据仍然可用。

2.3 字符串表关键发现 ​

从 header 中提取 UTF-16LE 字符串(0.6.5 共 396 条),与版本相关的差异只有:

项目0.5.40.6.5 / 0.6.60.6.8
Tauri identifier / AUMIDcom.akarinliu.smtc2webcom.smtc2web.smtc2web同左
MUI/语言注册表键Software\akarinliu\smtc2webSoftware\smtc2web\smtc2web同左
PATH 目标 hiveHKLM Session Manager\EnvironmentHKLM(同左)HKCU\Environment(+HKLM 宏)
广播常量字符串0xFFFF 0x001A0xFFFF 0x001A0xFFFF 0x001A

字符串表中与“卡死点”直接相关的一组(0.6.5,行号即文件内顺序):

177: EstimatedSize
178: 0xFFFF        ← HWND_BROADCAST
179: 0x001A        ← WM_SETTINGCHANGE
180: /ARGS

以及 PATH hook 的痕迹:

30: advapi32::RegOpenKey(i 0x80000002, t'SYSTEM\...\Session Manager\Environment', *i.r2) i.r3
37: smtc2web: PATH is too long to update safely; leaving PATH unchanged
365: Registering smtc2web in PATH...

快捷方式相关(Tauri 模板 SetLnkAppUserModelId):

181: OLE32::CoCreateInstance(g"{00021401-0000-0000-c000-000000000046}", ...)
192: ->20(t)i(w "…\smtc2web.exe")            ; IShellLink::SetPath
194: ->6(w,i)i("…\smtc2web.lnk", 1)          ; IPersistFile::Save
200: ->0(g,*p)i("{886D8EEB-…}", .r2)         ; IPropertyStore
201: Oleaut32::SysAllocString(w "com.smtc2web.smtc2web")
202: *(&g16,&i4)("{9F4C2855-9F79-4B39-A8D0-E1D42DE1D5F3}", 5)   ; PKEY_AppUserModel_ID

2.4 模板与插件 ​

字符串与 Tauri v2 官方 NSIS 模板完全对应(“Already Installed”维护页、WebView2 引导下载、“is running! Click OK to kill it”、“Registering … in PATH…” 等),并用 startmenu/nsDialogs/System/NSISdl/LangDLL 插件。也就是说安装器主体是 Tauri 生成的,PATH 注册与广播来自项目自己的 installer_hooks.nsh。


3. 动态分析 ​

3.1 复现步骤 ​

powershell
# 静默安装,观察 4 分钟
Start-Process 'C:\Users\AkarinLiu\Downloads\smtc2web_0.6.5_x64-setup.exe' -ArgumentList '/S'

3.2 运行时观察(0.6.5) ​

[20:32:16] 启动,创建 $PLUGINSDIR = %TEMP%\nsy23BC.tmp
[20:32:17] $INSTDIR\uninstall.exe  已写     (+1s)
[20:32:17] 开始菜单 smtc2web.lnk   已写     (+1s,含 AUMID)
[20:32:20..20:36:17] CPU 冻结在 0.89 s,7 个线程全部 Wait,进程不退出

即:卡死在“写快捷方式/写卸载器”之后,安装器什么都没再做。

3.3 WER 事件证据 ​

Application 日志中的 AppHangB1(“停止与 Windows 交互”):

时间进程
2026-10-14 20:11:37smtc2web_0.6.5_x64-setup.exe
2026-10-14 20:16:00smtc2web_0.5.4_x64-setup.exe
2026-10-14 20:16:22uninstall.exe (0.5.4)
2026-10-14 20:22:56smtc2web_0.4.4_x64-setup.exe
2026-10-14 20:25:36uninstall.exe (0.4.4)
2026-10-15 20:23:43smtc2web_0.6.5_x64-setup.exe

卸载器同样挂起——这是根因在“(反)注册 PATH → 广播”而不是在快捷方式创建的关键旁证。

3.4 主线程栈与寄存器(决定性证据) ​

静默运行 20 秒后,Wow64GetThreadContext 抓取主线程上下文并读取其 32 位栈:

tid=2940
eip = 0x757c11ec   win32u.dll!NtUserMessageCall+0xc        ← 内核消息调用,同步等待
[esp+0]  = 0x768f859b   USER32.dll!SendMessageW+0x9b        ← 返回地址:Sender 是 SendMessage*
[esp+4..]= 0xffff  0x1a  0x0  0x40c5f8  …  0xffff  0x1a  0x0
                 ^^^^^^ HWND_BROADCAST   ^^^^^^ WM_SETTINGCHANGE

堆栈上出现了两次 0xFFFF / 0x001A 参数对,与字符串表中的常量一一对应:

c
SendMessage((HWND)0xFFFF /*HWND_BROADCAST*/, 0x001A /*WM_SETTINGCHANGE*/, 0, …);

同时刻已加载的 32 位模块印证它当时正在处理 shell/快捷方式属性:

SHELL32.dll  PROPSYS.dll  LINKINFO.dll  SHFOLDER.dll  windows.storage.dll
ole32.dll  combase.dll  advapi32.dll  SETUPAPI.dll  SHLWAPI.dll  urlmon.dll

该调用不是 SendMessageTimeout:带超时的调用即使目标不响应也会在 1 s 内返回,而实测进程 4 分钟毫无进展。

3.5 系统窗口响应探针 ​

向会话内所有顶层窗口逐个发送 WM_SETTINGCHANGE,SendMessageTimeout(..., SMTO_ABORTIFHUNG, 200ms):

NO-RESPONSE  pid=17480  TaskManagerWindow (任务管理器)
NO-RESPONSE  pid=28544  wgpu Device Class …        (ArtCraft Launcher)
NO-RESPONSE  pid=30576  Qt5158QWindowIcon …        (UU 加速器)
NO-RESPONSE  pid=16224  ShellHandwritingCanvas     (TabTip)
NO-RESPONSE  pid=8104   GDI+ Window (GameViewerServer.exe)
NO-RESPONSE  pid=25340  #32770 / tooltips_class32  (Mem Reduct)
NO-RESPONSE  pid=26680  HRMAINTRAY                 (火绒 HipsTray)
NO-RESPONSE  pid=27644  GDI+ Window (AMDRSServ.exe)
… 共数十个窗口在 200 ms 内无法响应

HWND_BROADCAST 会遍历所有顶层窗口并逐个同步等待,因此只要其中任意一个永远不返回,SendMessage 就无限阻塞。

3.6 环境时间线 ​

时间事件
2026-09-19 09:380.6.5 安装成功(EBWebView 数据目录生成)
2026-10-01 08:50火绒(Huorong)安装(hrdevmon 进入卷 UpperFilters,HipsDaemon 常驻)
2026-10-050.6.6 构建/下载
2026-10-13 18:08v0.6.8 提交(含修复)
2026-10-13 ~ 150.6.5 / 0.5.4 / 0.4.4 反复尝试,全部卡死(%TEMP%\ns*.tmp 残留、WER AppHang)

火绒是相关性(其 HIPS 注入使得“有窗口不泵消息”的概率大幅提高,且其日志恰好在每次失败时刻被写入),真正机制是 §4.1 的无超时广播。


4. 根因 ​

4.1 机制 ​

安装器主线程
   └─ CreateShortcut / WriteUninstaller   ← 已完成(文件、.lnk、卸载器都已落盘)
   └─ NSIS_HOOK_POSTINSTALL
        └─ SMTC_AddToPath*(写 PATH)
        └─ SendMessage(HWND_BROADCAST, WM_SETTINGCHANGE, 0, "Environment")   ← 在这里永久阻塞
             └─ user32!SendMessageW → win32u!NtUserMessageCall
                  └─ 同步等待会话内每一个顶层窗口
                       └─ 某个窗口的 WndProc 永不返回  ⇒  死等

主线程被内核态消息调用阻塞时不会泵消息,于是:

  • 安装器窗口表现为“未响应”,Windows 生成 AppHangB1;
  • 详情栏停留在最后一行文字 —— 用户看到的就是“创建快捷方式”(hook 是 POSTINSTALL,所以快捷方式其实早已创建成功);
  • 被强杀后 $PLUGINSDIR(%TEMP%\ns*.tmp)不会被清理,留下残留目录。

4.2 为什么“以前能装、现在装不上” ​

缺陷从 0.4.4 起一直在,但只有系统里存在不泵消息的窗口时才复现。2026-09-19 那次安装时没有这样的窗口,所以成功;此后(火绒安装、UWP/覆盖层应用增多)系统里出现了这类窗口,于是所有带旧 hook 的安装器——哪怕是早已发布、当年能装的 0.4.4/0.5.4——全部卡死。这也是“与版本无关、与环境有关”的直接证明。

4.3 为什么卸载器也挂 ​

NSIS_HOOK_POSTUNINSTALL 里有同一条广播(旧版本同样无超时),卸载流程走的是同一个断点。

4.4 为什么停在“创建快捷方式” ​

NSIS 的详情文本由指令输出;hook 位于 POSTINSTALL(在文件、注册表、快捷方式之后),而在阻塞发生前没有新的 DetailPrint,因此界面停在“创建快捷方式”这一行,造成“卡在创建快捷方式”的错觉。


5. 源码对照(git) ​

仓库:C:\Users\AkarinLiu\git\smtc2web(HEAD = tag v0.6.8,工作区干净)

69bb1e1  2026-10-13  修复 NSIS 安装器卡死与 PATH 注册表定位错误   ← v0.6.8
59024ce              修复 NSIS 安装器覆盖用户 PATH 的严重 Bug
1982fc9              改进自动更新机制
6f7c603  2026-06-23  新增开发服务器功能,支持 Vite 生态。        ← 首次引入 PATH hook

引入(6f7c603,即 0.4.4 起):

nsis
!macro NSIS_HOOK_POSTINSTALL
  ...
-  SendMessage ${HWND_BROADCAST} ${WM_SETTINGCHANGE} 0 "STR:Environment"
!macroend

修复(69bb1e1 / v0.6.8):

nsis
+  ; Broadcast with a timeout; a blocking SendMessage hangs setup if any
+  ; top-level window fails to pump the message.
+  SendMessage ${HWND_BROADCAST} ${WM_SETTINGCHANGE} 0 "STR:Environment" /TIMEOUT=1000

同一提交还修了第二个 bug:tauri-bundler 在 !include 该文件时 INSTALLMODE 尚未定义,导致文件作用域的 !if "${INSTALLMODE}" == "currentUser" 恒走 !else 分支——per-user 安装却把 PATH 写到 HKLM。修复后 hive 选择移入宏内部,currentUser 写 HKCU\Environment。


6. 修复验证 ​

测试命令结果
0.6.5smtc2web_0.6.5_x64-setup.exe /S卡死,4 分钟无进展,强杀后残留 %TEMP%\ns*.tmp
0.6.8smtc2web_0.6.8_x64-setup.exe /S9 秒完成,退出码 0

安装后本机状态:

C:\Users\AkarinLiu\AppData\Local\smtc2web\smtc2web.exe   17 415 680 B   2026-10-13 18:17:32
C:\Users\AkarinLiu\AppData\Local\smtc2web\uninstall.exe      81 942 B   2026-10-15 20:46:34
ARP  DisplayVersion = 0.6.8   InstallLocation = "C:\Users\AkarinLiu\AppData\Local\smtc2web"
HKCU\Environment\Path = …;C:\Users\AkarinLiu\AppData\Local\smtc2web      ← 新逻辑生效
开始菜单快捷方式 → C:\Users\AkarinLiu\AppData\Local\smtc2web\smtc2web.exe

7. 处置与建议 ​

对用户(本机)

  1. 直接使用 0.6.8 或更高版本;已装好,无需再动。
  2. 若以后仍遇到同类卡死:任务管理器结束 *setup.exe / uninstall.exe,删除 %TEMP%\ns*.tmp,重启后再装。
  3. 可临时退出安全软件(火绒)以降低“有窗口不泵消息”的概率,但根因已在 0.6.8 修复。

对项目

  1. hook 中的广播必须保留 /TIMEOUT=(安装和卸载两处),并考虑同时使用 SMTO_ABORTIFHUNG 语义。
  2. 发布 ≥ 0.6.8。注意自动更新链路:更新时执行的是新下载的安装器,所以 0.6.5/0.6.6 用户更新到 0.6.8 是安全的;但更新到 0.6.6 / 0.6.7 仍会卡死,需要引导这些用户手动装一次 0.6.8。
  3. 建议在安装器文档中说明卡死残留物(%TEMP%\ns*.tmp、僵尸 setup.exe)的清理方式。

附录 A:证据文件与工具 ​

用途工具/脚本
解包 NSIS7z.exe x -y -o<dir> <setup.exe>
解出 NSIS headerhdr/*.lzma 外壳 + 7z x -tlzma(脚本见 §2.2)
字符串表提取Node 脚本(UTF-16LE 线性扫描)
进程/线程/模块/栈PowerShell + Add-Type 调用 EnumProcessModulesEx / Wow64GetThreadContext / StackWalk-free 栈扫描
窗口响应探针EnumWindows + SendMessageTimeoutW(SMTO_ABORTIFHUNG)
事件取证Get-WinEvent(Application/System)、C:\ProgramData\Microsoft\Windows\WER\ReportArchive\Critical_smtc2web*

所有中间产物位于 %TEMP%\opencode\(hdr\header_*.bin、stack.json、regs.json、hungwin.log、bcast.log 等)。

附录 B:完整 SHA-256 ​

0.3.2  AE2DB5DD16408657348DEF2DB1EA3FD3C39B8C3F49EFAEA8C72B8E98D1E7A596
0.4.4  9FE6AF6AF8B225D14BB3EB9C601A2C7E93DFE11E285BA93B0EE40D5AD83B6A91
0.5.4  65B47BD3EF8D2B08D42B455ACCBE9E4E73DD3B67F35A6B2132D94892D1FDDA53
0.6.5  BAEB3435D7A250839CD5501E603F98500125828D205AAED3D3F4BAE9FD918780
0.6.6  24EF1C34AF034D59411131667FEDF78C35CAE7D46628F375DC8A27B35AC09F39
0.6.8  C4AAC2F4108E5982E384C24C7F7F27E189054565E709B8239039ABA9B5C7C6B3

附录 C:调用链速查 ​

setup.exe (NSIS 3.11, LZMA)
 └─ $PLUGINSDIR\{System,StartMenu,nsDialogs,nsis_tauri_utils,NSISdl,LangDLL}.dll
 └─ 解压 smtc2web.exe → $LOCALAPPDATA\smtc2web
 └─ CreateShortcut + SetLnkAppUserModelId (IShellLinkW / IPersistFile / IPropertyStore, PKEY_AppUserModel_ID)
 └─ WriteUninstaller
 └─ NSIS_HOOK_POSTINSTALL → 写 PATH → **SendMessage(HWND_BROADCAST, WM_SETTINGCHANGE, 0, "Environment")**
        └─ user32!SendMessageW → win32u!NtUserMessageCall            ← 0.6.5 永久阻塞点
        └─ (0.6.8) SendMessageTimeout(…, 1000 ms)                    ← 不再阻塞

基于 MIT 许可 发布