Repolode
RubyMetric

RubyMetric/chsrc

一款命令行工具,可一键为多种编程语言、包管理器和操作系统切换到更快的国内镜像源。

Star
6,909
Fork
283
未关闭 Issue
25
最近提交
前天

这是什么?

chsrc 是一款跨平台命令行工具,用于切换编程语言包管理器、操作系统软件仓库以及部分其他软件的源(镜像站)。执行 `chsrc set node` 这类命令即可自动测速并切换到最快的镜像,也可以手动指定某个镜像站或自定义 URL。

它覆盖的范围较广,包括 npm、pip、cargo、Maven、Ubuntu、Debian、Fedora、Arch Linux、Homebrew、Docker Hub、Flathub 等,支持 Linux、Windows、macOS、BSD 以及 Android/Termux,并兼容多种 CPU 架构。部分工具支持仅对当前项目换源而不影响全局配置,dry-run 模式则可以只打印将要执行的命令而不实际运行。

项目同时是一个用 C11 编写、采用 MVC 思想的换源框架,每种换源方法以 recipe 的形式实现,贡献者无需精通 C 语言也能编写新的 recipe。

核心功能

  • 01通过 `chsrc set <菜品>` 自动测速并切换到最快镜像。
  • 02支持 npm、pip、cargo、Maven、Go 等语言包管理器。
  • 03支持 Ubuntu、Debian、Fedora、Arch、Termux 等操作系统软件源。
  • 04部分工具支持仅对当前项目换源,不影响全局配置。
  • 05提供 dry-run 模式,只打印命令而不实际执行。

适用场景

  • 在中国大陆的新设备上加快依赖包和系统软件的下载速度。
  • 用同一个工具统一配置多种语言工具链和 Linux 发行版。
  • 只为某个项目切换包管理器镜像,不影响系统全局设置。
  • 为内部或自建镜像站编写自定义 recipe。

快速上手

  1. 1

    通过 Homebrew 安装(macOS)

    brew install chsrc
  2. 2

    通过 Scoop 安装(Windows)

    scoop install chsrc
  3. 3

    通过 WinGet 安装(Windows)

    winget install RubyMetric.chsrc
  4. 4

    运行 chsrc,自动测速并切换某个包管理器的源(例如 Ruby)

    chsrc set ruby

使用前须知

  • 换源会修改全局配置,可先用 -dry 预览,或在支持时使用 -scope=project 限定到项目。
  • 部分平台如 FreeBSD 的换源方法存在已知问题,部分 CPU 架构没有预编译版本。

收录于专题

标签

常见问题

chsrc 是什么?
一款命令行工具,可一键为多种编程语言、包管理器和操作系统切换到更快的国内镜像源。 chsrc 是一款跨平台命令行工具,用于切换编程语言包管理器、操作系统软件仓库以及部分其他软件的源(镜像站)。执行 `chsrc set node` 这类命令即可自动测速并切换到最快的镜像,也可以手动指定某个镜像站或自定义 URL。
chsrc 可以免费使用吗?用的什么许可证?
chsrc 以 GPL-3.0 许可证开源。用于商业产品前,请先确认许可证条款。
chsrc 还在维护吗?
活跃维护中。chsrc 最近一次提交是在 2026年10月23日。
chsrc 适合用来做什么?
在中国大陆的新设备上加快依赖包和系统软件的下载速度。 用同一个工具统一配置多种语言工具链和 Linux 发行版。 只为某个项目切换包管理器镜像,不影响系统全局设置。 为内部或自建镜像站编写自定义 recipe。
chsrc 怎么安装和运行?
通过 Homebrew 安装(macOS): brew install chsrc 通过 Scoop 安装(Windows): scoop install chsrc 通过 WinGet 安装(Windows): winget install RubyMetric.chsrc 运行 chsrc,自动测速并切换某个包管理器的源(例如 Ruby): chsrc set ruby
在哪里获取 chsrc?
源代码和安装说明在 GitHub 上:https://github.com/RubyMetric/chsrc

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目