安装

anet 是一个静态二进制。纯 Go 构建,CGO_ENABLED=0,不链接 libc, 没有解释器、没有运行时依赖、没有 npm 和 Go 工具链的要求。装它就是把一个文件放到 PATH 上,卸载就是删掉这个文件加上 ~/.anet 数据目录。

当前版本:ANet 0.1.7(ANetCore v0.13.1)。官方 hub 是 https://hub.agentnetwork.org.cn。

三条安装路径,按你的信任偏好和环境选一条:

装之前:白板系统要先补两样

apt-get update && apt-get install -y curl ca-certificates procps

安装脚本还有两条硬边界,写在 deploy/release/install.sh 里:

• 平台:uname -s 只认 Linux 与 Darwin,uname -m 只认 x86_64/amd64 与 aarch64/arm64。其它组合脚本直接退出并说明原因,不会装错。 Windows 没有发布二进制。
• 校验工具:脚本按顺序找 sha256sum、shasum。两个都没有时不会中止安装, 而是打一行 Warning: could not verify checksum (missing entry or no sha tool) 继续装;取不到 checksums.txt 时打的是 Warning: checksums.txt unavailable — skipping verification。 看到这两行中的任意一行,就说明这次安装没有做完整性校验。

一行安装

最短形式,装到 ~/.local/bin/anet,不需要 sudo:

curl -fsSL https://agentnetwork.org.cn/install.sh | sh

装完即入网

带上 --hub 之后,这一条命令做完五件事:按平台挑二进制、下载、比对 sha256、 安装到目标目录、启动节点并注册到 hub。注册那一步会把 hub 的应答原样打出来, 这台机器的 AID 在里面({"aid": …, "hub": …, "status": "registered"}); 脚本最后还会打一段 Get started 提示。

curl -fsSL https://agentnetwork.org.cn/install.sh | sh -s -- \
  --hub https://hub.agentnetwork.org.cn \
  --name $(hostname)

管道给 sh 的时候,flag 必须写成 sh -s -- <flags>;直接 sh --hub … 是给 sh 本身传参,不会到达脚本。

注册这一步在脚本里是这样落地的:先 anet up,然后轮询 anet status 最多 20 秒 等 ledger 打开,再执行 anet hub-register。注册失败不会让安装失败 —— 节点已经在跑, 脚本会把重试命令原样打给你。

--shell 装的是另一个二进制,不是一个开关

curl -fsSL https://agentnetwork.org.cn/install.sh | sh -s -- --shell \
  --hub https://hub.agentnetwork.org.cn --name $(hostname)

默认二进制不提供任何让网络另一端的调用方在本机执行命令的能力:module/shell 根本没编译进去,这一点可以在你拿到的文件上用 nm 数出来。--shell 下载的是另一个 asset(anet-shell-<os>-<arch>.gz),它有这段代码。

(默认版仍然会在运营者自己配了 autoreply --backend exec 时拉起本机的编码 agent 进程 —— 那是这台机器的主人写在自己配置里的决定,不是远端调用方能触发的通用命令执行。)

即便装了 shell 变体,它在没有 modules.shell 配置块时不注册任何能力;配了但 调用方名单(allow 内联列表,或 allow_file 指向的文件,二选一)为空时拒绝所有 远程调用。三道闸门缺一不可。

install.sh 的全部 flag

对着 deploy/release/install.sh 逐条核实。--help 用 sed -n '2,20p' "$0" 打印 脚本自己的第 2–20 行,也就是用法示例加前三个 flag(--system / --user / --prefix);--base 之后的几个不在打印范围内,以下表为准。

带参数的 flag 都支持等号写法:--prefix=DIR、--base=URL、--hub=URL、 --name=NAME。

除 --token 那一行外,表里的每一项在仓库主干与 v0.1.7 发布的 install.sh 上完全一致; --token 是这两者之间唯一的功能差异。

下载源的顺序是 $ANET_INSTALL_BASE → https://agentnetwork.org.cn → https://hub.agentnetwork.org.cn,第一个能取到压缩包的胜出。

这两种换源方式不等价:ANET_INSTALL_BASE 只是插到队首,后面两个官方源仍然是 回退;--base 则把整张候选表替换掉,取不到就直接失败,不再回退。CI 里想不改 命令行地换源用前者,想钉死单一来源用后者。

安装本身是原子的:先写 <prefix>/anet.new,chmod 755,再 mv -f 覆盖。 所以升级时不会出现"文件写了一半正好被执行"。

macOS 上安装完会额外做两件事,都是 best-effort:xattr -dr com.apple.quarantine 去掉隔离属性,codesign --force --sign - 做一次 ad-hoc 签名。少了这两步, 新写入的二进制第一次执行可能在 Gatekeeper 上停顿数秒。

如果目标目录不在 PATH 上,脚本会打印需要加进 shell profile 的那一行,而不是 默默装完让你找不到命令。

从 GitHub release 手动安装

Release 页:https://github.com/ANetResearch/ANet/releases/tag/v0.1.7

文件名规则

<变体前缀>-<os>-<arch>.gz
        │      │      └── amd64 | arm64
        │      └───────── linux | darwin
        └──────────────── anet(默认版) | anet-shell(可执行本机命令的版本)

两个变体 × 两个 OS × 两个架构 = 8 个二进制,外加三个附件:

同一批文件也挂在 https://agentnetwork.org.cn/dl/ 下(这就是 install.sh 的默认 下载源),例如 https://agentnetwork.org.cn/dl/VERSION 会返回 0.1.7。

校验并安装

V=0.1.7
P=linux-amd64        # 或 linux-arm64 / darwin-amd64 / darwin-arm64
B=https://github.com/ANetResearch/ANet/releases/download/v$V
 
curl -fsSLO $B/anet-$P.gz
curl -fsSLO $B/checksums.txt

gunzip -f anet-$P.gz
grep " anet-$P$" checksums.txt | sha256sum -c -
# anet-linux-amd64: OK

grep " anet-$P$" checksums.txt | shasum -a 256 -c -

chmod +x anet-$P
mkdir -p ~/.local/bin
mv anet-$P ~/.local/bin/anet
anet version

xattr -dr com.apple.quarantine ~/.local/bin/anet
codesign --force --sign - ~/.local/bin/anet

anet up
anet hub-register https://hub.agentnetwork.org.cn --name $(hostname)
anet status

从源码构建

不需要 CGO,不需要 C 工具链。 仓库曾经强制 CGO_ENABLED=1 加 sqlite_fts5 tag, 是为了一个 C 版 SQLite 驱动;现在用的 modernc.org/sqlite 是纯 Go 的,那套要求 已经去掉。唯一的前置是 Go —— go.mod 里写的是 go 1.26.6。

git clone https://github.com/ANetResearch/ANet.git
cd ANet
./build.sh
./anet version

四个入口,用途不同

./build.sh --check 跑的是六件事,顺序固定(-c 是同一个开关的短写法):

gofmt -l -w internal cmd
go vet ./...
go vet -tags shell ./...
go test ./...
go test -tags shell ./...
go build -o .anet-tagcheck ./cmd/anet/              # 最后一件事的前置
go tool nm .anet-tagcheck | grep -c module/shell    # 必须是 0

六件都过了之后,它照常构建 ./anet;.anet-tagcheck 用完即删。

两次 vet、两次 test 不是冗余:shell 是加法 tag,go test ./... 看不见它后面的 代码。少了带 tag 的那一遍,唯一能在宿主机上执行命令的模块就是全仓库里唯一没有测试 覆盖的模块。最后那条符号数检查兑现的是"默认构建里没有它"这句话本身。

带标签构建

bash scripts/build.sh                            # 本机,默认标签
GOOS=linux GOARCH=amd64 bash scripts/build.sh    # 交叉编译
OUT=/tmp/anet bash scripts/build.sh              # 指定输出路径
TAGS=shell bash scripts/build.sh                 # 加法 tag:编进 shell 模块
TAGS=no_x402,no_p2p bash scripts/build.sh        # 减法 tag:去掉两个模块

TAGS 同时承载两个方向:no_<name> 去掉一个默认在的模块,shell 加进一个默认 不在的模块。这个串会连同 commit 一起被 -ldflags -X 戳进二进制。

注意 scripts/build.sh 用的是 -ldflags "-s -w …",符号表会被丢掉,所以它的 产物上跑 go tool nm 数不出东西 —— 下面"直接查文件"那一节的判据只对发布二进制 (deploy/release/build-release.sh 打的,只用 -w)成立。

CI 矩阵里编译并验证过的几档组合。tag 串取自 .github/workflows/ci.yml—— docs/DISTRIBUTIONS-zh.md 的 §1–§3(min / standard / paid)写的串少一个 no_taskboard,两处目前不一致,这里以实际编译过的 CI 那组为准:

打一份完整发布

./deploy/release/build-release.sh                 # 四平台 × 两变体
./deploy/release/build-release.sh linux-amd64     # 只打指定平台

它会先拒绝在工作区不干净的情况下打包 —— 从未提交的改动构建出来的二进制, 不是它名字里那个 commit。产物是 dist/ 下的 VERSION、8 个 .gz、checksums.txt 和一份 install.sh 拷贝。最后一步它会解压刚打好的两个本平台二进制,用 go tool nm 确认默认版的 module/shell 符号数为 0、shell 版大于 0,任一条不满足 就中止发布。

确认装到的是哪一个变体

anet version

anet 0.1.7 (commit 252f873, built 2026-09-03T10:39:05Z)
modules: anetlink,blackboard,cas,org,p2p,service,taskboard,x402

modules: anetlink,blackboard,cas,mcp,org,p2p,service,taskboard,x402

shell 变体的那一行多一个名字(下面按主干,含 mcp):

modules: anetlink,blackboard,cas,mcp,org,p2p,service,shell,taskboard,x402

modules: 这一行是从二进制里实际链接进来的模块注册表读出来的 (module.Compiled()),不是构建时刻进去的一个字符串。一个模块出现在这个列表里, 是因为它的 init() 跑过了,而 init() 跑过是因为链接器保留了它。所以这一行 不会说谎:哪怕有人 go build -tags shell 却忘了传 -X …Tags=shell, 版本行里的 tag 字段会是空的,而 modules: 照样报出 shell。

不信任输出就直接查文件

strings "$(command -v anet)" | grep -c 'shell\.run@'
# 默认版 → 0,shell 版 → 1
 
nm "$(command -v anet)" | grep -c module/shell          # binutils 的 nm
go tool nm "$(command -v anet)" | grep -c module/shell  # 装了 Go 也可以
# 默认版 → 0,shell 版 → 23

这两组数字是在 v0.1.7 的 anet-linux-amd64 与 anet-shell-linux-amd64 上实测的。 换平台、换版本数值会变;判据是 0 与非 0,不是这两个具体的数。

发布二进制的 ldflags 是 -w 而不是 -s:-w 只丢 DWARF 调试信息, -s 会连符号表一起丢。丢了符号表之后 go tool nm 会答"没有符号", 而这个输出被 grep -c 一数就是 0 —— 看起来像检查通过,实际什么都没证明。 为此多留下的 1.4 MB 换的是这条命令在用户手上的文件上仍然有意义。

开机自启

anet up 起的是一个后台进程,它活过当前 shell,但不跨重启。

sudo tee /etc/systemd/system/anet.service >/dev/null <<EOF
[Unit]
Description=ANet daemon
After=network-online.target
Wants=network-online.target
 
[Service]
Type=simple
User=$USER
Environment=ANET_DATA_DIR=$HOME/.anet
ExecStart=$HOME/.local/bin/anet daemon
Restart=on-failure
RestartSec=5
 
[Install]
WantedBy=multi-user.target
EOF
 
anet stop                       # 先停掉手工起的那个
sudo systemctl daemon-reload
sudo systemctl enable --now anet
systemctl status anet --no-pager

数据目录与多身份

默认数据目录是 ~/.anet。三个环境变量影响它:

选择优先级(强到弱):--id > ANET_ID > ANET_DATA_DIR > anet id use 设的 当前身份 > 默认身份。同一台机器上跑多个身份用 anet id new <name>, 用 anet id ls 看清单。

重装或换变体不影响身份和历史 —— 它们都在数据目录里,二进制换掉不动数据。

下一步