ARM 平台编译 OpenWrt 时 Golang 问题总结

问题描述

在 aarch64（ARM64）平台上编译 OpenWrt/LEDE 固件时，若配置中包含依赖 Go 语言的包（如 v2ray、xray、AdGuardHome、mosdns、frp 等），编译会在 host 阶段失败，报错如下：

Makefile:380: *** go-bootstrap cannot be installed on linux/arm64.  Stop.
make[3]: Leaving directory '.../feeds/packages/lang/golang/golang'
ERROR: package/feeds/packages/golang [host] failed to build.
make[2]: *** [package/Makefile:169: package/feeds/packages/golang/host/compile] Error 1

根本原因

OpenWrt 的 golang 包在编译 host 工具链时，需要一个 go-bootstrap（用于引导编译 Go 编译器自身）。其 Makefile 中对宿主机架构做了限制，默认只允许 x86_64，在 linux/arm64 宿主机上会直接报错终止。

系统自带的 Go 版本（如 apt 安装的 golang-go 通常为 1.18）版本过低，也无法满足要求。

解决方案

方法一：配置外部 Bootstrap Go 根目录（推荐）

Step 1：安装新版 Go（1.20+）

wget https://go.dev/dl/go1.22.3.linux-arm64.tar.gz
rm -rf /usr/local/go
tar -C /usr/local -xzf go1.22.3.linux-arm64.tar.gz
export PATH=/usr/local/go/bin:$PATH

# 验证版本
go version
# 输出：go version go1.22.3 linux/arm64

Step 2：修改 OpenWrt .config，指定外部 Bootstrap 路径

方式 A：通过 make menuconfig 图形界面设置

Languages → Go → Configuration → External Bootstrap Go Root Directory
填入：/usr/local/go

方式 B：直接编辑 .config 文件

# 如果已有该配置项，修改它
sed -i 's|.*CONFIG_GOLANG_EXTERNAL_BOOTSTRAP_ROOT.*|CONFIG_GOLANG_EXTERNAL_BOOTSTRAP_ROOT="/usr/local/go"|' /root/lede/.config

# 如果没有该配置项，追加
echo 'CONFIG_GOLANG_EXTERNAL_BOOTSTRAP_ROOT="/usr/local/go"' >> /root/lede/.config

# 验证
grep "GOLANG_EXTERNAL_BOOTSTRAP" /root/lede/.config

⚠️ 注意：路径填 Go 的根目录 /usr/local/go，不是可执行文件路径 /usr/local/go/bin/go

Step 3：重新编译

cd /root/lede
make -j$(nproc)

方法二：去掉所有 Go 依赖的包（最简单）

如果不需要 v2ray、xray、AdGuardHome 等 Go 编写的包：

make menuconfig
# 找到并取消勾选所有 Go 语言相关的包
# 保存后重新编译
make -j$(nproc)

方法三：使用 x86_64 Docker 容器编译（彻底隔离）

性能较差（QEMU 模拟约为原生的 1/5～1/10），编译时间会大幅增加，不推荐，仅作备用。

apt install qemu-user-binfmt-hwe binfmt-support
docker run --platform linux/amd64 -it \
  -v /root/lede:/root/lede \
  ubuntu:22.04 /bin/bash

总结对比