[TOC] > [github](https://github.com/RubyMetric/chsrc) ## 概述 全平台通用换源工具与框架 chsrc，目标支持 Linux, Windows (MSYS2, Cygwin), macOS, BSD 等尽可能多的操作系统环境，龙芯、飞腾、RISC-V 等尽可能多的 CPU。 特点 - 可支持操作系统的源 - 可支持编程语言的源 ## 安装 ### window ``` curl -L https://gitee.com/RubyMetric/chsrc/releases/download/pre/chsrc-x64-windows.exe -o chsrc.exe ``` ### linux ``` # x64 curl -L https://gitee.com/RubyMetric/chsrc/releases/download/pre/chsrc-x64-linux -o chsrc; chmod +x ./chsrc # aarch64 curl -L https://gitee.com/RubyMetric/chsrc/releases/download/pre/chsrc-aarch64-linux -o chsrc; chmod +x ./chsrc # riscv64 curl -L https://gitee.com/RubyMetric/chsrc/releases/download/pre/chsrc-riscv64-linux -o chsrc; chmod +x ./chsrc # armv7 curl -L https://gitee.com/RubyMetric/chsrc/releases/download/pre/chsrc-armv7-linux -o chsrc; chmod +x ./chsrc ``` ## 语法 ``` 使用: chsrc <command> [options] [target] [mirror] help # 打印此帮助，或 h, -h, --help issue # 查看相关issue list (或 ls, 或 l) # 列出可用镜像源，和可换源目标 list mirror/target # 列出可用镜像源，或可换源目标 list os/lang/ware # 列出可换源的操作系统/编程语言/软件 measure <target> # 对该目标所有源测速 cesu <target> list <target> # 查看该目标可用源与支持功能 get <target> # 查看该目标当前源的使用情况 set <target> # 换源，自动测速后挑选最快源 set <target> first # 换源，使用维护团队测速第一的源 set <target> <mirror> # 换源，指定使用某镜像站 (通过list命令查看) set <target> https://url # 换源，用户自定义源URL reset <target> # 重置，使用上游默认使用的源 选项: -dry # Dry Run，模拟换源过程，命令仅打印并不运行 -local # 仅对某项目而非全局换源 (仅部分软件如bundler,pdm支持) -ipv6 # 使用IPv6测速 -en(glish) # 使用英文输出 -no-color # 无颜色输出 ``` ## 示例 自动测速，寻找最快者，换源 ``` $ chsrc set ruby ``` 不想自动测速的时候，可使用维护团队测试的最快镜像站 ``` $ chsrc set ruby first ``` 先列出可用的镜像站，然后选择其一，如使用 RubyChina 作为镜像站 ``` $ chsrc ls ruby $ chsrc set ruby rubychina ``` 若您有自己的镜像地址，使用自定义URL ``` $ chsrc set ruby https://gems.ruby-china.com/ ``` 对支持 *项目级* 换源的目标，可以避免全局（*系统级* 或 *用户级*）换源 ``` $ chsrc set -local bundler $ chsrc set -local pdm ```