WSABuilds 安装故障排查:解决"Internet security settings 阻止文件运行"的安装路径过长问题
【免费下载链接】WSABuildsRun Windows Subsystem For Android on your Windows 10 and Windows 11 PC using prebuilt binaries with Google Play Store (MindTheGapps) and/or Magisk or KernelSU (root solutions) built in.项目地址: https://gitcode.com/GitHub_Trending/ws/WSABuilds
本篇针对 WSABuilds(MagiskOnWSA)预安装阶段的典型报错——运行Install.ps1或Run.bat安装 Windows Subsystem for Android(WSA)时弹出 "Your Internet security settings prevented one or more files from opening"——给出根因分析与修复方案。读完你将明白该报错与 Windows 路径长度限制的关联,掌握通过重命名压缩包与解压目录恢复安装的两步操作流程,并能从构建脚本中理解超长文件名是如何产生的,从而在安装前主动规避同类问题。
报错现象与适用场景
在 WSABuilds 仓库中,用户通过 MagiskOnWSA/DLL/docs/Fixes/InternetSecuritySettingsBlock.md 记录的这一类问题出现在安装流程的最前端:
- 你已经获得一份 WSA 预构建安装包(
.zip或.7z压缩包),并解压出包含Install.ps1/Run.bat的目录; - 双击运行
Install.ps1或Run.bat时,Windows 没有执行安装逻辑,而是直接弹出提示:"Your Internet security settings prevented one or more files from opening"(你的 Internet 安全设置阻止了一个或多个文件打开)。
这个提示极易被误判为"安全策略拦截了脚本",从而去排查执行策略、防火墙或组策略。而该文档明确给出的根因是:
该问题由文件夹名称过长导致。这是常见情况,因为 MagiskOnWSALocal 构建脚本倾向于为
.zip文件及压缩包内的目录生成很长的字符串。
换言之,这并非真正的"Internet 安全设置"问题,而是 Windows 对过长路径/文件名的处理异常在安全提示上的表现形式。它与同目录下的 FixPathTooLong.md 记录的"解压时 Path is too long"报错共享同一根因(长名称),但触发点在解压之后、安装脚本启动之时。
根因剖析:超长文件名从何而来
从源码结构看,超长名称并非下载后人为改出来的,而是构建管线按约定拼接生成的。构建脚本 MagiskOnWSA/DLL/scripts/build.sh 中的命名逻辑(L439-L441)为:
artifact_name=WSA_${WSA_VER}_${ARCH}_${WSA_REL}${name1}${name2} [ "$REMOVE_AMAZON" ] && artifact_name+=-NoAmazon各段含义:
WSA_VER:WSA 版本号,如24000.6111.4.40000,本身就是一串较长数字;ARCH:架构,x64/arm64;WSA_REL:发布渠道,Retail / Insider 等;name1:Root 方案标识,如-with-magisk-27400-v27.4(L427);name2:GApps 标识,如-GApps-28或-NoGApps(L431-L435);- 末尾还可能追加
-NoAmazon/-RemovedAmazon等修饰段。
把这些段拼在一起,就得到了文档中的典型文件名形态:
WSA_2XXX.XXXXX.X.X_XXXX_Release-Nightly-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X-RemovedAmazon该字符串既是输出的.zip文件名,也是压缩包内解压目录名。当它再叠加磁盘上的父目录路径(例如D:\Downloads\WSA\),总长度很容易逼近 Windows 传统MAX_PATH(260 字符)限制。Windows 在此类超长路径下可能无法正常枚举/启动其中的可执行入口,最终表现为上面那条误导性很强的"Internet security settings"拦截提示。
解决方案:两步重命名
原文档给出的修复流程非常直接,共两步,核心思想是同时缩短压缩包名和已解压目录名:
第 1 步:将.zip/.7z压缩包重命名为更短的名称(任意你喜欢的名字均可)
- 修改前:
WSA_2XXX.XXXXX.X.X_XXXX_Release-Nightly-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X-RemovedAmazon - 修改后:
WSAArchive2XXX
第 2 步:将已解压的文件夹也重命名为更短的名称
- 修改前:
WSA_2XXX.XXXXXXX_XXXX_Release-Nightly-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X-RemovedAmazon - 修改后:
WSAArchive2XXX
完成重命名后,重新进入新目录运行Run.bat(或直接执行Install.ps1),即可绕过该拦截提示继续正常安装。
为什么重命名目录不会破坏安装脚本
一个合理的疑虑是:安装包目录里带有filelist.txt清单等资源文件,目录改名会不会影响安装逻辑?从安装脚本的实现看不会:
- MagiskOnWSA/installer/Run.bat 通过
cd "%~dp0"切换到脚本自身所在目录,再以相对方式启动powershell.exe -ExecutionPolicy Bypass -File .\Install.ps1; - MagiskOnWSA/installer/Install.ps1 内部同样全部采用
$PSScriptRoot与相对路径(如.\filelist.txt、.\AppxManifest.xml),在完整性校验阶段会逐一比对filelist.txt中的条目是否存在(L83-L88),最终用Add-AppxPackage -Register .\AppxManifest.xml完成注册安装。
也就是说,脚本只依赖"目录内相对结构"而不依赖"目录的绝对路径名",因此重命名目录是安全的,且是官方文档推荐的修复方式。若改名后安装脚本报出 "Some files are missing in the folder",说明解压时文件本身缺失,此时应回到重命名后的短路径压缩包重新完整解压,而不是继续排查路径名。
推荐的预防做法
与其事后修复,不如在安装前就控制路径总长度:
- 下载后先重命名压缩包为短名(如
WSAArchive2XXX.zip)再解压,让解压出的目录名天然变短; - 把解压目录放在短路径下,例如
C:\WSA\,避免C:\Users\<长用户名>\Downloads\...这类深路径叠加; - 若同时出现解压阶段 "Path is too long" 报错,请参考同主题的 FixPathTooLong.md,二者按同一套重命名思路处理即可。
相关文档与排查入口
- 本问题原始指南(DLL 子树):MagiskOnWSA/DLL/docs/Fixes/InternetSecuritySettingsBlock.md
- 主文档树中的同名指南:Documentation/Fix Guides/Pre-Install Issues/InternetSecuritySettingsBlock.md
- 同根因的解压期报错:MagiskOnWSA/DLL/docs/Fixes/FixPathTooLong.md
- 其他预安装报错索引(如 0x80073CF0/0x80073CF9 等 Appx 错误)位于 MagiskOnWSA/DLL/docs/Fixes/ 目录,可对照 MagiskOnWSA/DLL/docs/README.md 查找
小结
| 项目 | 说明 |
|---|---|
| 触发条件 | 以超长文件名/目录名(构建脚本自动拼接的多段版本号与方案标识)存放并运行Install.ps1/Run.bat |
| 表面症状 | Windows 提示 "Your Internet security settings prevented one or more files from opening" |
| 真实根因 | 压缩包名与解压目录名过长,路径长度超出 Windows 常规处理范围 |
| 修复步骤 | ① 将.zip/.7z重命名为短名;② 将解压目录重命名为短名;③ 重新运行安装脚本 |
| 安全性依据 | 安装脚本基于$PSScriptRoot与相对路径工作,目录改名不影响filelist.txt校验与 Appx 注册流程 |
按上述流程处理,绝大多数"Internet security settings 拦截"安装失败均可在不修改任何仓库文件、不调整系统安全策略的前提下恢复安装。
【免费下载链接】WSABuildsRun Windows Subsystem For Android on your Windows 10 and Windows 11 PC using prebuilt binaries with Google Play Store (MindTheGapps) and/or Magisk or KernelSU (root solutions) built in.项目地址: https://gitcode.com/GitHub_Trending/ws/WSABuilds
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考