agent-beacon

环境要求

• macOS：需安装 Homebrew，用于 brew 安装 Beacon
• Linux：支持 Debian/Ubuntu 与 Fedora/RHEL/Rocky/Alma，架构为 x86_64 或 arm64
• Windows：使用 x64 MSI 安装包
• 网络可访问 GitHub Releases 以下载安装脚本或安装包
• Linux 用 apt/dnf 安装 .deb/.rpm 需要 sudo 权限，无 root 时可改用用户模式 tarball

安装与启动步骤

1. 1macOS 安装

   先信任并添加 asymptote-labs/tap，再安装 beacon，最后执行 endpoint install 完成本机端点初始化。

   brew trust asymptote-labs/tap
   brew tap asymptote-labs/tap
   brew install beacon
   beacon endpoint install

   复制

2. 2Linux 脚本安装

   官方安装脚本会自动识别架构、下载对应 deb/rpm 包、用 checksums.txt 校验后交给 apt-get 或 dnf 安装。

   curl -fsSL https://github.com/asymptote-labs/agent-beacon/releases/latest/download/install.sh | bash

   复制

3. 3先审脚本再执行

   不想把脚本直接管道进 shell，可先下载保存并阅读内容，确认无误后再用 bash 运行。

   curl -fsSLO https://github.com/asymptote-labs/agent-beacon/releases/latest/download/install.sh
   less install.sh
   bash install.sh

   复制

4. 4Linux 手动安装

   自行确定版本与架构，下载包和 checksums.txt，用 sha256sum 校验后交给 apt 或 dnf 安装；Fedora 等改用 rpm。

   VERSION="$(curl -fsSLI -o /dev/null -w '%{url_effective}' https://github.com/asymptote-labs/agent-beacon/releases/latest)"; VERSION="${VERSION##*/v}"
   case "$(uname -m)" in x86_64) ARCH=amd64 ;; aarch64) ARCH=arm64 ;; esac
   FORMAT=deb   # or rpm for Fedora, RHEL, Rocky, Alma
   PKG="beacon_${VERSION}_linux_${ARCH}.${FORMAT}"
   BASE="https://github.com/asymptote-labs/agent-beacon/releases/download/v${VERSION}"
   DIR="$(mktemp -d /tmp/beacon-install.XXXXXXXX)" && chmod 0711 "$DIR" && cd "$DIR"
   curl -fsSLO "${BASE}/${PKG}" && curl -fsSLO "${BASE}/checksums.txt" && chmod 0644 "${PKG}"
   grep "  ${PKG}$" checksums.txt | sha256sum --check - && 
   sudo apt install "./${PKG}"

   复制

5. 5Windows 安装

   从最新 release 页面下载 x64 MSI 后用 msiexec 安装，加 /qn 参数可静默安装。

   msiexec /i BeaconEndpointAgent--x64.msi

   复制

6. 6初始化端点

   安装完成后运行 beacon endpoint install，交互式设置会引导登录并连接本机端点。

   beacon endpoint install

   复制

关键配置

如何确认成功

安装命令（brew install / install.sh / msiexec）无报错，且 `beacon endpoint install` 交互式设置顺利走完，即视为安装成功。

常见问题

注意事项

• 交互式 endpoint 设置默认选中 Beacon Cloud，签入不上传任何内容，确认页面在你接受前会说明这一点，可选择 Local 退出。
• 系统、包管理、MDM 和 CI 安装路径保持非交互且无需账号。
• checksums.txt 随 release 发布，仅用于发现损坏或被替换的下载，不验证发布者身份。
• Windows MSI 命令中的 需替换为实际下载到的版本号。