MIRROR HANDBOOK

RubyGems / Bundler 镜像

分别配置 gem 与 Bundler,保留 Gemfile 中的官方源声明。

配置前请确认服务与版本适用性,并备份原有软件源配置。

gem 配置

先运行 gem sources --list 记录原配置,备份 ~/.gemrc。使用 rubygems:

gem sources --add https://mirrors.cernet.edu.cn/rubygems/ --remove https://rubygems.org/
gem sources --list

私有 gem 源应保留;删除操作只针对示例中的官方公开源。

Bundler 镜像配置

Bundler 的设置独立于 gem sources。保持 Gemfile 的 source "https://rubygems.org",用本地镜像映射替换下载位置:

bundle config set --global mirror.https://rubygems.org https://mirrors.cernet.edu.cn/rubygems/
bundle config list

仅对当前项目生效时使用 --local 代替 --global。在项目目录执行 bundle install 验证;无需为换源删除 Gemfile.lock。

恢复

gem sources --add https://rubygems.org/ --remove https://mirrors.cernet.edu.cn/rubygems/
bundle config unset --global mirror.https://rubygems.org

若使用项目级设置,相应改为 --local。编译原生扩展失败可能是缺少编译器或开发库,与 gem 镜像无关。

参考资料

← 全部指南反馈文档问题 ↗