[Bug]: macOS privileged helper is signed as com.nvidia.nvpair, so its pinned code-signing requirement always fails ("Privileged helper setup incomplete")
维护者通常 2 天内回复
还没有人认领这个 Issue。
评估
- 难度
- 4/5
- 预计耗时
- 1-2 天
- 新手友好度
- 18/100
- Issue 类型
- 缺陷
- 描述清晰度
- 基本清楚
- 活跃度
- 活跃
- 技术栈
- electron, macos, swift, typescript
- 领域
- build-system, desktop
调研方向
Start with the pinned requirement in desktop/native/Shared/HelperProtocol.swift (daemonCodeSigningRequirement) and the packaging config in desktop/electron-builder.config.ts. The signing script, internal-build/signing/macos/sign.ts, is not in the public repo, so a contributor needs maintainer access to change it. Done means codesign -dv on com.nvidia.nvpair.helper reports Identifier=com.nvidia.nvpair.helper, and nvpair-helper-ctl status returns reachable: true.
由索引模型根据 Issue 内容生成。
描述
PAIR version or commit: 1.0.0 (CFBundleVersion 1.0.0.85), the official signed DMG
Affected component: Installer or update
Environment:
- macOS 26.6.2 (25G83), arm64 (Apple silicon), on two separate Macs
- Both Macs have NVIDIA PAIR 1.0.0 installed in
/Applications, Developer ID signed, Team ID6KR3T733EC. codesign --verify --deep --strictpasses on the.app.- The Application Firewall is off on both, so there is no functional impact today.
Steps to reproduce:
- Install and launch NVIDIA PAIR 1.0.0 on macOS, and approve the background item.
- Run
codesign -dv /Applications/<PAIR>.app/Contents/MacOS/com.nvidia.nvpair.helper. - Run
/Applications/<PAIR>.app/Contents/MacOS/nvpair-helper-ctl status. - Look at the
mac-helperlines in the PAIR log (logs/nvpair.jsonl).
Expected behavior:
- The helper daemon is signed with
Identifier=com.nvidia.nvpair.helper, asHelperConstants.daemonCodeSigningRequirementindesktop/native/Shared/HelperProtocol.swiftrequires. nvpair-helper-ctl statusreportsreachable: truewith adaemonVersion.configure-firewallsucceeds, andmacHelperSetupCompletegets set.
Actual behavior:
codesign -dv on the helper daemon shows the app's identifier instead of the helper's:
Identifier=com.nvidia.nvpair
Authority=Developer ID Application: NVIDIA Corporation (6KR3T733EC)
TeamIdentifier=6KR3T733EC
The control tool itself is signed correctly (Identifier=nvpair-helper-ctl). nvpair-helper-ctl status returns:
{"ctlVersion":"1.0.0","reachable":false,"registration":"enabled"}
The two Macs fail in different ways:
-
Mac A: the daemon (
system/com.nvidia.nvpair.helper) is running, but every XPC connection is refused withReceived message forbidden due to code signing requirement. PAIR logsPrivileged helper setup incomplete: enabled Couldn't communicate with a helper application. -
Mac B: launchd never starts the daemon.
launchctl print system/com.nvidia.nvpair.helpershows:program identifier = Contents/MacOS/com.nvidia.nvpair (mode: 2), which does not exist in the bundle;job state = spawn failed;last exit code = 78: EX_CONFIG.
nvpair-helper-ctl statuswaits 5 s for the daemon, andconfigure-firewallproduces no output. PAIR logsctl configure-firewall failed: Command failed: …/nvpair-helper-ctl configure-firewalland thenPrivileged helper setup incomplete: enabled no response from helper control tool.
Because macHelperSetupComplete is never set, this repeats at every launch. If the Application Firewall were on, the 7 networked binaries would get no allow rules.
The pinning works as designed and fails closed; only the identifier the daemon was signed with is wrong. It looks like the internal per-binary sign loop (internal-build/signing/macos/sign.ts, referenced in desktop/electron-builder.config.ts) signs com.nvidia.nvpair.helper with the app's identifier, for example without an explicit --identifier com.nvidia.nvpair.helper. We couldn't check this, because that script is not in the public repo.
Sanitized logs or screenshots:
{"level":"error","source":"mac-helper","sublevel":"ctl","message":"ctl configure-firewall failed: Command failed: /Applications/<PAIR>.app/Contents/MacOS/nvpair-helper-ctl configure-firewall\n"}
{"level":"error","source":"app","sublevel":"mac-helper","message":"Privileged helper setup incomplete: enabled no response from helper control tool"}
{"level":"error","source":"app","sublevel":"mac-helper","message":"Privileged helper setup incomplete: enabled Couldn’t communicate with a helper application."}
Confirmations:
- I searched existing issues for duplicates. (2026-10-16: none mention the helper or its signature.)
- This is not a security vulnerability. (The requirement check fails closed; the defect makes the helper unusable rather than bypassable.)
- I agree to follow the Code of Conduct.
- 主要语言
- Go
- 星标
- 1.6k
- 派生
- 277
- 平均合并
- 4 天 14 小时
- 30 天内合并 PR
- 31
环境准备
- 没有 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
NVIDIA/Personal-AI-Router 的其他 Issue
-
难度 5/5 一周以上 新手友好度 20/100
NVIDIA/Personal-AI-Router#165 ·
维护者通常 2 天内回复
-
bug
难度 4/5 3-5 天 新手友好度 46/100
NVIDIA/Personal-AI-Router#164 ·
维护者通常 2 天内回复
-
enhancement
难度 4/5 一周以上 新手友好度 12/100
NVIDIA/Personal-AI-Router#162 ·
维护者通常 2 天内回复
-
enhancement
难度 4/5 3-5 天 新手友好度 25/100
NVIDIA/Personal-AI-Router#154 · 1 条评论 ·
维护者通常 2 天内回复
-
[Feature]: [Ollama] Alert the user about model pull failures可能已有人在做 @ckelseynv 于 7 天前认领。 未关闭enhancement
难度 3/5 1-2 天 新手友好度 56/100
NVIDIA/Personal-AI-Router#152 · 1 条评论 · 已指派 1 人 ·
维护者通常 2 天内回复
查看 NVIDIA/Personal-AI-Router 的全部 Issue
相似的 Issue
-
难度 2/5 1-3 小时 新手友好度 81/100
apache/rocketmq-dashboard#6895 ·
维护者通常 3 天内回复
-
难度 1/5 1 小时以内 新手友好度 87/100
777genius/agent-notifications#490 ·
维护者通常 1 天内回复
-
bug
难度 2/5 1-3 小时 新手友好度 78/100
devantler-tech/ksail#7836 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 76/100
keyxmakerx/Chronicle#1469 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 73/100
维护者通常 1 天内回复