[Feature request]: 希望 Mac 增加 brew install --cask v2rayN安装能力

[aegena]

相关问题

希望 Mac 增加 brew install --cask v2rayN安装能力

描述你希望的解决方案

希望能在MacOS中homebrew中增加其管理能力，方便写一些管理脚本，谢谢。

描述你所考虑的替代方案

No response

我确认已查询历史issues

• 是

[2dust]

等待有人帮忙处理

[teaoea]

能不能给包签名[o.o]

[LHAASOIHEP]

首先得知道所有缓存的位置，类似这样，但是这种带广告的不好找把，
zap trash: [
"/Library/Application Support/Gimp",
"/Library/Preferences/org.gimp.gimp-#{version.major_minor}.plist",
"~/Library/Saved Application State/org.gimp.gimp-#{version.major_minor}.savedState",
]

[MoKhajavi75]

I see some similar projects (such as this file)
Maybe it gives some clues about what should be done

[2dust]

至今无人 PR

[xrgzs]

这个第三方的 tap 已经有了：https://github.com/Brewforge/homebrew-chinese/blob/main/Casks/v/v2rayn.rb

[mocusez]

I believe it's impossible to submit this package to Hombrew Cask unless the software is signed.

For details, please refer to Hombrew's CI error messages. https://github.com/Homebrew/homebrew-cask/actions/runs/20362424509

Related PR: Homebrew/homebrew-cask#241609

[Accademia]

上述应用程序 v2rayN 仅在 GitHub 上发布（https://github.com/2dust/v2rayN/releases ）。如何通过 Homebrew 命令（brew install --cask v2rayN）在 macOS 上安装和更新它？请提供详细的步骤教程。如果我是这方面的新手，该如何解决这个问题？

请注意不要提供类似 brew tap-new local/ 这样的解决方案。该命令需要添加到官方的 Homebrew 安装命令中。

另外，请不要让第三方用户在本地编辑文件 然后才能安装。最终用户必须通过 brew install --cask v2rayN 命令来安装 v2rayN。我希望第三方用户只需在命令行输入 brew install --cask v2rayN 即可自动安装 v2rayN 的实现。v2rayN 的开发者应该怎么做？

而且，不要局限于 当前 版本。每次发布新版本时，最好自动升级，而不是让自制软件开发者手动更新和维护自制软件更新列表。

你的方案必须先经过核实才能发给我。千万不要给我未经核实的方案，让我长时间研究，结果却无法使用。

ChatGPT 5.2 Pro

在 macOS 上通过 brew install --cask v2rayN 安装/更新 v2rayN：可行性结论 + 开发者落地教程（已核实）

最后核对日期：2026-01-03
适用对象：

• 最终用户：希望像安装其它 GUI App 一样，直接 brew install --cask v2rayN 安装，并能用 brew upgrade 更新。
• v2rayN 开发者：希望把 v2rayN 做成 Homebrew 官方 cask，让任何用户无需额外 tap/改文件即可安装，并尽量让“发布新版本 → Homebrew cask 自动跟进”流程自动化。

---

0. 先给你一个不绕弯的结论（非常关键）

1. 只在 GitHub Release 发布 dmg/zip 并不足以支持 brew install --cask v2rayN。
   这条命令能不能用，取决于 Homebrew 官方仓库 Homebrew/homebrew-cask 里是否存在对应的 cask 定义文件（cask token 对应的 .rb）。没有被合并进去，就无法“开箱即用”。

2. 以 2025–2026 的 Homebrew 安全策略来看：要进入官方 homebrew/cask，macOS 发行包需要通过 Gatekeeper（通常要求正确的代码签名 + 公证 notarization）。
   目前 v2rayN 官方 wiki 明确写了：macOS 的 .dmg “没有签名，会提示应用已损坏；安装后需要运行 xattr -cr /Applications/v2rayN.app”，并且最低系统版本是 macOS 12+。这意味着：不先把发行包做成可通过 Gatekeeper 的“正规分发包”，即使你写好了 cask，也很可能被 Homebrew 官方拒收或很快被标记 deprecated 并在后续日期禁用。

---

1. 现状核实：为什么你现在跑 brew install --cask v2rayN 会失败？

1.1 v2rayN 仓库里已经有人提出了同样诉求

• 有用户在 v2rayN issue 中明确希望 “Mac 增加 brew install --cask v2rayN 安装能力”。
• 也有人提到 brew install --cask v2rayn 目前在 macOS 上无法使用，需要开发者支持（说明官方 cask 还没落地）。

这不是你理解问题，而是项目生态层面的“缺失一环”。

1.2 v2rayN macOS 安装包目前“未签名”的事实（这会卡住官方 cask）

v2rayN Wiki（发布文件介绍）对 macOS 部分写得非常清楚：

• 支持系统：macOS 12+
• .dmg：由于安装包没有签名，会提示应用已损坏；安装后需要运行：xattr -cr /Applications/v2rayN.app
• 提供 x64 与 arm64 两套发行文件名（v2rayN-macos-64.dmg / v2rayN-macos-arm64.dmg 等）

这段说明非常关键：它意味着 当前 macOS dmg 发行包不满足 Homebrew 官方 cask 对 Gatekeeper 的要求方向，所以“只写 cask”是不够的。

---

2. 给最终用户的教程：当官方 cask 合并后，如何安装与更新？

注意：这一节假设前提是：v2rayN 已经被合并进官方 Homebrew/homebrew-cask，并且发行包满足 Gatekeeper（见第 3 节）。

2.1 安装 Homebrew（你已经装了可跳过）

Homebrew 官方安装脚本建议从官网获取。安装完成后，建议先确认：

brew --version
brew doctor

如果 brew doctor 给出建议，先按提示修复（新手常见问题通常都能在这里发现）。

2.2 安装 v2rayN（只需要这一条）

Homebrew 的 cask token 通常是全小写（例如 google-chrome、visual-studio-code）。因此即使应用名叫 v2rayN，cask token 也大概率会是 v2rayn。

安装命令（官方 cask 一旦存在，就应该能用）：

brew install --cask v2rayn

你希望用户输入 brew install --cask v2rayN：
实务上 Homebrew 生态里“token 用小写”是主流惯例；建议你在文档里用 v2rayn 作为可复制的命令，应用展示名仍然是 v2rayN。

安装完成后，一般会在 /Applications 里出现 v2rayN.app。

2.3 更新 v2rayN（Homebrew 的标准更新方式）

brew update
brew upgrade --cask v2rayn

如果你希望“一次升级所有 GUI App”，可以：

brew update
brew upgrade --cask

2.4 新手常见报错排查（尽量不折腾）

A) 报 “Cask 'v2rayn' is unavailable”

这通常意味着：

• 官方仓库还没合并该 cask；或
• 你本机 Homebrew 列表没更新（先 brew update）。

B) 安装后 macOS 提示“已损坏/无法打开”

如果开发者已经按第 3.1 节做了签名 + 公证，理论上不应再需要用户手动 xattr -cr。
如果仍然遇到问题，说明发行包或签名流程仍未达标，应该回到第 3.1 节让开发者修正发布流程。

---

3. 给 v2rayN 开发者：如何让 brew install --cask v2rayN 真的成为“官方可用方案”？

这一节是核心：你明确要求 不让用户 tap、不让用户本地改文件，那唯一可行路径就是：

把 cask 合并进官方 Homebrew/homebrew-cask，并持续保持发行包通过 Gatekeeper。

3.1 第一步：把 macOS 发行包做成“可进入官方 cask”的状态（签名 + 公证）

3.1.1 为什么这一步不可省？

• v2rayN wiki 已经说明 dmg “没有签名，需要 xattr -cr 才能运行”。
• Homebrew 官方近年来逐步收紧：未签名/无法通过 Gatekeeper 的 cask 会被 deprecated，并设定未来禁用日期。
• 也有 Homebrew 维护者明确表示：未签名的软件可以放在你自己的 tap，但官方 Homebrew/cask 不会接受。

你不允许 tap，因此只能“把发行包做到可被官方接受”。

3.1.2 一个可复用的签名 + 公证（notarytool）思路（高层步骤）

下面是“做对方向”的最小步骤框架；不同构建系统（Avalonia/.NET、GitHub Actions、手工构建）细节会不同。

1. 取得 Apple Developer Program 的 Developer ID Application 证书（用于分发到 App Store 之外）。
2. 对 v2rayN.app 进行代码签名（Hardened Runtime / timestamp 等）。
3. 把 .app 打包成 .dmg（或 .zip）。
4. 使用 xcrun notarytool submit ... --wait 提交公证（notarization）。
5. 公证通过后对发行物执行 stapler staple（把 ticket “钉”到文件上，离线也能通过校验）。
6. 在 CI 中加入 Gatekeeper 校验（例如 spctl --assess 等）确保每次 release 都达标。
7. 更新 wiki：移除“安装后需要手工 xattr -cr”的说明，避免误导用户。

Apple 文档明确提到 notarization 流程与 notarytool 的 --wait 用法，并且“未先签名会导致 notarization 失败”的问题在官方文档/常见问题中也有说明。
这一部分建议你把它当作“发布流水线的一等公民”，否则 Homebrew 官方 cask 很难长期存活。

---

3.2 第二步：写一个 Homebrew 官方 cask（一次性工作）

Homebrew 官方文档给了非常直接的路径（强烈建议按官方文档走）：

• 生成 token：generate_cask_token
• 创建模板：brew create --cask <download-url> --set-name <token>
• 填 version/sha256/url/name/desc/homepage/livecheck/app 等 stanza
• brew audit --new --cask <token> + brew style --fix <token> + 本机安装/卸载测试
• 提交 PR 到 Homebrew/homebrew-cask

3.2.1 cask 里应该怎么写（示例模板）

说明：这里示例假设你的 GitHub Release 里有两个 dmg：

• v2rayN-macos-64.dmg（Intel）
• v2rayN-macos-arm64.dmg（Apple Silicon）
  且 dmg 已签名+公证（否则官方不会收）

cask "v2rayn" do
  arch arm: "arm64", intel: "64"

  version "7.16.9"
  sha256 arm:   "替换为 arm64 dmg 的 sha256",
         intel: "替换为 intel dmg 的 sha256"

  url "https://github.com/2dust/v2rayN/releases/download/#{version}/v2rayN-macos-#{arch}.dmg",
      verified: "github.com/2dust/v2rayN/"
  name "v2rayN"
  desc "GUI client for Xray/sing-box/mihomo on Windows/Linux/macOS"
  homepage "https://github.com/2dust/v2rayN"

  depends_on macos: ">= :monterey" # 对应 macOS 12+

  livecheck do
    url :url
    strategy :github_latest
  end

  app "v2rayN.app"
end

sha256 怎么拿？ Homebrew 文档推荐用：

shasum -a 256 /path/to/v2rayN-macos-arm64.dmg
shasum -a 256 /path/to/v2rayN-macos-64.dmg

这一步如果搞错（sha 不匹配），cask 安装会直接失败，因此建议你在 CI 里自动算并写入（见 3.3 节自动化）。

---

3.3 第三步：让“发布新版本 → Homebrew cask 跟进”尽量自动化（避免人工维护）

你提出的目标是：

每次发布新版本时，最好自动升级，而不是让自制软件开发者手动更新和维护自制软件更新列表。

Homebrew 的现实机制是：

• livecheck 可以检测最新版（用于提示/工具辅助）。
• 但 官方 cask 的版本/sha256 仍然需要 PR 更新并合并，不会“无人值守自动改官方仓库”。
  这点在 Homebrew 维护者答复里说得很直白：有的项目会在 release 时跑 bump-cask-pr 自动开 PR，但仍需要 PR 流程。

3.3.1 推荐方案：在 v2rayN 仓库加 GitHub Actions，release 时自动开 homebrew/cask 的 PR

核心命令是：

brew bump-cask-pr v2rayn --version <NEW_VERSION> --no-browse

brew bump-cask-pr 的作用：自动完成 fork、修改 cask、算 sha、提交 commit、创建 PR（你也可以传入 sha/URL/多架构 version 参数）。

对于 arm/intel 双 sha 的情况，brew bump-cask-pr 也提供 --version-arm / --version-intel 等参数（见 Homebrew manpage）。

3.3.2 用现成 GitHub Action（可选）

GitHub Marketplace 上有一些 action 直接封装了 brew bump-cask-pr。
重点注意：通常需要用 Personal Access Token（PAT），而不是默认的 GITHUB_TOKEN，因为需要创建 fork 并在 Homebrew 仓库发 PR。

你可以在工作流里做两件事：

1. 监听 release 事件（或 tag 推送）；
2. 调用 bump-cask-pr / action 来开 PR。

这样维护成本最低：你只需要“正常发布 release”，PR 会自动出现，Homebrew 维护者 review/merge 即可。

---

4. 你提到的“不要让第三方用户本地编辑文件才能安装”如何满足？

满足方式只有一个：把 cask 合并进官方 homebrew/cask。

• 让用户执行：brew install --cask v2rayn（或你期望的 v2rayN）
• 不要求用户执行 brew tap ...
• 不要求用户下载 .rb 文件或本地编辑

这就要求：

• v2rayN 开发者（或任何贡献者）把 cask 通过 PR 合并进官方仓库；
• 并且 v2rayN 的 macOS 发行包持续满足 Homebrew 的 Gatekeeper / codesign 要求（否则会被 deprecated/disable）。

---

5. 参考资料（都来自我在写这份教程时实际核对过的页面）

为了便于你复制粘贴，我把链接都放到代码块里（避免 markdown 渲染干扰）。

v2rayN（官方）

https://github.com/2dust/v2rayN/issues/6624
https://github.com/2dust/v2rayN/issues/6655
https://github.com/2dust/v2rayN/wiki/Release-files-introduction
https://github.com/2dust/v2rayN/releases

Homebrew（官方）

https://docs.brew.sh/Adding-Software-to-Homebrew
https://docs.brew.sh/How-To-Open-a-Homebrew-Pull-Request
https://docs.brew.sh/Manpage
https://brew.sh/2025/11/12/homebrew-5.0.0/
https://brew.sh/2025/08/05/homebrew-4.6.0/

Apple（官方）

https://developer.apple.com/documentation/security/customizing-the-notarization-workflow
https://developer.apple.com/documentation/security/resolving-common-notarization-issues
https://developer.apple.com/documentation/notaryapi

GitHub Action（可选自动化工具）

https://github.com/marketplace/actions/homebrew-bump-cask

[xujiegb]

苹果官方开发者计划每年要付费是卡住这个项目的原因。从作者以及贡献者角度，谁来付费都比较被动。如果付费了开发者计划，都不用homebrew这么麻烦，直接下载安装包安装打开即可。

[Accademia]

苹果官方开发者计划每年要付费是卡住这个项目的原因。从作者以及贡献者角度，谁来付费都比较被动。如果付费了开发者计划，都不用homebrew这么麻烦，直接下载安装包安装打开即可。

既然都做了mac版本了，按照全球开源圈的惯例，可以 一劳永逸解决资金问题。

比如，在 homebrew和mac app store中 ，同时上架。像ppsspp作者，通过这种方式 每年可以为ppsspp获接近十万美元的捐赠。

即，同时上homebrew版本和 mac app store版本，并在后者渠道上放一个收费版
• 免费版
• 收费版：4.99美金（相当于捐赠版）
这俩 功能上 “0区别” 。只是收费版图标是金色的。

凡是能上mac app store的软件，包括 clash verge rev 和v2rayN，我都建议这么做。 能更多触达捐赠者。 100%能解决日常性开销成本的问题

[xujiegb]

既然都做了mac版本了，按照全球开源圈的惯例，在 mac app store中 ，同时上架 ：

• 免费版

• 黄金版 3.99美金

这俩 功能上 “0区别” 。只是收费版图标是金色的。

像全球有超过2亿用户的开源模拟器 ppsspp，就是这么处理的，后者相当于捐赠版，功能0区别。每年上述方式的捐赠变现，他们也有十几万美元。当然，他们在mac上，他们同时也提供homebrew和mac appstore两种更新 、安装方式。homebrew版也是全免费的。

凡是能上mac app store的软件，包括 clash verge rev 和v2rayN，我都建议这么做。 能更多触达捐赠者。

估计作者没计划

[2dust]

苹果官方开发者付费不是问题，问题在没有办法匿名。