工具分享（一）
2022-03-12 22:13:08 # 工具篇

分享一款可以自由访问 Github 以及自由更换 npm 源的工具，以下内容取自作者 README 的描述，本人只做分享。

项目地址：https://gitee.com/docmirror/dev-sidecar

dev-sidecar

开发者边车，命名取自 service-mesh 的 service-sidecar，意为为开发者打辅助的边车工具（以下简称 ds）

通过本地代理的方式将 https 请求代理到一些国内的加速通道上

——————————重要提醒 1———————————

注意：由于 electron 无法监听 windows 的关机事件，开着 ds 情况下直接重启电脑，会导致无法上网，你可以手动启动 ds 即可恢复网络，你也可以将 ds 设置为开机自启。

——————————重要提醒 2———————————

注意：本应用启动会自动修改系统代理，所以会与其他 vpn、fq 等代理软件有冲突，请务必不要一起使用。

本应用主要目的在于直连访问 github，如果你已经有飞机了，那建议还是不要用这个自行车（ds）了

一、 特性

1、 dns 优选（解决***污染问题）

  • 根据网络状况智能解析最佳域名 ip 地址，获取最佳网络速度
  • 解决一些网站和库无法访问或访问速度慢的问题
  • 建议遇到打开比较慢的国外网站，可以优先尝试将该域名添加到 dns 设置中（注意：被***封杀的无效）

2、 请求拦截

  • 拦截打不开的网站，代理到加速镜像站点上去。
  • 可配置多个镜像站作为备份
  • 具备测速机制，当访问失败或超时之后，自动切换到备用站点，使得目标服务高可用

3、 github 加速

  • github 直连加速 (通过修改 sni 实现，感谢 fastGithub 提供的思路)
  • release、source、zip 下载加速
  • clone 加速
  • 头像加速
  • 解决 readme 中图片引用无法加载的问题
  • gist.github.com 加速
  • 解决 git push 偶尔失败需要输入账号密码的问题（fatal: TaskCanceledException encountered  /  fatal: HttpRequestException encountered）
  • raw/blame 加速

以上部分功能通过X.I.U的油猴脚本实现， 以下是仓库和脚本下载链接，大家可以去支持一下。

由于此脚本在 ds 中是打包在本地的，更新会不及时，你可以直接通过浏览器安装油猴插件使用此脚本，从而获得最新更新（ds 本地的可以通过加速服务->基本设置->启用脚本进行关闭）。

4、 Stack Overflow 加速

  • 将 ajax.google.com 代理到加速 CDN 上
  • recaptcha 图片验证码加速

5、 npm 加速

  • 支持开启 npm 代理
  • 官方与淘宝 npm registry 一键切换,
  • 某些 npm install 的时候，并且使用 cnpm 也无法安装时，可以尝试开启 npm 代理再试

安全警告：

  • 请勿使用来源不明的服务地址，有隐私和账号泄露风险
  • 本应用及服务端承诺不收集任何信息。介意者请使用安全模式。

二、快速开始

支持 windows、Mac、Linux(Ubuntu)

DevSidecar 桌面应用

1 下载安装包

  • release 下载

Gitee Release

Github Release

Windows: 请选择 DevSidecar-x.x.x.exe

Mac: 请选择 DevSidecar-x.x.x.dmg

Ubuntu: 请选择 DevSidecar-x.x.x.deb

其他 linux: 请选择 DevSidecar-x.x.x.AppImage (未做测试，不保证能用)

linux 安装说明请参考 linux 安装文档

注意：由于没有买应用证书，所以应用在下载安装时会有“未知发行者”等安全提示，选择保留即可。

2 安装后打开

注意：mac 版安装需要在“系统偏好设置->安全性与隐私->通用”中解锁并允许应用安装

3 安装根证书

第一次打开会提示安装证书，根据提示操作即可

根证书是本地随机生成的，所以不用担心根证书的安全问题（本应用不收集任何用户信息）

你也可以在加速服务设置中自定义根证书（PEM 格式的证书与私钥）

火狐浏览器需要手动安装证书

4 开始加速吧

去试试打开 github

三、模式说明

安全模式

  • 此模式：关闭拦截、关闭增强、开启 dns 优选、开启测速
  • 最安全，无需安装证书，可以在浏览器地址栏左侧查看域名证书
  • 功能也最弱，只有特性 1，相当于查询 github 的国外 ip，手动改 hosts 一个意思。
  • github 的可访问性不稳定，取决于 IP 测速，如果有绿色 ip 存在，就 有可能 可以直连访问。

默认模式

  • 此模式：开启拦截、关闭增强、开启 dns 优选、开启测速
  • 需要安装证书，通过修改 sni 直连访问 github
  • 功能上包含特性 1/2/3/4。

四、 最佳实践

  • 把 dev-sidecar 一直开着就行了（注意 windows 下开着 ds 重启电脑，会无法上网，重新打开 ds 即可。）
  • 建议遇到打开比较慢的国外网站，可以尝试将该域名添加到 dns 设置中（注意：被 GFW 封杀的无效）

其他加速

  1. git clone 加速

方式 1：快捷复制：

开启脚本支持，然后在复制 clone 链接下方，即可复制到加速链接

方式 2：

使用方式用实际的名称替换{}的内容，即可加速 clone

https://hub.fastgit.org/{username}/{reponame}.git

clone 出来的 remote “origin” 为 fastgit 的地址，需要手动改回来

你也可以直接使用他们的 clone 加速工具 fgit-go

  1. github.com 的镜像网站(注意：不能登录)
  1. hub.fastgit.org
  2. github.com.cnpmjs.org 这个很容易超限

五、api

拦截配置

没有配置域名的不会拦截，其他根据配置进行拦截处理

const intercepts = {
  // 要拦截的域名
  "github.com": {
    //需要拦截url的正则表达式
    "/.*/.*/releases/download/": {
      //拦截类型
      // redirect:url,  临时重定向(url会变，一些下载资源可以通过此方式配置)
      // proxy:url,     代理（url不会变，没有跨域问题）
      // abort:true,    取消请求（适用于被GFW封锁的资源，找不到替代，直接取消请求，快速失败，节省时间）
      // success:true,  直接返回成功请求（某些请求不想发出去，可以伪装成功返回）
      redirect: "download.fastgit.org",
    },
    ".*": {
      proxy: "github.com",
      sni: "baidu.com", //修改sni，规避***握手拦截
    },
  },
  "ajax.googleapis.com": {
    ".*": {
      proxy: "ajax.loli.net", //代理请求，url不会变
      backup: ["ajax.proxy.ustclug.org"], //备份，当前代理请求失败后，将会切换到备用地址
      test: "ajax.googleapis.com/ajax/libs/jquery/1.12.4/jquery.min.js",
      replace: "/(.*)/xxx", //当加速地址的链接和原链接不是完全相同时，可以通过正则表达式replace，此时proxy通过$1$2来重组url， proxy:'ajax.loli.net/xxx/$1'
    },
  },
  "clients*.google.com": {
    ".*": {
      abort: true, //取消请求，被GFW封锁的资源，找不到替代，直接取消请求，快速失败，节省时间
    },
  },
};

DNS 优选配置

某些域名解析出来的 ip 会无法访问，（比如 api.github.com 会被解析到新加坡的 ip 上，新加坡的服务器在上午挺好，到了晚上就卡死，基本不可用）

通过从 dns 上获取 ip 列表，切换不同的 ip 进行尝试，最终会挑选到一个最快的 ip

dns: {
   mapping: {
     //
     'api.github.com': 'usa', // "解决push的时候需要输入密码的问题",
     'gist.github.com': 'usa' // 解决gist无法访问的问题
     "*.githubusercontent.com": "usa" // 解决github头像经常下载不到的问题
   }
 },

注意：暂时只支持 IPv4 的解析

六、问题排查

1、dev-sidecar 的前两个开关没有处于打开状态

  1. 尝试将开关按钮手动打开
  2. 请尝试右键 dev-sidecar 图标，点退出。再重新打开
  3. 如果还不行，请将日志发送给作者

如果是 mac 系统，可能是下面的原因

Mac 系统使用时，首页的系统代理开关无法打开

出现这个问题可能是没有开启系统代理命令的执行权限

networksetup -setwebproxy 'WiFi' 127.0.0.1 1181
#看是否有如下错误提示
** Error: Command requires admin privileges.

如果有上面的错误提示，请尝试如下两种方法：

1、 取消访问偏好设置需要管理员密码

系统偏好设置—>安全性与隐私—> 通用—> 高级—> 访问系统范围的偏好设置需要输入管理员密码（取消勾选）

2、 可能是由于安装了 xcode，但未授权导致

请在终端输入如下命令进行授权

sudo xcodebuild -license
# 一直按回车，该agree的时候输入agree即可

然后再次尝试看是否能够打开系统代理开关

如果还不行，请联系作者

2、没有加速效果

本应用仅支持 https 加速，请务必确认你访问的网站地址是 https 开头的

  1. 本应用仅支持 https 加速

请务必确认你访问的地址是 https 开头的

比如： https://github.com/

  1. 检查浏览器是否装了什么插件，与 ds 有冲突

  2. 检查是否安装了其他代理软件，与 ds 有冲突

  3. 请确认浏览器的代理设置为使用 IE 代理/或者使用系统代理状态

  4. 可以尝试换个浏览器试试

  5. 请确认网络代理设置处于勾选状态

正常情况下 dev-sidecar 在“系统代理”开关打开时，会自动设置代理。

3、浏览器打开提示证书不受信任

  • windows: 请确认证书已正确安装在“信任的根证书颁发机构”下

  • mac: 请确认证书已经被安装并已经设置信任。

  • 火狐浏览器：火狐浏览器不走系统的根证书，需要在选项中添加根证书

1、火狐浏览器->选项->隐私与安全->证书->查看证书

2、证书颁发机构->导入

3、选择证书文件C:\Users(用户)\Administrator(你的账号)\.dev-sidecar\dev-sidecar.ca.crt（Mac 或 linux 为~/.dev-sidecar目录）

4、勾选信任由此证书颁发机构来标识网站，确定即可

4. 打开 github 显示连接超时

DevSidecar Warning: Error: www.github.com:443, 代理请求超时

如果是安全模式，则是因为不稳定导致的，等一会再刷新试试

如果是增强模式，则是由于访问人数过多，正常现象

5、某些原本可以打开的网站打不开了

1、可以尝试关闭 pac

2、可以将域名加入白名单

6、应用意外关闭导致没有网络了

应用开启后会自动修改系统代理设置，正常退出会自动关闭系统代理

当应用意外关闭时，可能会因为没有将系统代理恢复，从而导致完全无法上网。

对于此问题有如下几种解决方案可供选择：

1、重新打开应用即可（右键应用托盘图标可完全退出，将会正常关闭系统代理设置）

2、如果应用被卸载了，此时需要手动关闭系统代理设置

3、如果你是因为开着 ds 的情况下重启电脑导致无法上网，你可以设置 ds 为开机自启

7、卸载应用后上不了网，git 请求不了

如果你在卸载应用前，没有正常退出 app，就有可能无法上网。请按如下步骤操作恢复您的网络：

1、关闭系统代理设置，参见：手动关闭系统代理设置

2、执行下面的命令关闭 git 的代理设置(如果你开启过 git.ext 的开关)

git config --global --unset http.proxy
git config --global --unset https.proxy

3、执行下面的命令关闭 npm 的代理设置(如果你开启过 npm 加速的开关)

npm config delete proxy
npm config delete https-proxy
上一页
2022-03-12 22:13:08 # 工具篇
下一页