嵌入式 Linux on Potter的个人笔记

为嵌入式 Linux（RK3588、RV1126、RK3568）构建可复现的 Docker 开发环境

Sat, 28 Mar 2026 00:00:00 +0000

为嵌入式 Linux 构建可复现的 Docker 开发环境

问题背景

如果你在做 RK3588、RK3588S、RV1126、RK3568 等 Rockchip SoC 的嵌入式 Linux 开发，一定遇到过这些问题：

团队里每个人安装的工具链版本都略有差异 → 构建结果不一致
维护多个差异越来越大的 Dockerfile（每个芯片一个）
同时支持 Ubuntu 20.04、22.04、24.04，改一处就破坏另一处
多个平台的容器同时运行时端口冲突
镜像推送到私有 Harbor registry 需要一堆没人维护的粘合脚本

标准答案是"把开发环境容器化" — 但容器定义本身变成了新的维护负担。

解决方案：HarborPilot

HarborPilot 是一个全脚本化的工具链，自动化嵌入式 Linux Docker 开发镜像的构建-标签-推送全流程。

核心思路如下：

1. 单一的 5 阶段 Dockerfile

不再是 5 个 Dockerfile，只有一个：

Stage 1: 基础 OS（apt 源替换、软件包、用户创建、locale）
Stage 2: 开发工具（cmake、gdb、CUDA、OpenCV、Node.js、Python）
Stage 3: SDK 初始化（git init、符号链接、辅助脚本）
Stage 4: 环境配置（代理、profile.d 变量）
Stage 5: 工作区 + entrypoint + 测试

平台特定行为通过构建时注入的 ARG/ENV 变量控制，而不是靠不同的 Dockerfile。