# chsrc **Repository Path**: q735213571/chsrc ## Basic Information - **Project Name**: chsrc - **Description**: chsrc 全平台通用换源工具. Change Source for every software on every platform from the command line. - **Primary Language**: C - **License**: MIT - **Default Branch**: main - **Homepage**: https://github.com/RubyMetric/chsrc - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 30 - **Created**: 2024-06-23 - **Last Updated**: 2024-06-23 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README
chsrc logo
Packaging status 全平台命令行换源工具，**目标支持 Linux (包括麒麟、openEuler、deepin 等), Windows, macOS, BSD 等尽可能多的操作系统，龙芯、飞腾、RISC-V 等尽可能多的 CPU**。 我们使用 **C99** 来完成上述目标。我们并不使用 Python 或 JS 等解释语言，因为一个简单的换源工具，不应该强行塞给用户一个庞大的解释器和数十、数百 MB 其他文件。 本软件为**自由软件**，SDPX 软件许可证为 `GPL-3.0-or-later and MIT`
## `chsrc` 的设计理念 1. **[No UFO](https://www.yuque.com/ccmywish/blog/no-ufo)** 我已经受够了各种软件在我的C盘或`$HOME`里给我塞一堆**零散**的不知名文件，它往往**连后缀都没有**，它的文件名足够隐晦以致于**你无论如何都猜不到是哪个软件在用它**。等你抱着好奇心打开一看，这竟然还是一种**自定义格式**。 好吧，对此我要创造一个新词：**UFO: Unidentified File Objects** `chsrc` 除了一个二进制文件外，别无他物。不会在你计算机的某个犄角旮旯里放一些莫名其妙的文件 2. **Convention over Configuration** 来自Ruby社区的优良传统。想想看: `/etc` 里每个文件都有一套自己的配置格式 我不想要有任何类似 `CHSRC_CONF` 的环境变量，也不想有任何类似 `.chsrc` 的配置文件 (**如果你是BSD用户，你会愤怒，因为你还存在一个叫作 `.cshrc` 的文件**)
## 示例
chsrc logo

## 需要你的帮助 如果你想要通过 `scoop`，`brew`，`yay` 等系统包管理工具来安装和更新`chsrc`，请帮助我们达到下面的要求。 - [ ] 缺乏 `AUR` 维护者 - [x] `homebrew` 维护者 - [ ] 缺乏 `scoop` 维护者 - [ ] `scoop` 要求英文输出 `chsrc`本意进行中文输出，但是我们将尽可能提供选项来进行英文输出。该选项同时有利于 BSD 用户 请访问 [chsrc on GitHub](https://github.com/RubyMetric/chsrc) 若您可提供维护，请访问 [issue#16 on GitHub](https://github.com/RubyMetric/chsrc/issues/16)
## 安装 以下方式均下载到当前目录，可直接通过 `./chsrc` 运行。 ### Windows ```bash # x64 curl -L https://gitee.com/RubyMetric/chsrc/releases/download/pre/chsrc-x64-windows.exe -o chsrc.exe # x86 curl -L https://gitee.com/RubyMetric/chsrc/releases/download/pre/chsrc-x86-windows.exe -o chsrc.exe ``` ### Linux ```bash # 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 ``` ### macOS 可以通过 `homebrew` 安装，感谢 [@Aaron-212](https://github.com/Aaron-212) 与 [@chenrui333](https://github.com/chenrui333) ```bash brew install chsrc ``` 或手动下载二进制文件 (最新版，有时比 `homebrew` 提供的更新) ```bash # M1/aarch64 curl -L https://gitee.com/RubyMetric/chsrc/releases/download/pre/chsrc-aarch64-macos -o chsrc; chmod +x ./chsrc # x64 curl -L https://gitee.com/RubyMetric/chsrc/releases/download/pre/chsrc-x64-macos -o chsrc; chmod +x ./chsrc ``` ### BSD ```bash git clone https://gitee.com/RubyMetric/chsrc.git; cd chsrc clang -Iinclude src/chsrc.c -o chsrc ``` ### 其他平台 ```bash git clone https://gitee.com/RubyMetric/chsrc.git; cd chsrc; make ```
## 使用 ```bash 使用: chsrc [options] [target] [mirror] help # 打印此帮助，或 h, -h, --help issue # 查看相关issue list (或 ls, 或 l) # 列出可用镜像源，和可换源软件 list mirror/target # 列出可用镜像源，或可换源软件 list os/lang/ware # 列出可换源的操作系统/编程语言/软件 list # 查看该软件可以使用哪些源 cesu # 对该软件所有源测速 get # 查看当前软件的源使用情况 set # 换源，自动测速后挑选最快源 set first # 换源，使用维护团队测速第一的源 set # 换源，指定使用某镜像站 (通过list命令查看) set https://abc # 换源，用户自定义源URL reset # 重置，使用上游默认使用的源 选项: -ipv6 # 使用IPv6测速 -local # 仅对某项目而非全局换源 (仅部分软件如bundler,pdm支持) ``` 当你**不想自动测速的时候**，你可以直接指定某镜像站，源URL，以及指定维护团队已测试的最快镜像站。 ```bash chsrc set ruby # 测速，寻找最快者，换源 # 或 chsrc ls ruby # 列出可用的镜像站 chsrc set ruby rubychina # 使用 RubyChina 作为镜像站 # 或您有自己的镜像地址 chsrc set ruby https://gems.ruby-china.com/ # 使用自定义URL # 或 chsrc set ruby first # 使用维护团队测试的最快镜像站 ``` 对部分[支持局部换源](https://gitee.com/RubyMetric/chsrc/issues/I9V5I0)的，可以避免全局换源。 ```bash chsrc set -local bundler chsrc set -local pdm ```
## 编程语言开发 ```bash chsrc set ruby 或 set gem chsrc set python 或 set pip / pdm # 同时换pip和pdm chsrc set node 或 set npm / nodejs / yarn / pnpm # 同时换3个 chsrc set perl 或 set cpan chsrc set php 或 set composer chsrc set lua 或 set luarocks chsrc set go chsrc set rust 或 set cargo / crate chsrc set java 或 set maven / mvn / gradle chsrc set clojure 或 set clojars chsrc set dart 或 set pub / flutter # 同时会为flutter换源 chsrc set haskell 或 set hackage/cabal/stack chsrc set ocaml 或 set opam # 同时会为 bioconductor 换源 chsrc set r 或 set cran chsrc set julia ```
## 操作系统 ```bash sudo chsrc set ubuntu sudo chsrc set mint 或 linuxmint sudo chsrc set debian sudo chsrc set fedora sudo chsrc set suse 或 set opensuse sudo chsrc set kali sudo chsrc set arch # 同时使用 archlinuxcn sudo chsrc set manjaro sudo chsrc set gentoo sudo chsrc set rocky 或 set rockylinux sudo chsrc set alma 或 set almalinux sudo chsrc set alpine sudo chsrc set void 或 set voidlinux sudo chsrc set solus sudo chsrc set ros 或 set ros2 sudo chsrc set trisquel sudo chsrc set lite 或 set linuxlite sudo chsrc set raspi 或 set raspberrypi sudo chsrc set armbian sudo chsrc set euler 或 set openeuler sudo chsrc set anolis 或 set openanolis sudo chsrc set kylin 或 set openkylin sudo chsrc set deepin chsrc set msys2 或 set msys # BSD sudo chsrc set freebsd sudo chsrc set openbsd sudo chsrc set netbsd ```
## 软件 ```bash chsrc set winget chsrc set brew 或 set homebrew chsrc set cocoapods 或 set cocoa / pod chsrc set dockerhub 或 set docker chsrc set flathub chsrc set nix chsrc set guix chsrc set emacs 或 set elpa chsrc set tex 或 set ctan / latex / texlive / miktex chsrc set conda 或 set anaconda ```
## 开发 请安装好 `gcc`或`clang` 和 `make` 以及 `curl` ```bash # 使用 dev 分支开发 git clone https://gitee.com/RubyMetric/chsrc.git -b dev make # 默认使用 cc 编译 make CC=clang # 使用 clang 编译 make CC=gcc # 使用 gcc 编译 make test # 测试命令 make test-xy # 测试 xy.h make clean ```
## 许可证 - `chsrc` 主程序采用 `GPL-3.0-or-later` 许可证，保证该软件的永久自由 - `xy.h` 使用 `MIT` 许可证，保证该库可以在尽可能多的情况下复用
## 致谢 感谢各个镜像站提供的优质免费镜像服务，使用的镜像站见 [source.h](./include/source.h). 另外感谢以下项目: 1. [MirrorZ 教育网镜像站](https://help.mirrors.cernet.edu.cn/) 2. [清华大学 Tuna](https://mirrors.tuna.tsinghua.edu.cn/) 3. [Thanks Mirror 项目](https://github.com/eryajf/Thanks-Mirror) by [@eryajf](https://github.com/eryajf)