Ruby 官方镜像中的 YJIT 深度解析为什么 Rust 工具链装完就删【免费下载链接】rubyDocker Official Image packaging for Ruby项目地址: https://gitcode.com/gh_mirrors/ruby1/ruby你在使用 Docker 拉取ruby官方镜像时可能不知道里面藏着一个先装后删的神操作为了编译 YJIT JIT 编译器构建过程会临时安装一套完整的 Rust 工具链编译完成后又整个删掉。Ruby 官方镜像项目Docker Official Image packaging for Ruby正是通过Dockerfile.template这套模板为 3.3、3.4、4.0 三个大版本、六种基础镜像变体Debian/Alpine × 标准/slim统一生成构建脚本。这篇文章带你从零看懂YJIT 是什么、Rust 工具链为什么住在/tmp以及删掉它之后镜像为什么依然跑得飞快。YJIT 是什么Ruby 官方镜像为何要自带 JIT 先说结论YJIT 是 Ruby 官方内置的 JIT即时编译器用 Rust 语言编写。它会把频繁执行的 Ruby 代码编译成本地机器码让 Ruby 应用的性能明显提升——这也是为什么 Ruby 3.1 之后的镜像构建离不开 Rust。对新手来说只需要记住这条因果链Ruby 官方镜像不直接打包系统发行版的 Ruby而是从 ruby-lang.org 下载官方源码versions.json中锁定了每个版本的下载地址与 SHA256 校验值在容器里现场./configure make编译编译时加上--enable-yjitYJIT 就会被静态编译进 ruby 二进制文件而 YJIT 的代码是 Rust 写的所以构建期间必须有rustc/cargo可用。也就是说Rust 只是造 Ruby 的锤子不是用 Ruby 的钉子。临时 Rust 工地工具链是如何被安装和校验的打开任意一个生成的 Dockerfile例如3.4/bookworm/Dockerfile会发现所有 Rust 相关动作都集中在一个RUN块里围绕/tmp/rust展开按架构决定装不装脚本先用dpkg --print-architectureAlpine 变体则用apk --print-arch探测架构再查一张架构对照表。只有表里有对应的 Rust 目标平台rustArch变量才会被赋值装到 /tmp 而不是 /usr通过RUSTUP_HOME/tmp/rust/rustup和CARGO_HOME/tmp/rust/cargo两个环境变量把整套 rustup Rust 工具链都圈在/tmp/rust这个工地里并用--no-modify-path避免污染系统 PATH最小化安装rustup 以--profile minimal安装只带rustc和cargo不装文档、clippy、rustfmt 等一切nice to have双重校验下载的rustup-init和 Ruby 源码包都会先sha256sum --check --strict验签再执行。版本也是被焊死的可复现构建是官方镜像的底线Rust 工具链版本1.91.1、rustup 版本1.28.2都被锁定在versions.json和rust.json里每个架构的rustup-init都带独立 SHA256。这些元数据由versions.sh和rust.sh从上游抓取后生成再由apply-templates.sh把模板渲染成 18 份具体的 Dockerfile。关键一步拆解从源码编译到 YJIT 落地构建的核心流程可以概括为一句话校验源码 → 配置按需开启 YJIT→ 编译安装 → 拆除工地。配置阶段的精髓在这一行 shell 扩展${rustArch:--enable-yjit}。它的含义是如果rustArch非空就追加--enable-yjit——一个变量同时控制了装不装 Rust和开不开 YJIT两件事逻辑极其干净amd64 / arm64rustArch有值 → 下载 Rust、--enable-yjit最终镜像带 YJIT其他架构如 i386、ppc64le、s390xrustArch为空 → 整个安装分支被跳过一个字节都不下载 Rust镜像里没有 YJIT因为 YJIT 目前仅支持 x86-64 和 ARM64 两类 CPU。编译完成后make install把含 YJIT 的 ruby 装进/usr/local紧跟着就是那句点睛之笔rm -rf /tmp/rust。装完就删为什么 Rust 工具链不进最终镜像 这是全文最值得新手理解的设计决策原因有三体积省下数百 MB一套 rustup minimal 工具链解压后轻松超过 300 MB。Docker 镜像层是只追加的——如果装进/usr再想卸载只会多一层不会变小。把所有构建物圈在/tmp/rustrm -rf一次即可在同一层内抹掉痕迹slim 变体因此得以保持精瘦。最小运行时原则镜像里每多一个二进制就多一分攻击面和升级负担。构建产物YJIT已经以机器码形式嵌入 ruby 本体运行时根本不需要cargo。官方镜像的哲学是构建依赖绝不进入运行时。同样的思路还体现在构建结束后对 apt 包的purge --auto-remove清理以及 Alpine 变体里apk del删除全部构建依赖包。防污染的最后哨兵Dockerfile 结尾有一组自检dpkg -l | grep -i ruby若有输出直接exit 1并断言command -v ruby必须是/usr/local/bin/ruby——确保最终镜像里跑的 100% 是刚编译出来的那个 Ruby含 YJIT而不是系统包。哪些架构能用上 YJIT一张表看懂镜像架构是否安装 RustYJIT说明amd64✅glibc/musl 双版本✅服务器主力架构arm64v8✅glibc/musl 双版本✅Apple Silicon / ARM 服务器i386、ppc64le、s390x 等❌ 完全跳过❌无对应 YJIT 支持Alpinemusl libc变体会自动选用*-unknown-linux-musl的 Rust 目标平台Debian 变体则用*-unknown-linux-gnu——这套映射关系就写在Dockerfile.template的架构case分支里。进阶彩蛋4.0 镜像里的 ZJIT 如果你对照 3.4 和 4.0 的 Dockerfile会发现 4.0 多了一个--enable-zjit这是 Ruby 4.0 引入的实验性即时编译解释器 ZJIT与 YJIT 一样由 Rust 工具链编译。所以装完就删的 Rust 工地在 4.0 变体里其实服务了两个 JIT。新手常见问题 FAQQ1官方镜像里的 YJIT 默认开启吗Ruby 3.4 及以后含 4.0默认启用 YJIT3.3 默认关闭可通过环境变量RUBYOPT--jit开启。Q2我在 32 位 ARM 设备如老树莓派上跑 slim-bookworm为什么没有 YJIT只有 amd64/arm64 架构的镜像会编译 YJIT32 位 ARM 不在支持范围内——这也正是模板里rustArch留空的分支。Q3镜像里还能找到 Rust 的痕迹吗找不到的。/tmp/rust已被删除PATH 未被修改which cargo无结果。你获得的只是一个恰好内置了 JIT的干净 Ruby。Q4想自己玩这套构建流程克隆仓库查看完整的模板与生成脚本即可git clone https://gitcode.com/gh_mirrors/ruby1/ruby核心文件就五个Dockerfile.template灵魂、versions.shrust.sh采集版本元数据、versions.jsonrust.json锁版本、apply-templates.sh批量渲染。小结Ruby 官方镜像用一段不到百行的构建脚本演示了一个堪称教科书级的容器工程范式用临时目录 层内清理管理构建依赖、用 SHA256 锁死一切二进制、用架构探测把 JIT 精确投放到能受益的机器上。下次你再docker pull ruby时记住你拉到的不只是解释器还有一位住进 ruby 体内、而它的施工队已被清场的 Rust 编译器。【免费下载链接】rubyDocker Official Image packaging for Ruby项目地址: https://gitcode.com/gh_mirrors/ruby1/ruby创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Ruby 官方镜像中的 YJIT 深度解析为什么 Rust 工具链装完就删【免费下载链接】rubyDocker Official Image packaging for Ruby项目地址: https://gitcode.com/gh_mirrors/ruby1/ruby你在使用 Docker 拉取ruby官方镜像时可能不知道里面藏着一个先装后删的神操作为了编译 YJIT JIT 编译器构建过程会临时安装一套完整的 Rust 工具链编译完成后又整个删掉。Ruby 官方镜像项目Docker Official Image packaging for Ruby正是通过Dockerfile.template这套模板为 3.3、3.4、4.0 三个大版本、六种基础镜像变体Debian/Alpine × 标准/slim统一生成构建脚本。这篇文章带你从零看懂YJIT 是什么、Rust 工具链为什么住在/tmp以及删掉它之后镜像为什么依然跑得飞快。YJIT 是什么Ruby 官方镜像为何要自带 JIT 先说结论YJIT 是 Ruby 官方内置的 JIT即时编译器用 Rust 语言编写。它会把频繁执行的 Ruby 代码编译成本地机器码让 Ruby 应用的性能明显提升——这也是为什么 Ruby 3.1 之后的镜像构建离不开 Rust。对新手来说只需要记住这条因果链Ruby 官方镜像不直接打包系统发行版的 Ruby而是从 ruby-lang.org 下载官方源码versions.json中锁定了每个版本的下载地址与 SHA256 校验值在容器里现场./configure make编译编译时加上--enable-yjitYJIT 就会被静态编译进 ruby 二进制文件而 YJIT 的代码是 Rust 写的所以构建期间必须有rustc/cargo可用。也就是说Rust 只是造 Ruby 的锤子不是用 Ruby 的钉子。临时 Rust 工地工具链是如何被安装和校验的打开任意一个生成的 Dockerfile例如3.4/bookworm/Dockerfile会发现所有 Rust 相关动作都集中在一个RUN块里围绕/tmp/rust展开按架构决定装不装脚本先用dpkg --print-architectureAlpine 变体则用apk --print-arch探测架构再查一张架构对照表。只有表里有对应的 Rust 目标平台rustArch变量才会被赋值装到 /tmp 而不是 /usr通过RUSTUP_HOME/tmp/rust/rustup和CARGO_HOME/tmp/rust/cargo两个环境变量把整套 rustup Rust 工具链都圈在/tmp/rust这个工地里并用--no-modify-path避免污染系统 PATH最小化安装rustup 以--profile minimal安装只带rustc和cargo不装文档、clippy、rustfmt 等一切nice to have双重校验下载的rustup-init和 Ruby 源码包都会先sha256sum --check --strict验签再执行。版本也是被焊死的可复现构建是官方镜像的底线Rust 工具链版本1.91.1、rustup 版本1.28.2都被锁定在versions.json和rust.json里每个架构的rustup-init都带独立 SHA256。这些元数据由versions.sh和rust.sh从上游抓取后生成再由apply-templates.sh把模板渲染成 18 份具体的 Dockerfile。关键一步拆解从源码编译到 YJIT 落地构建的核心流程可以概括为一句话校验源码 → 配置按需开启 YJIT→ 编译安装 → 拆除工地。配置阶段的精髓在这一行 shell 扩展${rustArch:--enable-yjit}。它的含义是如果rustArch非空就追加--enable-yjit——一个变量同时控制了装不装 Rust和开不开 YJIT两件事逻辑极其干净amd64 / arm64rustArch有值 → 下载 Rust、--enable-yjit最终镜像带 YJIT其他架构如 i386、ppc64le、s390xrustArch为空 → 整个安装分支被跳过一个字节都不下载 Rust镜像里没有 YJIT因为 YJIT 目前仅支持 x86-64 和 ARM64 两类 CPU。编译完成后make install把含 YJIT 的 ruby 装进/usr/local紧跟着就是那句点睛之笔rm -rf /tmp/rust。装完就删为什么 Rust 工具链不进最终镜像 这是全文最值得新手理解的设计决策原因有三体积省下数百 MB一套 rustup minimal 工具链解压后轻松超过 300 MB。Docker 镜像层是只追加的——如果装进/usr再想卸载只会多一层不会变小。把所有构建物圈在/tmp/rustrm -rf一次即可在同一层内抹掉痕迹slim 变体因此得以保持精瘦。最小运行时原则镜像里每多一个二进制就多一分攻击面和升级负担。构建产物YJIT已经以机器码形式嵌入 ruby 本体运行时根本不需要cargo。官方镜像的哲学是构建依赖绝不进入运行时。同样的思路还体现在构建结束后对 apt 包的purge --auto-remove清理以及 Alpine 变体里apk del删除全部构建依赖包。防污染的最后哨兵Dockerfile 结尾有一组自检dpkg -l | grep -i ruby若有输出直接exit 1并断言command -v ruby必须是/usr/local/bin/ruby——确保最终镜像里跑的 100% 是刚编译出来的那个 Ruby含 YJIT而不是系统包。哪些架构能用上 YJIT一张表看懂镜像架构是否安装 RustYJIT说明amd64✅glibc/musl 双版本✅服务器主力架构arm64v8✅glibc/musl 双版本✅Apple Silicon / ARM 服务器i386、ppc64le、s390x 等❌ 完全跳过❌无对应 YJIT 支持Alpinemusl libc变体会自动选用*-unknown-linux-musl的 Rust 目标平台Debian 变体则用*-unknown-linux-gnu——这套映射关系就写在Dockerfile.template的架构case分支里。进阶彩蛋4.0 镜像里的 ZJIT 如果你对照 3.4 和 4.0 的 Dockerfile会发现 4.0 多了一个--enable-zjit这是 Ruby 4.0 引入的实验性即时编译解释器 ZJIT与 YJIT 一样由 Rust 工具链编译。所以装完就删的 Rust 工地在 4.0 变体里其实服务了两个 JIT。新手常见问题 FAQQ1官方镜像里的 YJIT 默认开启吗Ruby 3.4 及以后含 4.0默认启用 YJIT3.3 默认关闭可通过环境变量RUBYOPT--jit开启。Q2我在 32 位 ARM 设备如老树莓派上跑 slim-bookworm为什么没有 YJIT只有 amd64/arm64 架构的镜像会编译 YJIT32 位 ARM 不在支持范围内——这也正是模板里rustArch留空的分支。Q3镜像里还能找到 Rust 的痕迹吗找不到的。/tmp/rust已被删除PATH 未被修改which cargo无结果。你获得的只是一个恰好内置了 JIT的干净 Ruby。Q4想自己玩这套构建流程克隆仓库查看完整的模板与生成脚本即可git clone https://gitcode.com/gh_mirrors/ruby1/ruby核心文件就五个Dockerfile.template灵魂、versions.shrust.sh采集版本元数据、versions.jsonrust.json锁版本、apply-templates.sh批量渲染。小结Ruby 官方镜像用一段不到百行的构建脚本演示了一个堪称教科书级的容器工程范式用临时目录 层内清理管理构建依赖、用 SHA256 锁死一切二进制、用架构探测把 JIT 精确投放到能受益的机器上。下次你再docker pull ruby时记住你拉到的不只是解释器还有一位住进 ruby 体内、而它的施工队已被清场的 Rust 编译器。【免费下载链接】rubyDocker Official Image packaging for Ruby项目地址: https://gitcode.com/gh_mirrors/ruby1/ruby创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)
