How to Set Up Homebrew Tap for Private CLI Tools: A Complete Guide
本文针对私有CLI工具通过Homebrew分发时因权限导致的404问题，提供了一套完整解决方案。核心思路是解耦源码发布与资源分发：将编译后的二进制包与校验文件同步至公开的OSS/CDN，同时在公开的Tap仓库中托管自动维护的Ruby Formula。这确保了终端用户无需配置GitHub Token即可无缝安装与更新。方案详细阐述了前期准备（如Tap仓库创建、打包规范）、GitHub Actions自动化流水线的关键实现——该流水线能自动根据OSS上的资源生成指向最新版和特定旧版本的Formula脚本。文章还重点分享了若干实践经验：必须在`def install`阶段明确指定额外资源目录的安装路径，以避免文件被Homebrew丢弃；以及如何通过为每次发布生成带有版本号的Formula文件（如`cli@0.4.9.rb`），来建立可靠的版本降级“后悔药”机制。最终，用户可使用简洁的`brew tap`与`brew install`命令进行安装、更新与版本切换。