{"id":26455408,"url":"https://github.com/rubymetric/rbenv-cn","last_synced_at":"2025-06-28T02:02:45.951Z","repository":{"id":216040793,"uuid":"740317993","full_name":"RubyMetric/rbenv-cn","owner":"RubyMetric","description":"💎 rbenv 国内一键安装工具","archived":false,"fork":false,"pushed_at":"2024-09-04T22:14:46.000Z","size":734,"stargazers_count":9,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-06-04T00:35:45.365Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RubyMetric.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"custom":["https://github.com/ccmywish/support-my-oss-work"]}},"created_at":"2024-01-08T05:11:42.000Z","updated_at":"2024-11-24T13:21:53.000Z","dependencies_parsed_at":null,"dependency_job_id":"e93b3499-bfb3-4cb0-968f-8fca59c59eed","html_url":"https://github.com/RubyMetric/rbenv-cn","commit_stats":null,"previous_names":["rubymetric/rbenv-cn"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/RubyMetric/rbenv-cn","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RubyMetric%2Frbenv-cn","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RubyMetric%2Frbenv-cn/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RubyMetric%2Frbenv-cn/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RubyMetric%2Frbenv-cn/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RubyMetric","download_url":"https://codeload.github.com/RubyMetric/rbenv-cn/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RubyMetric%2Frbenv-cn/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262362041,"owners_count":23299118,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-03-18T20:51:46.883Z","updated_at":"2025-06-28T02:02:45.945Z","avatar_url":"https://github.com/RubyMetric.png","language":"Shell","funding_links":["https://github.com/ccmywish/support-my-oss-work"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# rbenv-cn\n\n在国内网络环境下的类`Unix`系统上编译，安装，管理多版本`Ruby`\n\n无需使用任何外网环境（目前只支持`CRuby`, 而`mruby`,`JRuby`等不支持）\n\n\u003c/div\u003e\n\n## 功能\n\n支持`Bash`,`Zsh`，暂不支持`Fish`,`PowerShell`.\n\n1. 作为`rbenv` (包含`ruby-build`) 的国内一键安装与卸载脚本，安装仅需4秒\n2. `rbenv-cn`作为`rbenv`的一个标准插件，包含4个命令，功能为使用国内镜像\n3. `rbenv-cn` 解决的是 `Ruby` 自身的国内下载问题，而 `rubygems` 包的国内下载问题，可阅读最下方手动进行换源，或通过 [RubyMetric/chsrc] 全平台通用多软件自动测速换源\n\n\u003e **如果您长时间使用本项目，请考虑捐赠 (本页最下方)**\n\n\u003cbr\u003e\n\n## 镜像说明\n\n1. `rbenv` 由Gitee官方管理，每天更新。查看[最新状态](https://gitee.com/mirrors_rbenv/rbenv)\n\n2. `ruby-build` 由Gitee官方管理，每天更新，这是管理Ruby版本的真正仓库，所以不用担心更新不及时。查看[最新状态](https://gitee.com/mirrors/ruby-build)\n\n3. `ruby-build` 构建CRuby的过程使用的是 [Ruby China 社区](https://ruby-china.org/) 提供的镜像 [https://cache.ruby-china.com/](https://cache.ruby-china.com/)\n\n\u003cbr\u003e\n\n## 截图\n\n- `rbenv-cn` 安装过程,如图所示仅需4秒。\n\n![`rbenv-cn` 安装过程](./image/install.png)\n\n\u003cbr\u003e\n\n- `rbenv cninstall \u003cversion\u003e` 安装Ruby过程\n\n![`rbenv cninstall` 安装Ruby过程](./image/cninstall.png)\n\n\u003cbr\u003e\n\n## 安装\n\n如果你已经安装`Ruby`，可以简单地直接通过`gem`命令来安装\n```bash\n# 安装此 gem\ngem install rbenv-cn\n\n# 安装\nrbenv-cn install\n\n# 卸载\nrbenv-cn uninstall\n```\n\n若没有，则可以通过下面的安装脚本一键安装/卸载\n```shell\n# 安装\nbash -c \"$(curl -fsSL https://gitee.com/RubyMetric/rbenv-cn/raw/main/tool/install.sh)\"\n\n# 卸载\nbash -c \"$(curl -fsSL https://gitee.com/RubyMetric/rbenv-cn/raw/main/tool/uninstall.sh)\"\n```\n\n\u003cbr\u003e\n\n如果发现异常，可以使用以下两种方式检查:\n```bash\nrbenv doctor\n# 或\ncurl -fsSL https://gitee.com/RubyMetric/rbenv-cn/raw/main/bin/rbenv-doctor | bash\n```\n\n\u003cbr\u003e\n\n## 使用\n\n`ruby-build` 并不检查编译环境，需要手动先安装好。请先查看下方的编译依赖。\n[查看编译依赖](https://github.com/rbenv/ruby-build/wiki#suggested-build-environment)\n\n```bash\n# 在rbenv的基础上，可以调用三个子命令\n# 1. `rbenv cninstall`\n# 2. `rbenv update`\n# 3. `rbenv sudo`\n\n# 当有新Ruby版本出现时, 使用rbenv update来同时更新\n# rbenv 以及 ruby-build, rbenv-cn 在内的所有插件\nrbenv update\n\n# 查看支持的Ruby版本\nrbenv cninstall -l 或 -L\n\n# 此命令自动从Ruby China提供的镜像上下载某指定版本的Ruby并接着运行编译等过程\n# 该命令用来替换常见的 rbenv install 3.4.0-preview1\nrbenv cninstall 3.4.0-preview1\n\n# 设置全局使用 3.3.0 版本\nrbenv global 3.3.0\n\n# 生成 .ruby-version 文件，设置在本目录下使用 3.3.0 版本(会覆盖全局设置)\nrbenv local 3.3.0\n\n# sudo rails s -p 81 等需要更高权限的操作无法执行, 这是RVM和rbenv共同的问题\n# 因此需要使用以下命令来替换 sudo 即:\nrbenv sudo rails s -p 81\n\n```\n\n\u003cbr\u003e\n\n## Gem换源\n\n推荐使用C语言编写的全平台通用多软件换源工具 [RubyMetric/chsrc]\n\n![chsrc](https://gitee.com/RubyMetric/chsrc/raw/main/image/example.png)\n\n`chsrc` 将测速挑选最快镜像站，并自动执行下述命令：\n\n```bash\ngem source -r https://rubygems.org/\ngem source -a https://gems.ruby-china.com\nbundle config 'mirror.https://rubygems.org' 'https://gems.ruby-china.com'\n```\n\n\u003cbr\u003e\n\n[RubyMetric]: https://gitee.com/RubyMetric\n[RubyMetric/chsrc]: https://gitee.com/RubyMetric/chsrc\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frubymetric%2Frbenv-cn","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frubymetric%2Frbenv-cn","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frubymetric%2Frbenv-cn/lists"}