点击上方“咸鱼学Python”，选择“加为星标”

第一时间关注Python技术干货！

dev-sidecar

https://gitee.com/docmirror/dev-sidecar

开发者边车，命名取自service-mesh的service-sidecar，意为为开发者打辅助的边车工具
通过本地代理的方式将https请求代理到一些国内的加速通道上

特性

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

2、请求拦截

3、 github加速

release、source、zip下载加速
clone 加速
头像加速
解决readme中图片引用无法加载的问题
gist.github.com 加速
解决git push 偶尔失败需要输入账号密码的问题（fatal: TaskCanceledException encountered / fatal: HttpRequestException encountered）
raw/blame加速

4、 Stack Overflow 加速

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

5、 npm加速

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

开启前 vs 开启后

	开启前	开启后
头像
clone
zip 下载		秒下的，实在截不到速度的图

模式说明

安全模式

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

默认模式

此模式：开启拦截、关闭增强、开启dns优选、开启测速
需要安装证书
功能上包含特性1/2/3/4。

增强模式

此模式：开启拦截、开启增强、开启dns优选、关闭测速
需要安装证书
功能上包含特性1/2/3/4/5
由于敏感原因，默认关闭，感兴趣的可以私下交流

最佳实践

把dev-sidecar一直开着就行了
建议遇到打开比较慢的国外网站，可以尝试将该域名添加到dns设置中（注意：被GFW封杀的无效）
有时候安全模式打开github也挺快

其他加速

git clone 加速

方式1：快捷复制：

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

方式2：

使用方式用实际的名称替换{}的内容，即可加速clone
https://hub.fastgit.org/{username}/{reponame}.git
clone 出来的 remote "origin" 为fastgit的地址，需要手动改回来
你也可以直接使用他们的clone加速工具 fgit-go

github.com的镜像网站(注意：不能登录)

hub.fastgit.org
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'
      },
   },
   '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的前两个开关没有处于打开状态

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

如果是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开头的

本应用仅支持https加速请务必确认你访问的地址是https开头的比如：https://github.com/
检查浏览器是否装了什么插件，与ds有冲突
检查是否安装了其他代理软件，与ds有冲突
请确认浏览器的代理设置为使用IE代理/或者使用系统代理状态
可以尝试换个浏览器试试
请确认网络代理设置处于勾选状态
正常情况下dev-sidecar在“系统代理”开关打开时，会自动设置代理。

如何打开查看windows代理设置：

win10: 开始->设置->网络和Internet->最下方代理
win7: 开始->控制面板->网络和Internet->网络和共享中心->左下角Internet选项->连接选项卡->局域网设置

windows 代理查看

mac 代理查看

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

windows: 请确认证书已正确安装在“信任的根证书颁发机构”下
mac: 请确认证书已经被安装并已经设置信任。
火狐浏览器：火狐浏览器不走系统的根证书，需要在选项中添加根证书
1、火狐浏览器->选项->隐私与安全->证书->查看证书
2、证书颁发机构->导入
3、选择证书文件C:\Users\Administrator\.dev-sidecar\dev-sidecar.ca.crt（Mac为~/.dev-sidecar目录）
4、勾选信任由此证书颁发机构来标识网站，确定即可

4. 打开github显示连接超时

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

如果是安全模式，则是因为不稳定导致的，等一会再刷新试试
如果是默认模式/增强模式，则是由于访问人数过多，正常现象

5、查看日志是否有报错

如果还是不行，请在下方加作者好友，将服务日志发送给作者进行分析
日志打开方式：加速服务->右边日志按钮->打开日志文件夹

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

1、可以尝试关闭pac
2、可以将域名加入白名单，设置方式参考：https://github.com/docmirror/dev-sidecar/issues/25

7、 git push报错

当git push的数据大于200k时，会报错，目前的方案不太好解决。
临时方案：切到安全模式，尝试git push，多试几次就可以了。

贡献代码

开发调试模式启动

运行如下命令即可开发模式启动

git clone https://github.com/docmirror/dev-sidecar

cd dev-sidecar 

npm install lerna -g
lerna bootstrap

cd packages/gui

npm run electron

打包成可执行文件

cd packages/gui
npm run electron:build

提交pr

如果你想将你的修改贡献出来，请提交pr

对了，看完记得一键四连，这个对我真的很重要。

咸鱼的 Github 情报 | 加速！加速！加速！dev-sidecar 开发者边车（开发必备）