點擊上方“咸魚學(xué)Python”，選擇“加為星標(biāo)”

第一時間關(guān)注Python技術(shù)干貨！

dev-sidecar

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

開發(fā)者邊車，命名取自service-mesh的service-sidecar，意為為開發(fā)者打輔助的邊車工具
通過本地代理的方式將https請求代理到一些國內(nèi)的加速通道上

特性

1、 dns優(yōu)選（解決***污染問題）

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 下載		秒下的，實在截不到速度的圖

模式說明

安全模式

此模式：關(guān)閉攔截、關(guān)閉增強、開啟dns優(yōu)選、開啟測速
最安全，無需安裝證書，可以在瀏覽器地址欄左側(cè)查看域名證書
功能也最弱，只有特性1，相當(dāng)于查詢github的國外ip，手動改hosts一個意思。
github的可訪問性不穩(wěn)定，取決于IP測速，如果有綠色ip存在，就 有可能 可以直連訪問。

默認(rèn)模式

此模式：開啟攔截、關(guān)閉增強、開啟dns優(yōu)選、開啟測速
需要安裝證書
功能上包含特性1/2/3/4。

增強模式

此模式：開啟攔截、開啟增強、開啟dns優(yōu)選、關(guān)閉測速
需要安裝證書
功能上包含特性1/2/3/4/5
由于敏感原因，默認(rèn)關(guān)閉，感興趣的可以私下交流

最佳實踐

把dev-sidecar一直開著就行了
建議遇到打開比較慢的國外網(wǎng)站，可以嘗試將該域名添加到dns設(shè)置中（注意：被GFW封殺的無效）
有時候安全模式打開github也挺快

其他加速

git clone 加速

方式1：快捷復(fù)制：

開啟腳本支持，然后在復(fù)制clone鏈接下方，即可復(fù)制到加速鏈接

方式2：

使用方式用實際的名稱替換{}的內(nèi)容，即可加速clone
https://hub.fastgit.org/{username}/{reponame}.git
clone 出來的 remote "origin" 為fastgit的地址，需要手動改回來
你也可以直接使用他們的clone加速工具 fgit-go

github.com的鏡像網(wǎng)站(注意：不能登錄)

hub.fastgit.org
github.com.cnpmjs.org 這個很容易超限

api

攔截配置

沒有配置域名的不會攔截，其他根據(jù)配置進(jìn)行攔截處理

const intercepts = {
  // 要攔截的域名
  'github.com': {
     //需要攔截url的正則表達(dá)式
     '/.*/.*/releases/download/': {
        //攔截類型
        // redirect:url,  臨時重定向(url會變，一些下載資源可以通過此方式配置)
        // proxy:url,     代理（url不會變，沒有跨域問題）
        // abort:true,    取消請求（適用于被GFW封鎖的資源，找不到替代，直接取消請求，快速失敗，節(jié)省時間）
        // success:true,  直接返回成功請求（某些請求不想發(fā)出去，可以偽裝成功返回）
        redirect: 'download.fastgit.org'
      },
   },
   'ajax.googleapis.com': {
     '.*': {
       proxy: 'ajax.loli.net', //代理請求，url不會變
       backup: ['ajax.proxy.ustclug.org'], //備份，當(dāng)前代理請求失敗后，將會切換到備用地址
       test: 'ajax.googleapis.com/ajax/libs/jquery/1.12.4/jquery.min.js',
       replace:'/(.*)/xxx'//當(dāng)加速地址的鏈接和原鏈接不是完全相同時，可以通過正則表達(dá)式replace，此時proxy通過$1$2來重組url， proxy:'ajax.loli.net/xxx/$1'
     }
   },
   'clients*.google.com': {
      '.*':{
        abort: true //取消請求，被GFW封鎖的資源，找不到替代，直接取消請求，快速失敗，節(jié)省時間
      }
    }       
}

DNS優(yōu)選配置

某些域名解析出來的ip會無法訪問，（比如api.github.com會被解析到新加坡的ip上，新加坡的服務(wù)器在上午挺好，到了晚上就卡死，基本不可用）
通過從dns上獲取ip列表，切換不同的ip進(jìn)行嘗試，最終會挑選到一個最快的ip

 dns: {
    mapping: {
      //
      'api.github.com': 'usa', // "解決push的時候需要輸入密碼的問題",
      'gist.github.com': 'usa' // 解決gist無法訪問的問題
      "*.githubusercontent.com": "usa" // 解決github頭像經(jīng)常下載不到的問題
    }
  },

注意：暫時只支持IPv4的解析

問題排查

1、dev-sidecar的前兩個開關(guān)沒有處于打開狀態(tài)

嘗試將開關(guān)按鈕手動打開
請嘗試右鍵dev-sidecar圖標(biāo)，點退出。再重新打開
如果還不行，請將日志發(fā)送給作者

如果是mac系統(tǒng)，可能是下面的原因

Mac系統(tǒng)使用時，首頁的系統(tǒng)代理開關(guān)無法打開

出現(xiàn)這個問題可能是沒有開啟系統(tǒng)代理命令的執(zhí)行權(quán)限

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

如果有上面的錯誤提示，請嘗試如下兩種方法：

1、取消訪問偏好設(shè)置需要管理員密碼系統(tǒng)偏好設(shè)置—>安全性與隱私—> 通用—> 高級—> 訪問系統(tǒng)范圍的偏好設(shè)置需要輸入管理員密碼（取消勾選）

2、可能是由于安裝了xcode，但未授權(quán)導(dǎo)致請在終端輸入如下命令進(jìn)行授權(quán)

sudo xcodebuild -license
# 一直按回車，該agree的時候輸入agree即可

然后再次嘗試看是否能夠打開系統(tǒng)代理開關(guān)
如果還不行，請聯(lián)系作者

2、沒有加速效果

本應(yīng)用僅支持https加速，請務(wù)必確認(rèn)你訪問的網(wǎng)站地址是https開頭的

本應(yīng)用僅支持https加速請務(wù)必確認(rèn)你訪問的地址是https開頭的比如：https://github.com/
檢查瀏覽器是否裝了什么插件，與ds有沖突
檢查是否安裝了其他代理軟件，與ds有沖突
請確認(rèn)瀏覽器的代理設(shè)置為使用IE代理/或者使用系統(tǒng)代理狀態(tài)
可以嘗試換個瀏覽器試試
請確認(rèn)網(wǎng)絡(luò)代理設(shè)置處于勾選狀態(tài)
正常情況下dev-sidecar在“系統(tǒng)代理”開關(guān)打開時，會自動設(shè)置代理。

如何打開查看windows代理設(shè)置：

win10: 開始->設(shè)置->網(wǎng)絡(luò)和Internet->最下方代理
win7: 開始->控制面板->網(wǎng)絡(luò)和Internet->網(wǎng)絡(luò)和共享中心->左下角Internet選項->連接選項卡->局域網(wǎng)設(shè)置

windows 代理查看

mac 代理查看

3、瀏覽器打開提示證書不受信任

windows: 請確認(rèn)證書已正確安裝在“信任的根證書頒發(fā)機構(gòu)”下
mac: 請確認(rèn)證書已經(jīng)被安裝并已經(jīng)設(shè)置信任。
火狐瀏覽器：火狐瀏覽器不走系統(tǒng)的根證書，需要在選項中添加根證書
1、火狐瀏覽器->選項->隱私與安全->證書->查看證書
2、證書頒發(fā)機構(gòu)->導(dǎo)入
3、選擇證書文件C:\Users\Administrator\.dev-sidecar\dev-sidecar.ca.crt（Mac為~/.dev-sidecar目錄）
4、勾選信任由此證書頒發(fā)機構(gòu)來標(biāo)識網(wǎng)站，確定即可

4. 打開github顯示連接超時

DevSidecar Warning:
Error: www.github.com:443, 代理請求超時

如果是安全模式，則是因為不穩(wěn)定導(dǎo)致的，等一會再刷新試試
如果是默認(rèn)模式/增強模式，則是由于訪問人數(shù)過多，正常現(xiàn)象

5、查看日志是否有報錯

如果還是不行，請在下方加作者好友，將服務(wù)日志發(fā)送給作者進(jìn)行分析
日志打開方式：加速服務(wù)->右邊日志按鈕->打開日志文件夾

6、某些原本可以打開的網(wǎng)站打不開了

1、可以嘗試關(guān)閉pac
2、可以將域名加入白名單，設(shè)置方式參考：https://github.com/docmirror/dev-sidecar/issues/25

7、 git push報錯

當(dāng)git push的數(shù)據(jù)大于200k時，會報錯，目前的方案不太好解決。
臨時方案：切到安全模式，嘗試git push，多試幾次就可以了。

貢獻(xiàn)代碼

開發(fā)調(diào)試模式啟動

運行如下命令即可開發(fā)模式啟動

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

cd dev-sidecar 

npm install lerna -g
lerna bootstrap

cd packages/gui

npm run electron

打包成可執(zhí)行文件

cd packages/gui
npm run electron:build

提交pr

如果你想將你的修改貢獻(xiàn)出來，請?zhí)峤籶r

對了，看完記得一鍵四連，這個對我真的很重要。

咸魚的 Github 情報 | 加速！加速！加速！dev-sidecar 開發(fā)者邊車（開發(fā)必備）