Goose 跨平台安装指南：Linux、Windows、macOS、Docker 一次讲清
项目地址: https://gitcode.com/GitHub_Trending/goose3/goose Goose 是一个开源可扩展的 AI Agent，能直接写代码、跑命令、做测试。它的跨平台兼容能力覆盖 Linux、Windows、macOS 与 Docker：官方安装脚本一条命令自动适配三大系统，桌面端和容器化部署也各有明确路径。
三套系统，三套折腾
真正麻烦的从来不是装一个软件，而是同一个工具要在三套系统上各折腾一遍：Linux 上处理发行版差异和架构，Windows 上补齐 Node 环境，macOS 上还要过签名公证这一关。
Goose 的跨平台兼容思路很直接：核心用 Rust 写，平台差异集中在安装脚本和构建产物里解决。装完以后，三个系统拿到的是同一个二进制、同一套命令，你不需要记三套用法。
一条命令装好 Goose 的通用方法
仓库根目录的 download_cli.sh 就是跨平台安装的入口，脚本头部注释写明了支持范围：macOS、Linux、Windows（MSYS2/Git Bash/WSL），外加 Android Termux，架构覆盖 x86_64 与 arm64。逻辑大致是：
git clone https://gitcode.com/GitHub_Trending/goose3/goose
cd goose
克隆下来之后，直接运行仓库里的 download_cli.sh，或者从 Releases 拉取同一段脚本执行。它会自己检测 OS 与 CPU 架构，从 Releases 下载对应二进制，装进 $HOME/.local/bin（Windows 下是 %USERPROFILE%\goose），最后提示你把目录加进 PATH 并跑一次 goose configure。脚本里对 WSL 的 /proc/version 判断、MSYS2 的 OSTYPE 识别、Termux 的 musl 选择这些分支，就是"三套系统一套姿势"的具体代价——你已经付过了。
各平台的落地细节
Linux 装好 Goose：自动区分 glibc、musl 与 Termux
"Linux" 一词背后，是 Debian、Arch、Fedora 加 Alpine、Termux 这一堆现实。安装脚本会跑 ldd --version 或检查 TERMUX_VERSION 判断 libc 实现，自动选择 musl 便携构建；你也可以用 GOOSE_LINUX_VARIANT 环境变量显式指定 standard、vulkan 或 musl。想从源码构建，命令就是 cargo build --release -p goose-cli --bin goose，完整步骤在 BUILDING_LINUX.md。
桌面应用是另一条线：先在 Rust 侧出二进制，再进 ui/desktop 用 pnpm run make 打包成 DEB 或 ZIP：
cargo build --release -p goose-cli --bin goose
cd ui/desktop && pnpm install && pnpm run make
产物在 out/goose-linux-x64/goose，文档里还给了 ~/.local/share/applications/goose.desktop 桌面项模板，可以挂进应用菜单。
Windows 支持 Goose：只有 x86_64，但环境帮你补全
换成 Windows 就不同了。CLI 侧脚本只放行 x86_64，GOOSE_WINDOWS_VARIANT 提供 standard 和 cuda 两种变体，装完后 goose.exe 和依赖的 DLL 一起落在 %USERPROFILE%\goose，PATH 没配好时脚本会直接打印 PowerShell 的修复命令。桌面端的 Windows 支持文件集中在 ui/desktop/src/platform/windows/bin/，构建时由 prepare-windows-npm.sh 生成 Node.js 安装脚本；目录里的 npx.cmd 会在首次运行 Go 扩展时自动下载固定版本的便携 Node.js 到 %LOCALAPPDATA%\Goose\node，你不用自己配 Node 环境。
macOS 支持 Goose：安装最省事，签名公证走构建流程
macOS 的 CLI 安装是三个系统里最干净的：脚本自动匹配 arm64 或 x86_64 的 tar.bz2 包。桌面端走签名与公证：pnpm run bundle:default 打出的 goose.app 只有在按 ui/desktop/forge.config.ts 配好签名环境变量后才算完成签名公证，细节见 ui/desktop/README.md。日常使用只装 CLI 的话，macOS 这边基本没有额外动作。
把 Goose 装进容器
Docker 部署是最省事的一条路，BUILDING_DOCKER.md 直接给了预构建镜像的拉取方式，docker pull ghcr.io/aaif-goose/goose:latest 一条命令就能跑起来。
docker run --rm -v $(pwd):/workspace -w /workspace \
-e GOOSE_PROVIDER=anthropic -e ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY \
ghcr.io/aaif-goose/goose:latest run -t "分析这个目录的代码"
要自己构建多架构镜像，仓库根目录的 Dockerfile 是多阶段构建（rust 构建 + debian:bookworm-slim 运行，最终约 340MB，非 root 用户运行）：
docker buildx build --platform linux/amd64,linux/arm64 -t goose:multi .
CI/CD 里把它当任务容器用也很自然：挂上工作目录和 ~/.config/goose 配置目录即可。
验证你的跨平台清单
- 装完先跑
goose --version，再执行一次goose configure - Linux：确认安装目录是
$HOME/.local/bin，musl 系统下选对变体 - Windows：确认
%USERPROFILE%\goose里有goose.exe和配套 DLL - macOS 桌面版：确认走的是签名公证后的产物
- Docker：
docker run --rm ghcr.io/aaif-goose/goose:latest --version验证镜像可用
五步都过，你手上这套 Goose 在任何一台机器上都能直接开工。现在就按你的系统选一条路径装起来，跑通第一条 goose run。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
