该镜像属于balena.io的IoT设备基础镜像系列,专为物联网设备优化设计。它针对balena.io平台和balenaOS系统进行了特别优化,同时也可在其他支持相应架构的Docker环境中运行。作为Golang专项镜像,它提供了完整的Go语言开发和运行环境,适用于在物联网设备上构建和部署Go应用程序。
!balenalogo
balenalib基础镜像具有以下显著特性:
便捷的包安装工具:内置install_packages脚本,可抽象底层包管理器差异,以最小依赖安装指定包(忽略可选依赖),自动清理包管理器元数据,并在安装失败时重试。
动态设备支持:默认ENTRYPOINT为ENTRYPOINT ["/usr/bin/entry.sh"],通过设置ENV UDEV=1可启用UDEV支持,自动启动udevd守护进程,使容器内/dev目录能识别动态插入的设备节点。
更多特性详情请查看***文档中的特性概述。
balenalib镜像提供多种变体,适用于不同场景:
:<version> 或 :<version>-run默认镜像变体。run变体设计为精简版本,仅包含运行时必需组件,体积小巧。
:<version>-build构建变体为较完整镜像,包含大量源码构建所需工具,减少Dockerfile中手动安装包的需求,从而减小系统中所有镜像的总体积。
了解更多变体差异
install_packages和UDEV特性简化设备驱动和依赖管理1.19 (latest)、1.18.15、1.17.12更多镜像信息和历史版本,可查看asus-tinker-board-s-alpine-golang manifest文件(位于balena-io-library/official-images GitHub仓库)。
参考快速入门指南了解如何结合balena使用该基础镜像,也可查看示例项目获取实践灵感。
Go(又称Golang)是Google开发的编程语言,静态类型,语法借鉴C语言,具备垃圾回收、类型安全、动态类型能力、内置变长数组和键值映射等特性,拥有庞大的标准库。
***.org/wiki/Go_(programming_language)
!logo
最直接的用法是将Go容器同时作为构建和运行环境。在Dockerfile中编写如下内容,可编译并运行项目:
dockerfileFROM balenalib/asus-tinker-board-s-alpine-golang:latest WORKDIR /go/src/app COPY . . RUN go get -d -v ./... RUN go install -v ./... CMD ["app"]
构建并运行Docker镜像:
console$ docker build -t my-golang-app . $ docker run -it --rm --name my-running-app my-golang-app
若无需在容器内运行应用,仅需编译,可执行以下命令:
console$ docker run --rm -v "$PWD":/usr/src/myapp -w /usr/src/myapp balenalib/asus-tinker-board-s-alpine-golang:latest go build -v
该命令将当前目录挂载为容器卷,设置工作目录为卷路径,并执行go build编译项目。
如遇镜像相关问题或疑问,请通过GitHub Issue联系我们。
欢迎贡献新功能、修复或更新(无论大小)。提交PR前,建议通过GitHub Issue讨论计划,以便其他贡献者提供方向反馈或避免重复工作。
镜像详细文档请查看基础镜像文档,包含所有基础镜像(如node、python、go等专项镜像及精简版本)的信息。
了解balenalib基础镜像新特性,可参考博客文章。

来自真实用户的反馈,见证轩辕镜像的优质服务
免费版仅支持 Docker Hub 访问,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。
免费版仅支持 docker.io;专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。
当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
在 Linux 系统配置镜像服务
在 Docker Desktop 配置镜像
Docker Compose 项目配置
Kubernetes 集群配置 Containerd
在宝塔面板一键配置镜像
Synology 群晖 NAS 配置
飞牛 fnOS 系统配置镜像
极空间 NAS 系统配置服务
爱快 iKuai 路由系统配置
绿联 NAS 系统配置镜像
QNAP 威联通 NAS 配置
Podman 容器引擎配置
HPC 科学计算容器配置
ghcr、Quay、nvcr 等镜像仓库
无需登录使用专属域名