Repository navigation
Releases
Releases · Kianuni/WQGuard
v1.3.6
WQGuard v1.3.6 (Build 27)
Highlights / 更新摘要
1. Engine 2 Real-World IPA ZIP Compatibility Fix (Issue #2)
Resolved two real-world IPA scanning failures reported in Issue #2 while keeping strict archive integrity and anti-tampering checks enforced:
- Streaming
GPFlagbit-3 (0x0008) without trailing Data Descriptor: App Store / IPA repackagers frequently keep bit 3 set in Local File Headers even after populating Central Directory sizes and CRCs without emitting a trailing Data Descriptor (descLen == 0).NativeZIPArchiveReadernow supportsdescLen == 0alongside 12/16/20/24-byte descriptors while continuing to reject contradictory non-zero Local Header bit-3 fields (corruptHeader). - Deflated empty directories & NUL alignment padding: Added support for
method == 8empty directory entries (uncompSize == 0,compSize <= 16) and up to 64 KB of0x00alignment padding between entries. - Uncompacted
.appex/ orphan local header isolation (isOrphanLocalEntry): Superseded or unreferenced0x04034b50local headers in archive gaps are isolated from the primary bundle lookup,hasArchiveMobileProvision, and Pass 1/Pass 2 scans, yet any unreferenced Mach-O or.dylibpayloads remain audited in Pass 2b and flagUnreferenced ZIP Local Headerseal tampering on otherwise Apple-signed packages. - iOS
/varvs/private/varZip Slip false-positive elimination: Lexical path standardization (lexicalStandardizedPath, introduced inv1.3.4+and verified end-to-end inv1.3.6) prevents iOS sandbox/private/varsymlink differences from triggering false Zip Slip errors on valid entries (e.g.,Payload/Stremio.app/de.lproj/).
2. Strict Concurrency Cleanup in MachOParser
- Eliminated the remaining
#SendableClosureCaptureswarnings inSources/WQGuardCore/MachO/MachOParser.swiftby capturing immutable chunk slices (immutableChunks) and collecting parallel scan outputs through an@unchecked Sendableresult box (ChunkResultsBox).
Verification & Checksums / 验证与校验
- XCTest Suite (
-strict-concurrency=complete): 50 suites / 1,020 tests passed, 0 failures, 0 skipped, 0 warnings inSources/WQGuardCore - CLI Self-Audit:
wqguard-cli --ipa WQGuard_v1.3.6.ipa --format json→"riskTier" : "KNOWN_TOOL", exit code0 WQGuard_v1.3.6.ipa(2,788,591bytes /2.7M)- SHA-256:
1a85d5d4ac1cd9fafbd0c9d92bbd3c85793878465216efaefab00702b498806f
- SHA-256:
Release Assets / 发布附件
WQGuard_v1.3.6.ipa— Unsigned/ad-hoc sideloadable iOS IPA (Build 27)WQGuard-Brotli-Shield.sgmodule— Surge Shield Module (#!version=1.3.6)WQGuard-Brotli-Shield.module— Shadowrocket Shield Module (#!version=1.3.6)WQGuard-Brotli-Shield.conf— Quantumult X Shield Config (#!version=1.3.6)WQGuard-Brotli-Shield.plugin— Loon Shield Plugin (#!version=1.3.6)WQGuard-Brotli-Shield.stoverride— Stash Shield Override (#!version=1.3.6)
v1.3.5
WQGuard v1.3.5 (Build 26)
全面推进 CMS 签名链 / 双槽权限 / Mach-O / ZIP64 / 代理防 Brotli 护盾全链路安全加固,并针对 iOS 26 / iOS 27 真机系统注册表特性与内部服务容器组 完成零误报精细校准;全量 **50 个 XCTest 测试套件(1,019 项测试)**在 Swift 严格并发模式下 100% 通过,且完成 WQGuard_v1.3.5.ipa 真机实测验证。
中文更新说明
- 全栈密码学签名与双槽权限防伪加固(
CSBlobParser/ChannelClassifier/IPAPackageScanner):- 升级 CMS PKCS#7 证书链时间窗口、叶子扩展(EKU / BasicConstraints)与签名属性绑定校验,强化
CodeResources哈希密封与 Mach-O 全切片一致性核验,封堵双槽 XML/DER 权限遮蔽、离线伪造 TestFlight 与嵌套.appex/.xpc/ 版本化.framework越权跳板。
- 升级 CMS PKCS#7 证书链时间窗口、叶子扩展(EKU / BasicConstraints)与签名属性绑定校验,强化
- Mach-O / ZIP64 / 容器取证深度防绕过与 DoS 防护(
MachOParser/MachOScanner/ContainerScanner/LockdownInstProxyClient):- 完善跨页边界符号扫描、
LC_DYLD_CHAINED_FIXUPS/LC_DYLD_INFO_ONLY动态导入还原、多段LC_ENCRYPTION_INFO_64与自定义 RX 段svc #0x80精确识别;加固 ZIP64 伪造长度流式解压上限、容器非递归O_RDONLY | O_NOFOLLOW符号链接取证以及lockdownd环回套接字超时与并发安全。
- 完善跨页边界符号扫描、
- iOS 26 / 27 真机系统应用零误报精细校准(
InstalledAppRegistryScanner/WhitelistEngine):- 完整适配真机
installation_proxy返回未公开内部 AppleTeamIdentifier、/private/preboot/<BootHash>/...动态挂载路径、系统预装应用合法私有权限、内部服务容器组(如HomePod 设置的group.homedevicesetup.diagnostics)以及无com.apple.前缀裸可执行名application-identifier(如/Applications/SESUIServiceApp.app),同时收紧自定义白名单对受保护钱包 / 社交 / 系统容器组的防抢占限制。
- 完整适配真机
- 五大代理客户端防 Brotli 溢出护盾加固(
SurgeBrotliShieldHelper/brotli-guard.js):- 同步升级至
#!version=1.3.5,加固多编码链、异常分隔符及大小写混合Content-Encoding: br响应头零解压HTTP 403熔断,完整保留 16 项核心证书锁定排除规则。
- 同步升级至
- 全量验证:
swift test --disable-sandbox -Xswiftc -strict-concurrency=complete:50 个 XCTest 测试套件、1,019/1,019 项自动化测试全部通过(0 失败),完成 Releasewqguard-cli与WQGuard_v1.3.5.ipa(KNOWN_TOOL)严格自审及物理 iPhone 真机零误报验证。
English Release Notes
- Full-Stack Cryptographic Signature & Dual-Slot Entitlement Hardening (
CSBlobParser/ChannelClassifier/IPAPackageScanner):- Upgraded CMS PKCS#7 chain validity window, leaf extension (EKU / BasicConstraints), and signed-attribute binding checks; strengthened
CodeResourcessealing and multi-slice Mach-O consistency checks to block XML/DER slot shadowing, offline TestFlight spoofing, and nested.appex/.xpc/ versioned.frameworkescalation pivots.
- Upgraded CMS PKCS#7 chain validity window, leaf extension (EKU / BasicConstraints), and signed-attribute binding checks; strengthened
- Mach-O / ZIP64 / Container Forensics Anti-Evasion & DoS Protection (
MachOParser/MachOScanner/ContainerScanner/LockdownInstProxyClient):- Hardened cross-page symbol scanning,
LC_DYLD_CHAINED_FIXUPS/LC_DYLD_INFO_ONLYstripped-import recovery, multi-segmentLC_ENCRYPTION_INFO_64intersection, custom RX sectionsvc #0x80detection, streaming ZIP64 decompression ceilings, non-recursiveO_RDONLY | O_NOFOLLOWcontainer symlink tracing, and fail-closedlockdowndloopback timeouts and concurrency safety.
- Hardened cross-page symbol scanning,
- Real-Device iOS 26 / 27 System App Zero-False-Positive Calibration (
InstalledAppRegistryScanner/WhitelistEngine):- Accurately recognizes real iOS
installation_proxyrecords carrying unlisted internal AppleTeamIdentifiers,/private/preboot/<BootHash>/...dynamic mounts, factory stock entitlements, internal service App Groups (e.g.group.homedevicesetup.diagnosticsonHomePod Setup), and bare single-segmentapplication-identifiervalues (e.g./Applications/SESUIServiceApp.app), while enforcing strict custom-whitelist blocking against protected wallet, messenger, and Apple system App Groups.
- Accurately recognizes real iOS
- 5-Client Brotli Overflow Shield Hardening (
SurgeBrotliShieldHelper/brotli-guard.js):- Synchronized to
#!version=1.3.5across all five proxy formats with hardened multi-coding, delimiter, and mixed-caseContent-Encoding: brheader zero-decompressionHTTP 403protection and full preservation of all 16 SSL-pinning exclusions.
- Synchronized to
- Verification:
swift test --disable-sandbox -Xswiftc -strict-concurrency=complete: 50 XCTest suites, 1,019/1,019 tests passing (0failures), plus Releasewqguard-cli&WQGuard_v1.3.5.ipa(KNOWN_TOOL) self-audit and physical iPhone verification.
Release Assets / 发布附件
WQGuard_v1.3.5.ipa— Unsigned ad-hoc IPA (v1.3.5, Build 26) for iOS 16+ / 17+ / 18+ / 26+ / 27+ (SHA-256: 99afedb15cacb36d133cd86c487834d3ebdcb2be9e18dd76b542b811b010342b)WQGuard-Brotli-Shield.sgmodule— SurgeWQGuard-Brotli-Shield.module— ShadowrocketWQGuard-Brotli-Shield.conf— Quantumult XWQGuard-Brotli-Shield.plugin— LoonWQGuard-Brotli-Shield.stoverride— Stash
WQGuard v1.3.4 · 真机系统/TestFlight零误报、团队自域钥匙串与宿主自白名单加固
WQGuard v1.3.4 (Build 25)
全面消除 iOS 26 / iOS 27 真机预装系统应用、团队自域钥匙串通配符、TestFlight 测试版应用及 /private/var 临时路径解包误报,打通企业签 / 侧载重签后的 WQGuard 宿主自白名单闭环,并保留全套密码学签名链验真、Mach-O / ZIP64 全链路防绕过解析、2026 最新漏洞特征库、ARM64 svc #0x80 直接系统调用扫描与 13 项固件 CVE 暴露雷达。
中文更新说明
- iOS 26 / 27 官方预装与第一方应用零误报加固(
InstalledAppRegistryScanner):- 完整覆盖驻留于
/private/var/containers/Bundle/Application/<UUID>/且在 CoreTrust 静态缓存中省略SignerIdentity的 120+ 款 Apple 原厂预装可卸载应用与系统 UI 服务(如设置、Siri、信息、健康、App Store、快捷指令、文件、时钟、日历、备忘录、提醒事项、翻译、遥控器、聚焦、库乐队、Swift Playgrounds 等)及官方非com.apple.*应用(如 App Store 签名的Shazam)。 - 完善 Apple 官方内部共享容器命名空间识别(如
group.tvappservices.*、group.is.workflow.*、<TeamID>.groups.com.apple.*等)与原厂系统级no-sandbox预装应用边界校验;同时保持对 TrollStore 伪装系统注册、/var/jb/无根越狱路径、Ad Hoc/ 第三方Team ID/ 第三方App Group伪造包的 100% 高危检出。
- 完整覆盖驻留于
- 团队自域钥匙串通配符精准区分(
ExpandedThreatCatalog/IPAPackageScanner):- 将合法的开发者自身团队前缀钥匙串通配符(
<OwnTeamID>.*与历史迁移<LegacyAppIDPrefix>.*)与高危全局通配符"*"、"com.apple.*"、跨团队通配符及未签名/Ad-Hoc 通配符严格区分,彻底消除正版 App Store 应用与正常企业签应用(如微博、Erosion、Lokey)的钥匙串误报。
- 将合法的开发者自身团队前缀钥匙串通配符(
- TestFlight 官方渠道精准识别(
InstalledAppRegistryScanner/CSBlobParser/SecurityPipeline):- 支持识别 Apple 官方 TestFlight 云端重签名证书
"TestFlight Beta Distribution",避免将 TestFlight 测试版应用(如 Surge、APTV)误标为「企业签」;同时阻止未加密本地侧载克隆包与 FairPlay 加密 TestFlight 安装项混并,并对第三方组织名含TestFlight字样的伪造企业证书继续按「企业签」严查。
- 支持识别 Apple 官方 TestFlight 云端重签名证书
- 真机
/private/var解包路径词法规范化修复(IPAPackageScanner):- 引入不依赖文件系统存在性的纯词法路径规范化
lexicalStandardizedPath,彻底修复 iOS 真机/private/var/mobile/...临时沙盒在解包未签名.ipa(含_CodeSignature/目录项)时因/private前缀折叠不一致导致的MalformedPackage:ZipSlipOrSymlink误报,同时保留对真实../路径穿越与软链接逃逸的严格拦截。
- 引入不依赖文件系统存在性的纯词法路径规范化
- 重签宿主自身白名单闭环(
InstalledAppRegistryScanner/WhitelistEngine/SecurityPipeline):- 支持经企业描述文件或个人证书重签(含显式
application-identifier变更、App Group 重写及覆盖安装后缓存快照 UUID 变更)的 iOS 运行宿主WQGuard正确归入「已知工具」(KNOWN_TOOL),同时继续严格拦截任何.highRisk指标、Apple 系统容器组与主流钱包/通讯应用 App Group 抢占。
- 支持经企业描述文件或个人证书重签(含显式
- 全量验证:
- Swift 严格并发模式下 45 个 XCTest 套件、872 项自动化测试全部通过(0 失败、0 跳过),并完成 Release
wqguard-cli与WQGuard_v1.3.4.ipa成品严格自审(KNOWN_TOOL)及实机验证。
- Swift 严格并发模式下 45 个 XCTest 套件、872 项自动化测试全部通过(0 失败、0 跳过),并完成 Release
English Release Notes
- Zero False Positives on iOS 26 / 27 Stock & First-Party Apps (
InstalledAppRegistryScanner):- Added comprehensive verification for 120+ preinstalled/staged Apple stock apps and UI services under
/private/var/containers/Bundle/Application/<UUID>/whereinstallation_proxyomitsSignerIdentity(including Settings, Siri, Messages, Health, App Store, Shortcuts, Files, Clock, Calendar, Notes, Reminders, Translate, TV Remote, Spotlight, GarageBand, Swift Playgrounds, etc.) as well as Apple-owned App Store apps (Shazam), internal Apple App Group namespaces (group.tvappservices.*,group.is.workflow.*,<TeamID>.groups.com.apple.*), and factoryno-sandboxstock constraints — while preserving 100%.highRiskdetection on TrollStore system-registration spoofs, rootless jailbreak paths, and third-party Team ID / App Group spoofs.
- Added comprehensive verification for 120+ preinstalled/staged Apple stock apps and UI services under
- Own-Team Keychain Wildcard Differentiation (
ExpandedThreatCatalog/IPAPackageScanner):- Exempts legitimate developer own-team
<OwnTeamID>.*and<LegacyAppIDPrefix>.*keychain-access-groupswildcards on signed builds while continuing to flag global"*","com.apple.*", cross-team wildcards, and ad-hoc/unsigned wildcards as.highRisk.
- Exempts legitimate developer own-team
- Accurate TestFlight Channel Classification (
InstalledAppRegistryScanner/CSBlobParser/SecurityPipeline):- Recognizes Apple's official
"TestFlight Beta Distribution"cloud re-signing leaf certificate so TestFlight apps (e.g. Surge, APTV) are classified asTestFlight(Safe) rather thanEnterprise In-House, while keeping third-party org-name spoofs ("iPhone Distribution: TestFlight ...") under strict enterprise scrutiny.
- Recognizes Apple's official
- Lexical
/private/varTemporary Path Canonicalization (IPAPackageScanner):- Replaced filesystem-dependent
standardizedFileURLprefix checks with pure lexical canonicalization (lexicalStandardizedPath), eliminating false-positiveMalformedPackage:ZipSlipOrSymlinkerrors when unpacking.ipaarchives inside iOS/private/var/mobile/...temporary directories while catching all real../traversal and symlink escapes.
- Replaced filesystem-dependent
- Re-signed Host Self-Whitelist Continuity (
InstalledAppRegistryScanner/WhitelistEngine/SecurityPipeline):- Properly recognizes the running iOS
WQGuardhost installation asKNOWN_TOOLafter enterprise or personal sideload re-signing (including across cached registry snapshots after in-place app updates), while rejecting any.highRiskindicator, Apple system group, or wallet/messenger App Group squatting.
- Properly recognizes the running iOS
- Verification:
swift test --disable-sandbox -Xswiftc -strict-concurrency=complete: 45 XCTest suites, 872/872 tests passing (0 failures, 0 skipped), plus Releasewqguard-cliandWQGuard_v1.3.4.ipa(KNOWN_TOOL) self-audit and physical iPhone verification.
Release Assets / 发布附件
WQGuard_v1.3.4.ipa— Unsigned ad-hoc IPA (v1.3.4, Build 25) for iOS 16+ / 17+ / 18+ / 26+ / 27+ (SHA-256: c8c0f64e1c3e3cef97f387d9a3b14a695419e905135c90bec029eb495e46272d)WQGuard-Brotli-Shield.sgmodule— SurgeWQGuard-Brotli-Shield.module— ShadowrocketWQGuard-Brotli-Shield.conf— Quantumult XWQGuard-Brotli-Shield.plugin— LoonWQGuard-Brotli-Shield.stoverride— Stash