180 lines
5.5 KiB
Markdown
180 lines
5.5 KiB
Markdown
# dev-sidecar
|
||
开发者边车，命名取自service-mesh的service-sidecar，意为为开发者打辅助的边车工具
|
||
通过本地代理的方式将http请求代理到一些国内的加速通道上
|
||
解决一些网站和库无法访问或访问速度慢的问题
|
||
|
||
|
||
## 特性
|
||
|
||
### 1、 github的release、source、zip下载加速
|
||
可解决npm install 时某些安装包下载不下来的问题
|
||
|
||
### 2、 dns优选
|
||
根据网络状况智能解析域名ip地址，获取最佳网络速度
|
||
比如：
|
||
1. 解决git push 偶尔失败需要输入账号密码的问题
|
||
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、安装与启动
|
||
```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`
|
||
```
|
||
依次点击安装证书->所有用户->将所有证书都放入下列存储->受信任的根证书颁发机构->确定，下一步，确定即可
|
||
|
||
|
||
|
||
Mac 用户安装根证书
|
||
```
|
||
sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain ~/.dev-sidecar/dev-sidecar.ca.crt
|
||
```
|
||
|
||
### 开始加速吧
|
||
去github上`Download ZIP`、`Release` 下载试试，体验秒下的感觉
|
||
|
||
比如去下载它： https://github.com/greper/d2-crud-plus/archive/master.zip
|
||
|
||
|
||
|
||
## 最佳实践
|
||
|
||
把dev-sidecar一直开着就行了
|
||
|
||
### 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的解析
|
||
#### 开启前vs 开启后
|
||
|
||
|
||
|
||
|
||
|
||
## 感谢
|
||
本项目使用lerna包管理工具
|
||
|
||
[](https://lerna.js.org/)
|
||
|
||
本项目参考如下开源项目
|
||
* [node-mitmproxy](https://github.com/wuchangming/node-mitmproxy)
|
||
* [ReplaceGoogleCDN](https://github.com/justjavac/ReplaceGoogleCDN)
|
||
|
||
本项目加速资源由如下组织提供
|
||
* [fastgit](https://fastgit.org/)
|