# dev-sidecar 开发者边车，命名取自service-mesh的service-sidecar，意为为开发者打辅助的边车工具 通过本地代理的方式将http请求代理到一些国内的加速通道上 不用`ss小飞机`也能解决一些网站和库无法访问或访问速度慢的问题 ## 特性 ### 1、 github的release、source、zip下载加速 可解决npm install 时某些安装包下载不下来的问题 ### 2、 dns优选 根据网络状况智能解析域名ip地址，获取最佳网络速度 比如： 1. 解决git push 偶尔失败需要输入账号密码的问题（fatal: TaskCanceledException encountered） 2. 解决github头像加载不出来的问题 3. 解决gist.github.com访问不到的问题 ### 3、 github的源代码查看（raw/blame查看） 通过跳转到国内加速链接上 ### 4、 Stack Overflow 加速 将ajax.google.com代理到加速CDN上 recaptcha 图片验证码加速 ### 5、 google cdn 加速 通过代理到加速链接上 ### 6、 更多加速配置 等你来提issue ## 快速开始 目前仅支持windows ### 1、 DevSidecar桌面应用发布啦 暂时只支持windows #### 1.1 下载安装包 [点此去下载](https://dev-sidecar.docmirror.cn/update/DevSidecar-1.0.2.exe) #### 1.2 安装根证书 第一次打开会提示安装根证书 #### 1.3 开始加速吧 去试试打开github `Download ZIP`、`Release` 下载试试，体验秒下的感觉 比如去下载它： https://github.com/greper/d2-crud-plus/archive/master.zip ![](./doc/index.png) #### 开启前vs 开启后 ![](./doc/avatar2.png) ![](./doc/avatar1.png) ### 2、命令行方式 此方式适用于nodejs开发者 1. 安装与启动 ```shell git clone https://gitee.com/docmirror/dev-sidecar.git cd ./dev-sidecar/packages/core npm install npm run start #或使用cnpm cnpm install npm run start #或使用yarn yarn install npm run start ``` 输出 ``` CA Cert saved in: C:\Users\Administrator\.dev-sidecar\dev-sidecar.ca.crt CA private key saved in: C:\Users\Administrator\.dev-sidecar\dev-sidecar.ca.key.pem dev-sidecar启动端口: 1181 代理已开启, 127.0.0.1 1181 ``` 启动后会自动设置系统代理、npm代理 2. 设置信任根证书 第一次启动时会本地随机生成一个根证书放在此目录下（由于此证书是本地随机生成的，所以信任它是安全的） ``` # 你的Home路径如果有修改，输出会不一样，请按照实际日志输出路径查看 CA Cert saved in: C:\Users\Administrator\.dev-sidecar\dev-sidecar.ca.crt ``` windows用户安装根证书 ``` start %HOMEPATH%/.dev-sidecar/dev-sidecar.ca.crt 或者 打开`C:\Users\Administrator\.dev-sidecar\`文件夹，双击`dev-sidecar.ca.crt` ``` 依次点击安装证书->所有用户->将所有证书都放入下列存储->受信任的根证书颁发机构->确定，下一步，确定即可 ![](./doc/setup.png) 3. 开始加速吧 去github上`Download ZIP`、`Release` 下载试试，体验秒下的感觉 比如去下载它： https://github.com/greper/d2-crud-plus/archive/master.zip ## 最佳实践 把dev-sidecar一直开着就行了 建议遇到打开比较慢的国外网站，可以优先尝试将该域名添加到dns设置中（注意：被GFW封杀的无效） 如果还访问不了，就需要寻找镜像cdn进行拦截代理 ### npm加速 1. yarn 设置淘宝镜像registry 2. npm设置官方registry。 3. 项目install使用yarn，发布包publish用npm，互不影响 4. 某些库用cnpm也下载不下来的话，可以试试打开dev-sidecar的npm加速 ### 其他加速 1. git clone 加速 > 使用方式用实际的名称替换{}的内容，即可加速clone > https://hub.fastgit.org/{username}/{reponame}.git > clone 出来的 remote "origin" 为fastgit的地址，需要手动改回来 > 你也可以直接使用他们的clone加速工具 [fgit-go](https://github.com/FastGitORG/fgit-go) 2. github.com的镜像网站(注意：不能登录) >1. [hub.fastgit.org](https://hub.fastgit.org/) >2. [github.com.cnpmjs.org](https://github.com.cnpmjs.org/) 这个很容易超限 ## api ### 拦截配置 没有配置域名的不会拦截，其他根据配置进行拦截处理 ```js const intercepts = { // 要拦截的域名 'github.com': { //需要拦截url的正则表达式 '/.*/.*/releases/download/': { //拦截类型 // redirect:url, 临时重定向(url会变，一些下载资源可以通过此方式配置) // proxy:url, 代理（url不会变，没有跨域问题） // abort:true, 取消请求（适用于被GFW封锁的资源，找不到替代，直接取消请求，快速失败，节省时间） 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' } }, 'clients*.google.com': { '.*':{ abort: true //取消请求，被GFW封锁的资源，找不到替代，直接取消请求，快速失败，节省时间 } } } ``` ### DNS优选 某些域名（比如api.github.com）会被解析到新加坡的ip上，新加坡的服务器在上午挺好，到了晚上就卡死，基本不可用。 所以将这些域名解析到美国服务器上就可以正常访问 另外，配置了dns mapping的域名，将会从dns获取到的ip列表中选择相对快一点的服务器进行访问 ```js dns: { mapping: { // 'api.github.com': 'usa', // "解决push的时候需要输入密码的问题", 'gist.github.com': 'usa' // 解决gist无法访问的问题 "*.githubusercontent.com": "usa" // 解决github头像经常下载不到的问题 } }, ``` 注意：暂时只支持IPv4的解析 ## 感谢 本项目使用lerna包管理工具 [![lerna](https://img.shields.io/badge/maintained%20with-lerna-cc00ff.svg)](https://lerna.js.org/) 本项目参考如下开源项目 * [node-mitmproxy](https://github.com/wuchangming/node-mitmproxy) * [ReplaceGoogleCDN](https://github.com/justjavac/ReplaceGoogleCDN) 本项目加速资源由如下组织提供 * [fastgit](https://fastgit.org/)