daryltucker/gcc

GCC工具链Docker镜像

自包含、可移植的GCC工具链，生成带主权RPATH的二进制文件

从源代码构建的独立GCC编译器工具链，嵌入库搜索路径。这些编译器生成的二进制文件可在Linux发行版间运行，无需设置LD_LIBRARY_PATH。

---

快速开始

bash
# 拉取最新GCC 15.2.0镜像
docker pull daryltucker/gcc:15.2.0

# 编译程序
docker run --rm -v $(pwd):/work -w /work daryltucker/gcc:15.2.0 \
  /opt/toolchains/gcc-15.2.0/*/bin/gcc -o hello hello.c

# 运行程序（无需LD_LIBRARY_PATH）
./hello

---

核心功能

🔒 密封构建

每个工具链均从源代码构建，所有依赖自包含。不依赖主机系统库，无发行版特定问题。

🚀 主权RPATH

编译器生成的二进制文件嵌入库搜索路径，无需环境配置即可在裸系统上运行。

📦 完整工具链

每个镜像包含：

• GCC（C、C++、Fortran）
• ***utils（as、ld、ar、objdump等）
• Glibc（或裸机环境的Newlib）
• 数学库（GMP、MPFR、MPC、ISL）

🎯 多架构支持

• 本地架构：x86_64（含优化构建，如Legion S7）
• 交叉编译：aarch64（RPi5）、powerpc64（PS3 PPU）
• 裸机环境：spu-elf（PS3 SPU）

---

可用镜像

GCC版本

优化构建

交叉编译工具链

---

使用示例

本地编译

bash
docker run --rm -v $(pwd):/work -w /work daryltucker/gcc:15.2.0 \
  /opt/toolchains/gcc-15.2.0/*/bin/gcc -O2 -o myapp myapp.c

交叉编译（树莓派5）

bash
docker run --rm -v $(pwd):/work -w /work daryltucker/gcc:12.4.0-rpi5 \
  /opt/toolchains/gcc-12.4.0_rpi5/aarch64-linux-gnu/bin/aarch64-linux-gnu-gcc \
  -o hello-rpi hello.c

交互式开发

bash
docker run -it --rm -v $(pwd):/work -w /work daryltucker/gcc:15.2.0 bash
# 容器内操作：
export PATH=/opt/toolchains/gcc-15.2.0/x86_64-linux-gnu/bin:$PATH
gcc --version

---

镜像命名约定

daryltucker/gcc:{HOST_ARCH}-{VERSION}[-{PROFILE}]-{TARGET_ARCH}

示例:

• daryltucker/gcc:15.2.0 → x86_64本地构建
• daryltucker/gcc:x86_64-gcc-13.3.0_legion_s7-x86_64 → 完整标识
• daryltucker/gcc:12.4.0-rpi5 → 树莓派5交叉编译器快捷方式

快捷方式: 最常见的主机架构（x86_64）在短标签中省略主机前缀。

---

工具链布局

所有工具链遵循分层结构：

/opt/toolchains/
└── gcc-{VERSION}[_{VARIANT}]/
    └── {TARGET_TUPLE}/
        ├── bin/          # 编译器二进制文件
        ├── lib/          # 运行时库
        ├── lib64/        # 64位库
        └── sysroot/      # 目标头文件/库（仅交叉编译）

查找编译器:

bash
find /opt/toolchains -name "*-gcc" -type f

---

验证

这些编译器生成的所有二进制文件均自包含:

bash
# 编译测试程序
docker run --rm -v $(pwd):/work -w /work daryltucker/gcc:15.2.0 \
  /opt/toolchains/gcc-15.2.0/*/bin/g++ -o test test.cpp

# 检查动态链接器路径（指向工具链而非系统）
readelf -l test | grep interpreter

# 检查库路径（已嵌入RPATH）
readelf -d test | grep RPATH

# 无需LD_LIBRARY_PATH运行
./test

预期输出:

• 解释器: /opt/toolchains/gcc-15.2.0/.../lib/ld-linux-x86-64.so.2
• RPATH: /opt/toolchains/gcc-15.2.0/.../lib64:/opt/.../lib

---

来源与文档

• GitHub: https://github.com/daryltucker/gcc-docker
• 构建系统: 基于Docker的密封构建，使用官方GNU源代码
• 理念: https://github.com/daryltucker/gcc-docker/blob/main/docs/PROJECT_PHILOSOPHY.md

---

许可证

GCC工具链遵循GNU GPL协议分发。Docker构建系统和配置文件按原样提供。

---

支持

这些镜像专为生产使用构建，重点关注：

• ✅ 可重现构建
• ✅ 二进制可移植性
• ✅ 自包含工具链
• ✅ 无主机依赖

有关特定构建的问题或疑问，请参考每个镜像中嵌入的构建日志：/opt/toolchains/*/logs/。

---

最后更新: 2025-12-22
维护者: Daryl Tucker