Corsair 预编译 frpc 分发包解析corsair-dev/frpc-win32-arm64与跨平台开发隧道的二进制分发机制【免费下载链接】corsairConnect your users to their apps项目地址: https://gitcode.com/GitHub_Trending/corsa/corsaircorsair-dev/frpc-win32-arm64是 Corsair 为 Windows ARM64 平台预编译的frpc二进制分发包它是 Corsair 开发隧道dev tunnel在目标机器上真正拉起内网穿透客户端的载体。本文将以该包为核心深入剖析 Corsair 如何借鉴 esbuild/Turbopack 的“按平台可选依赖”模型在发布时物化二进制、在安装时按 OS/CPU 自动选取、在运行时解析并拉起frpc的完整链路并给出对应源码路径与可操作的排障建议。一、包的定位开发隧道里的frpc载体Corsair 的 dev tunnel 功能基于 fatedier/frp 生态本地开发环境通过frpcfrp 客户端主动连接远端的frpsfrp 服务端从而把本地端口暴露为公网可达的 HTTPS URL。corsair-dev/frpc-win32-arm64这个包做的事情非常单一——携带一份 Windowswin32ARM64 架构的预编译frpc.exe供 Corsair 的隧道逻辑spawn使用。这一点在包的 README.md 中写得很明确The prebuiltfrpcbinary (fatedier/frp, win32/arm64) that thecorsairdev tunnel spawns.从源码看spawn确实发生在 packages/corsair/hub/tunnel/run-tunnel.tsconst child spawn(bin, [-c, cfgPath], { stdio: [ignore, pipe, pipe], });这里bin来自resolveFrpcBinary()-c指向临时目录里生成的frpc.toml配置文件临时目录为 0600 权限进程退出时会被清理避免ck_dev_密钥残留在磁盘或 argv 中。也就是说隧道能否在某个平台上跑起来第一步取决于该平台的frpc二进制能否被正确解析到——这正是本文要讲的包要解决的问题。二、esbuild/Turbopack 式按平台安装模型README 强调了一个关键设计不要直接安装这个包。corsair把每个平台的二进制都声明为optionalDependencies包管理器只会安装与当前操作系统/CPU 匹配的那一个即 esbuild/Turbopack 模式。在 packages/corsair/package.json 中可以看到六个平台包全部被列为可选依赖optionalDependencies: { corsair-dev/frpc-darwin-arm64: workspace:*, corsair-dev/frpc-darwin-x64: workspace:*, corsair-dev/frpc-linux-arm64: workspace:*, corsair-dev/frpc-linux-x64: workspace:*, corsair-dev/frpc-win32-arm64: workspace:*, corsair-dev/frpc-win32-x64: workspace:* }而每个平台包通过os与cpu两个字段声明自己适用的环境。以 packages/frpc-win32-arm64/package.json 为例os: [win32], cpu: [arm64], files: [frpc.exe, LICENSE.frp, NOTICE]os/cpu字段是 npm/pnpm/yarn 的原生机制当当前机器是 win32/arm64 时只有corsair-dev/frpc-win32-arm64会被真正安装其余五个平台包被静默跳过。这样不会把六个二进制全部塞进用户的node_modules体积与磁盘占用最小化不会因为“装错架构的二进制”而在运行时失败包内没有 install 脚本因此也不会被 pnpm 的 build 审批策略阻塞安装README 特别指出这是无 install 脚本的纯分发包。包管理器层面“同一时刻至多安装一个候选包”的特性在运行时解析代码里也被明确利用。见 packages/corsair/hub/tunnel/frpc-binary.ts 的注释与实现/** * The frpc binary carried by this platforms optional-dependency package * (corsair-dev/frpc-platform-arch), if it installed. Only the one package * matching the host os/cpu is installed ... so this resolves at most one candidate. */ function platformPackageBinary(): string | null { const pkg corsair-dev/frpc-${process.platform}-${process.arch}; try { const bin join( dirname(nodeRequire().resolve(${pkg}/package.json)), binName(), ); return existsSync(bin) ? bin : null; } catch { return null; // package not installed for this platform } }binName()对 win32 返回frpc.exe对其他平台返回frpc与包内files列表保持一致。三、发布时物化二进制prepare-frpc-packages.mjs源码解析二进制并不存在于 Git 仓库中——它们是 git-ignored 的只存在于发布后的 npm tarball 里。物化动作由 scripts/prepare-frpc-packages.mjs 在发布前执行。每个平台包的prepack钩子只处理自己的目标例如scripts: { prepack: node ../../scripts/prepare-frpc-packages.mjs win32-arm64 }3.1 单一事实来源版本与校验和脚本从 packages/corsair/scripts/frpc-release.json 读取锁定的 frp 版本与六个归档的 SHA256 校验和{ version: 0.71.0, checksums: { frp_0.71.0_darwin_amd64.tar.gz: 1b1b4e2f..., ... frp_0.71.0_windows_arm64.zip: b56a5c2a... } }这个 JSON 同时被 packages/corsair/scripts/postinstall-frpc.mjs 引用保证“发布物化”与“安装预取”两条路径校验的是同一套版本和哈希。3.2 平台 → 发布包映射脚本维护一张TARGETS表把 node 的platform-arch键映射到 frp 官方发布包的 os/arch、二进制文件名和归档格式{ key: win32-arm64, os: windows, arch: arm64, bin: frpc.exe, ext: zip, }可以看到 frp 官方归档中 Windows 用的是zip类 Unix 用tar.gzWindows 二进制名是frpc.exe其余是frpc。3.3 下载 → 校验 → 解压 → 落盘prepare()的核心流程是构造归档名frp_${FRPC_VERSION}_${os}_${arch}.${ext}例如frp_0.71.0_windows_arm64.zip从 frp 的 GitHub Releases 下载该归档fetchAbortSignal.timeout(120_000)限时用createHash(sha256)与SHA256[archive]比对不一致直接抛错拒绝if (createHash(sha256).update(buf).digest(hex) ! expected) { throw new Error(${t.key}: checksum mismatch for ${archive} — refusing); }在临时目录解压只提取frpc.exe与LICENSEzip 用 tar 提取失败时回退到unzip -o -j把二进制copyFileSync到包目录Windows 无需chmod仅非.exe目标执行chmodSync(dest, 0o755)把 frp 的 LICENSE 复制为包内LICENSE.frp并写出NOTICE文件保留署名写入.frpc-version标记文件记录已物化的版本。3.4 版本标记驱动的跳过逻辑.frpc-version标记的存在是为了防止“旧二进制配上新元数据”if ( existsSync(dest) existsSync(join(pkgDir, LICENSE.frp)) existsSync(marker) readFileSync(marker, utf8).trim() FRPC_VERSION ) { console.log( skip ${t.key} (already materialized)); return; }只有当目标二进制、许可证和版本标记三者齐备且版本号一致时才跳过一旦 frp 版本升级旧二进制必须重新下载并重新校验绝不复用。执行node scripts/prepare-frpc-packages.mjs不带参数会准备全部六个平台包带单个键如win32-arm64则只处理对应平台。四、安装时的双保险postinstall 预取缓存除了随包携带二进制corsair还提供了一条兜底路径安装后的postinstall脚本会把锁定的 frpc 预取到用户缓存目录使npm i corsair之后无需任何brew install或手工步骤即可使用隧道。packages/corsair/scripts/postinstall-frpc.mjs 的逻辑是 best-effort失败只打印提示、绝不中断安装关键点从frpc-release.json读取同一份版本与校验和下载归档到~/.cache/corsair/frpc/version/platform-arch/下的临时子目录校验 SHA256 后原子 rename到位避免tar被打断时留下半个损坏的二进制平台架构段platform-arch被刻意保留在缓存路径里防止共享 HOME如 devcontainer/NFS把错误架构的二进制提供给另一台机器——这与 frpc-binary.ts 中frpcCacheBinary()的路径计算保持锁步一致。五、运行时解析顺序与排障packages/corsair/hub/tunnel/frpc-binary.ts 中的resolveFrpcBinary()定义了三级解析顺序环境变量覆盖CORSAIR_FRP_BIN指向的 frpc 路径存在才用平台可选依赖包corsair-dev/frpc-${process.platform}-${process.arch}包内的二进制esbuild 模式无 install 脚本pnpm 不会拦截postinstall 下载缓存~/.cache/corsair/frpc/version/platform-arch/下的二进制。三级都失败时抛出带明确提示的错误其中特别点名了 pnpm 10 的行为pnpm 10 skips a dependencys postinstall until the consumer approves its build ... runpnpm approve-builds corsair(or add corsair to onlyBuiltDependencies) and reinstall, or set CORSAIR_FRP_BIN to an frpc path.这意味着在 Windows ARM64 机器上如果corsair-dev/frpc-win32-arm64未安装例如旧锁文件、或手动删除了 node_modules 中的平台包你可以通过设置CORSAIR_FRP_BIN指向任意一个 frp 官方发布的frpc.exe来显式接管从而绕过包分发链路。此外resolveFrpcBinary返回前还会经过ensureExecutable()frpc-binary.tsnpm tarball 或某些包存储可能丢失可执行位该函数会把权限位按0o111补齐Windows 上frpc.exe无需可执行位直接原样返回因此是 no-op。六、许可证与合规说明README 声明 frp 以 Apache-2.0 在此仓库中再分发见LICENSE.frp与NOTICE。具体落地方式在 prepare-frpc-packages.mjs 中从归档提取的LICENSE被复制为包内 LICENSE.frpfiles字段同时包含frpc.exe、LICENSE.frp、NOTICE若归档中没有 LICENSE 文件则写入指向 frp 官方 LICENSE 的说明NOTICE文本固定包含“This package bundles the frpc binary from fatedier/frp ... redistributed under the Apache License 2.0”以及当前FRPC_VERSION随每个包的prepack重新写出保证署名与版本信息始终最新。包本身的license字段同样为Apache-2.0publishConfig.access为public确保以公共包形式发布。七、小结corsair-dev/frpc-win32-arm64虽然只是一个“装着二进制的小包”但它承载了 Corsair 开发隧道跨平台分发中三个关键设计安装期按平台裁剪os/cpuoptionalDependencies让每个用户只拿到自己平台的 frpc这是 esbuild/Turbopack 早已验证的模式发布期可信物化prepare-frpc-packages.mjs 用锁定版本 SHA256 强校验 版本标记把“下载 → 校验 → 解压 → 落盘”做成可重复、可追溯的发布流程二进制永远不进 Git 仓库运行期多级兜底frpc-binary.ts 按CORSAIR_FRP_BIN→ 平台包 → 缓存目录三级解析配合 postinstall 预取与 pnpm 审批提示让npm i corsair后隧道开箱即用。如果你正打算为自己的 CLI 工具做跨平台原生二进制分发这套“可选依赖 prepack 物化 SHA256 校验 运行时多级解析”的组合是可直接复用的参考范本。【免费下载链接】corsairConnect your users to their apps项目地址: https://gitcode.com/GitHub_Trending/corsa/corsair创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Corsair 预编译 frpc 分发包解析：`@corsair-dev/frpc-win32-arm64` 与跨平台开发隧道的二进制分发机制
Corsair 预编译 frpc 分发包解析corsair-dev/frpc-win32-arm64与跨平台开发隧道的二进制分发机制【免费下载链接】corsairConnect your users to their apps项目地址: https://gitcode.com/GitHub_Trending/corsa/corsaircorsair-dev/frpc-win32-arm64是 Corsair 为 Windows ARM64 平台预编译的frpc二进制分发包它是 Corsair 开发隧道dev tunnel在目标机器上真正拉起内网穿透客户端的载体。本文将以该包为核心深入剖析 Corsair 如何借鉴 esbuild/Turbopack 的“按平台可选依赖”模型在发布时物化二进制、在安装时按 OS/CPU 自动选取、在运行时解析并拉起frpc的完整链路并给出对应源码路径与可操作的排障建议。一、包的定位开发隧道里的frpc载体Corsair 的 dev tunnel 功能基于 fatedier/frp 生态本地开发环境通过frpcfrp 客户端主动连接远端的frpsfrp 服务端从而把本地端口暴露为公网可达的 HTTPS URL。corsair-dev/frpc-win32-arm64这个包做的事情非常单一——携带一份 Windowswin32ARM64 架构的预编译frpc.exe供 Corsair 的隧道逻辑spawn使用。这一点在包的 README.md 中写得很明确The prebuiltfrpcbinary (fatedier/frp, win32/arm64) that thecorsairdev tunnel spawns.从源码看spawn确实发生在 packages/corsair/hub/tunnel/run-tunnel.tsconst child spawn(bin, [-c, cfgPath], { stdio: [ignore, pipe, pipe], });这里bin来自resolveFrpcBinary()-c指向临时目录里生成的frpc.toml配置文件临时目录为 0600 权限进程退出时会被清理避免ck_dev_密钥残留在磁盘或 argv 中。也就是说隧道能否在某个平台上跑起来第一步取决于该平台的frpc二进制能否被正确解析到——这正是本文要讲的包要解决的问题。二、esbuild/Turbopack 式按平台安装模型README 强调了一个关键设计不要直接安装这个包。corsair把每个平台的二进制都声明为optionalDependencies包管理器只会安装与当前操作系统/CPU 匹配的那一个即 esbuild/Turbopack 模式。在 packages/corsair/package.json 中可以看到六个平台包全部被列为可选依赖optionalDependencies: { corsair-dev/frpc-darwin-arm64: workspace:*, corsair-dev/frpc-darwin-x64: workspace:*, corsair-dev/frpc-linux-arm64: workspace:*, corsair-dev/frpc-linux-x64: workspace:*, corsair-dev/frpc-win32-arm64: workspace:*, corsair-dev/frpc-win32-x64: workspace:* }而每个平台包通过os与cpu两个字段声明自己适用的环境。以 packages/frpc-win32-arm64/package.json 为例os: [win32], cpu: [arm64], files: [frpc.exe, LICENSE.frp, NOTICE]os/cpu字段是 npm/pnpm/yarn 的原生机制当当前机器是 win32/arm64 时只有corsair-dev/frpc-win32-arm64会被真正安装其余五个平台包被静默跳过。这样不会把六个二进制全部塞进用户的node_modules体积与磁盘占用最小化不会因为“装错架构的二进制”而在运行时失败包内没有 install 脚本因此也不会被 pnpm 的 build 审批策略阻塞安装README 特别指出这是无 install 脚本的纯分发包。包管理器层面“同一时刻至多安装一个候选包”的特性在运行时解析代码里也被明确利用。见 packages/corsair/hub/tunnel/frpc-binary.ts 的注释与实现/** * The frpc binary carried by this platforms optional-dependency package * (corsair-dev/frpc-platform-arch), if it installed. Only the one package * matching the host os/cpu is installed ... so this resolves at most one candidate. */ function platformPackageBinary(): string | null { const pkg corsair-dev/frpc-${process.platform}-${process.arch}; try { const bin join( dirname(nodeRequire().resolve(${pkg}/package.json)), binName(), ); return existsSync(bin) ? bin : null; } catch { return null; // package not installed for this platform } }binName()对 win32 返回frpc.exe对其他平台返回frpc与包内files列表保持一致。三、发布时物化二进制prepare-frpc-packages.mjs源码解析二进制并不存在于 Git 仓库中——它们是 git-ignored 的只存在于发布后的 npm tarball 里。物化动作由 scripts/prepare-frpc-packages.mjs 在发布前执行。每个平台包的prepack钩子只处理自己的目标例如scripts: { prepack: node ../../scripts/prepare-frpc-packages.mjs win32-arm64 }3.1 单一事实来源版本与校验和脚本从 packages/corsair/scripts/frpc-release.json 读取锁定的 frp 版本与六个归档的 SHA256 校验和{ version: 0.71.0, checksums: { frp_0.71.0_darwin_amd64.tar.gz: 1b1b4e2f..., ... frp_0.71.0_windows_arm64.zip: b56a5c2a... } }这个 JSON 同时被 packages/corsair/scripts/postinstall-frpc.mjs 引用保证“发布物化”与“安装预取”两条路径校验的是同一套版本和哈希。3.2 平台 → 发布包映射脚本维护一张TARGETS表把 node 的platform-arch键映射到 frp 官方发布包的 os/arch、二进制文件名和归档格式{ key: win32-arm64, os: windows, arch: arm64, bin: frpc.exe, ext: zip, }可以看到 frp 官方归档中 Windows 用的是zip类 Unix 用tar.gzWindows 二进制名是frpc.exe其余是frpc。3.3 下载 → 校验 → 解压 → 落盘prepare()的核心流程是构造归档名frp_${FRPC_VERSION}_${os}_${arch}.${ext}例如frp_0.71.0_windows_arm64.zip从 frp 的 GitHub Releases 下载该归档fetchAbortSignal.timeout(120_000)限时用createHash(sha256)与SHA256[archive]比对不一致直接抛错拒绝if (createHash(sha256).update(buf).digest(hex) ! expected) { throw new Error(${t.key}: checksum mismatch for ${archive} — refusing); }在临时目录解压只提取frpc.exe与LICENSEzip 用 tar 提取失败时回退到unzip -o -j把二进制copyFileSync到包目录Windows 无需chmod仅非.exe目标执行chmodSync(dest, 0o755)把 frp 的 LICENSE 复制为包内LICENSE.frp并写出NOTICE文件保留署名写入.frpc-version标记文件记录已物化的版本。3.4 版本标记驱动的跳过逻辑.frpc-version标记的存在是为了防止“旧二进制配上新元数据”if ( existsSync(dest) existsSync(join(pkgDir, LICENSE.frp)) existsSync(marker) readFileSync(marker, utf8).trim() FRPC_VERSION ) { console.log( skip ${t.key} (already materialized)); return; }只有当目标二进制、许可证和版本标记三者齐备且版本号一致时才跳过一旦 frp 版本升级旧二进制必须重新下载并重新校验绝不复用。执行node scripts/prepare-frpc-packages.mjs不带参数会准备全部六个平台包带单个键如win32-arm64则只处理对应平台。四、安装时的双保险postinstall 预取缓存除了随包携带二进制corsair还提供了一条兜底路径安装后的postinstall脚本会把锁定的 frpc 预取到用户缓存目录使npm i corsair之后无需任何brew install或手工步骤即可使用隧道。packages/corsair/scripts/postinstall-frpc.mjs 的逻辑是 best-effort失败只打印提示、绝不中断安装关键点从frpc-release.json读取同一份版本与校验和下载归档到~/.cache/corsair/frpc/version/platform-arch/下的临时子目录校验 SHA256 后原子 rename到位避免tar被打断时留下半个损坏的二进制平台架构段platform-arch被刻意保留在缓存路径里防止共享 HOME如 devcontainer/NFS把错误架构的二进制提供给另一台机器——这与 frpc-binary.ts 中frpcCacheBinary()的路径计算保持锁步一致。五、运行时解析顺序与排障packages/corsair/hub/tunnel/frpc-binary.ts 中的resolveFrpcBinary()定义了三级解析顺序环境变量覆盖CORSAIR_FRP_BIN指向的 frpc 路径存在才用平台可选依赖包corsair-dev/frpc-${process.platform}-${process.arch}包内的二进制esbuild 模式无 install 脚本pnpm 不会拦截postinstall 下载缓存~/.cache/corsair/frpc/version/platform-arch/下的二进制。三级都失败时抛出带明确提示的错误其中特别点名了 pnpm 10 的行为pnpm 10 skips a dependencys postinstall until the consumer approves its build ... runpnpm approve-builds corsair(or add corsair to onlyBuiltDependencies) and reinstall, or set CORSAIR_FRP_BIN to an frpc path.这意味着在 Windows ARM64 机器上如果corsair-dev/frpc-win32-arm64未安装例如旧锁文件、或手动删除了 node_modules 中的平台包你可以通过设置CORSAIR_FRP_BIN指向任意一个 frp 官方发布的frpc.exe来显式接管从而绕过包分发链路。此外resolveFrpcBinary返回前还会经过ensureExecutable()frpc-binary.tsnpm tarball 或某些包存储可能丢失可执行位该函数会把权限位按0o111补齐Windows 上frpc.exe无需可执行位直接原样返回因此是 no-op。六、许可证与合规说明README 声明 frp 以 Apache-2.0 在此仓库中再分发见LICENSE.frp与NOTICE。具体落地方式在 prepare-frpc-packages.mjs 中从归档提取的LICENSE被复制为包内 LICENSE.frpfiles字段同时包含frpc.exe、LICENSE.frp、NOTICE若归档中没有 LICENSE 文件则写入指向 frp 官方 LICENSE 的说明NOTICE文本固定包含“This package bundles the frpc binary from fatedier/frp ... redistributed under the Apache License 2.0”以及当前FRPC_VERSION随每个包的prepack重新写出保证署名与版本信息始终最新。包本身的license字段同样为Apache-2.0publishConfig.access为public确保以公共包形式发布。七、小结corsair-dev/frpc-win32-arm64虽然只是一个“装着二进制的小包”但它承载了 Corsair 开发隧道跨平台分发中三个关键设计安装期按平台裁剪os/cpuoptionalDependencies让每个用户只拿到自己平台的 frpc这是 esbuild/Turbopack 早已验证的模式发布期可信物化prepare-frpc-packages.mjs 用锁定版本 SHA256 强校验 版本标记把“下载 → 校验 → 解压 → 落盘”做成可重复、可追溯的发布流程二进制永远不进 Git 仓库运行期多级兜底frpc-binary.ts 按CORSAIR_FRP_BIN→ 平台包 → 缓存目录三级解析配合 postinstall 预取与 pnpm 审批提示让npm i corsair后隧道开箱即用。如果你正打算为自己的 CLI 工具做跨平台原生二进制分发这套“可选依赖 prepack 物化 SHA256 校验 运行时多级解析”的组合是可直接复用的参考范本。【免费下载链接】corsairConnect your users to their apps项目地址: https://gitcode.com/GitHub_Trending/corsa/corsair创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考