安装
选择适合你平台的安装方式,所有方式均会生成同一个 redmine 二进制文件。
适用于 macOS 和 Linux,自带 bash、zsh 和 fish 的 shell 补全支持。
brew tap aarondpn/tapbrew install redmine自动检测操作系统和架构,验证 SHA256 校验和,安装至 ~/.local/bin。
curl -fsSL https://raw.githubusercontent.com/aarondpn/redmine-cli/main/install.sh | bash校验和检查始终会执行,不匹配时总是中止安装。脚本是否还会检查版本的构建来源证明(attestation),取决于 GitHub CLI:
- 验证证明。 如果已安装
gh、版本足够新(gh attestation verify支持--signer-workflow和--source-ref;当前的所有版本都满足),并且已登录(gh auth login,或设置了GH_TOKEN/GITHUB_TOKEN),脚本会对归档文件运行gh attestation verify,构建来源证明未通过时拒绝安装。 - 仅校验和。 如果
gh未安装、版本过旧或未登录,脚本只在校验和检查通过后安装,并打印一条说明原因的警告,以及可自行验证该版本的gh attestation verify命令。
如果 gh 因环境原因无法完成检查(代理屏蔽了 Sigstore,或 gh 只登录了 GitHub Enterprise Server),可设置 REDMINE_CLI_SKIP_ATTESTATION=1,仅凭校验和验证进行安装。脚本会打印警告和自行验证该版本的命令。与 redmine update --skip-attestation 一样,校验和与归档文件来自同一位置,因此无法发现被篡改的版本;切勿用它绕过确实无效的证明。
如需安装指定版本而不是最新版本,请设置 REDMINE_CLI_VERSION,并从同一标签获取脚本:
curl -fsSL https://raw.githubusercontent.com/aarondpn/redmine-cli/<tag>/install.sh | REDMINE_CLI_VERSION=<tag> bashv2.14.1 及更早版本的 install.sh 会忽略 REDMINE_CLI_VERSION 并安装最新版本;要固定到这些版本之一,请改用 main 分支上的脚本。
证明仅存在于 v2.11.2 及更高版本。在已登录 gh 的情况下固定更早的版本时,证明验证会失败,脚本会拒绝安装;此时需同时设置 REDMINE_CLI_SKIP_ATTESTATION=1,仅凭校验和验证进行安装。
通过 Go 工具链从源码构建,需要 Go 1.26 或更高版本(go.mod 中的 go 指令);在默认的 GOTOOLCHAIN=auto 下,较旧的 Go 1.21+ 会自动下载合适的工具链。发行版二进制文件使用 Go 1.27.3 构建。
go install github.com/aarondpn/redmine-cli/v2/cmd/redmine@latest下载适合你平台的预构建发行版。
| 平台 | 架构 | 文件名 |
|---|---|---|
| Linux | x86_64 | redmine-cli-linux-amd64.tar.gz |
| Linux | ARM64 | redmine-cli-linux-arm64.tar.gz |
| macOS | Intel | redmine-cli-darwin-amd64.tar.gz |
| macOS | Apple Silicon | redmine-cli-darwin-arm64.tar.gz |
| Windows | x86_64 | redmine-cli-windows-amd64.zip |
下载地址见 GitHub Releases。
-
确认二进制文件可访问并能输出版本信息:
终端窗口 redmine --version -
运行内置健康检查,验证安装是否正常:
终端窗口 redmine --help -
继续前往 配置 以连接你的 Redmine 服务器。
redmine update拉取最新版本,验证其 SHA256 校验和以及 GitHub artifact attestation,然后替换当前运行的二进制文件。参见 自动更新 了解详情和可用标志。