klutchell/balena-cli

balena-cli-docker

包含balena CLI和Docker-in-Docker的非官方Docker镜像，用于简化balena设备与应用的管理流程。

环境变量

以下环境变量可扩展镜像功能（多数为可选）：

• -e "SSH_PRIVATE_KEY=$(</path/to/priv/key)": 传入SSH私钥内容
• -e "DOCKERD=1": 启用内置Docker-in-Docker守护进程（需--privileged参数）
• -e "DOCKERD_EXTRA_ARGS=--key=val": 为Docker-in-Docker提供额外参数

卷

卷用于持久化数据或共享文件（多数为可选）：

• -v "balena_data:/root/.balena": 持久化balena凭据与下载内容
• -v "docker_data:/var/lib/docker": Docker-in-Docker模式下持久化缓存
• -v "$PWD:$PWD" -w "$PWD": 绑定当前工作目录以共享源码/镜像
• -v "${SSH_AUTH_SOCK}:/ssh-agent": 挂载主机SSH代理套接字
• -v "/var/run/docker.sock:/var/run/docker.sock": 绑定主机Docker套接字替代Docker-in-Docker

使用场景

登录

容器内无法使用网页授权，需用--token或--credentials：

bash
docker volume create balena_data
docker run --rm -it -v "balena_data:/root/.balena" docker.xuanyuan.run/klutchell/balena-cli /bin/bash
> balena login --credentials --email "user@example.com" --password "pass"
> exit

推送应用

绑定当前目录以访问源码：

bash
docker run --rm -it -v "balena_data:/root/.balena" -v "$PWD:$PWD" -w "$PWD" docker.xuanyuan.run/klutchell/balena-cli /bin/bash
> balena push myApp --source .
> exit

SSH到设备

方法一：传入私钥

bash
docker run --rm -it -v "balena_data:/root/.balena" -e "SSH_PRIVATE_KEY=$(</path/to/key)" docker.xuanyuan.run/klutchell/balena-cli /bin/bash
> balena ssh f49cefd
> exit

方法二：挂载SSH代理

bash
eval ssh-agent && ssh-add /path/to/key
docker run --rm -it -v "balena_data:/root/.balena" -v "${SSH_AUTH_SOCK}:/ssh-agent" docker.xuanyuan.run/klutchell/balena-cli /bin/bash
> balena ssh f49cefd
> exit

扫描本地设备（仅Linux）

bash
docker run --rm -it --network host docker.xuanyuan.run/klutchell/balena-cli scan

预加载应用到镜像

使用Docker-in-Docker：

bash
docker run --rm -it -v "balena_data:/root/.balena" -v "docker_data:/var/lib/docker" -e "DOCKERD=1" --privileged docker.xuanyuan.run/klutchell/balena-cli /bin/bash
> balena os download raspberrypi3 -o pi.img
> balena os configure pi.img --app MyApp
> balena preload pi.img --app MyApp --commit current
> exit