Bash-it 代理支持完全指南一條命令管理 Shell、Git、SVN、npm 與 SSH 的代理配置【免費(fèi)下載鏈接】bash-itA community Bash framework.項(xiàng)目地址: https://gitcode.com/gh_mirrors/ba/bash-it在公司內(nèi)網(wǎng)環(huán)境辦公室有代理、家中無(wú)代理之間切換時(shí)手動(dòng)設(shè)置 OS 代理變量非常痛苦。Bash-it 的proxy插件把這一過(guò)程壓縮為enable-proxy/disable-proxy兩個(gè)命令它不僅接管 Shell 的代理環(huán)境變量還能同步改寫(xiě) Git、SVN、npm、SSH 各自的代理配置實(shí)現(xiàn)開(kāi)/關(guān)代理的全局一鍵切換。讀完本文你將掌握 Bash-it proxy 插件的完整使用方式、底層配置變量體系以及它與各大工具配置文件的交互原理。1. 為什么需要代理插件Shell 代理變量的痛點(diǎn)Bash Shell以及大量命令行工具通過(guò)以下幾組環(huán)境變量來(lái)感知代理而手工管理它們極其繁瑣環(huán)境變量作用HTTP_PROXY小寫(xiě)http_proxy定義 HTTP 請(qǐng)求使用的代理服務(wù)器HTTPS_PROXY小寫(xiě)https_proxy定義 HTTPS 請(qǐng)求使用的代理服務(wù)器ALL_PROXY小寫(xiě)all_proxy部分工具將其用于與上兩者相同的用途NO_PROXY小寫(xiě)no_proxy逗號(hào)分隔的主機(jī)名列表這些主機(jī)無(wú)需經(jīng)過(guò)代理在大寫(xiě)與小寫(xiě)兩種形式之間保持同步是常見(jiàn)的出錯(cuò)點(diǎn)許多工具只讀取小寫(xiě)形式另一些尤其是某些 Java/Node 工具鏈則只識(shí)別大寫(xiě)形式。手動(dòng)設(shè)置時(shí)漏掉任何一邊都會(huì)導(dǎo)致部分工具走代理、部分不走的詭異現(xiàn)象。Bash-it 的 proxy 插件正是為了解決這類(lèi)問(wèn)題而存在。2. 啟用 proxy 插件Bash-it 插件按約定存放于plugins/available/目錄proxy 插件的實(shí)現(xiàn)文件是 plugins/available/proxy.plugin.bash。要啟用它只需執(zhí)行bash-it enable plugin proxy啟用后 Bash-it 會(huì)自動(dòng)重新加載參考 docs/commands/reload.rstBash-it 在激活/停用插件、別名或補(bǔ)全后會(huì)自行 reload因此無(wú)需手動(dòng)重啟 Shell 即可使用下文介紹的所有命令。除 Shell 環(huán)境變量之外Bash-it 還支持為多種常見(jiàn) shell 工具同步啟用/禁用代理設(shè)置。目前支持的后端包括Git、SVN、npm、SSH。proxy 插件通過(guò)修改這些工具自身的配置文件來(lái)寫(xiě)入或清除代理設(shè)置因此對(duì)這些工具來(lái)說(shuō)是持久化的配置變更而不是臨時(shí)環(huán)境變量。3. 配置代理參數(shù)BASH_IT_* 變量調(diào)用enable-proxy時(shí)Bash-it 使用以下變量填充 Shell 的代理設(shè)置。這些變量最適合定義在 Bash-it 的自定義腳本目錄$BASH_IT/custom中例如$BASH_IT/custom/proxy.env.bashBASH_IT_HTTP_PROXY與BASH_IT_HTTPS_PROXY定義要使用的代理 URL例如http://localhost:1234BASH_IT_NO_PROXY逗號(hào)分隔的代理排除列表例如127.0.0.1,localhost在 plugins/available/proxy.plugin.bash 的enable-proxy函數(shù)中可以清晰看到這些變量的實(shí)際消費(fèi)邏輯export http_proxy${BASH_IT_HTTP_PROXY:-} export https_proxy${BASH_IT_HTTPS_PROXY:-} export HTTP_PROXY${http_proxy:-} export HTTPS_PROXY${https_proxy:-} export ALL_PROXY${http_proxy:-} export no_proxy${BASH_IT_NO_PROXY:-} export NO_PROXY${no_proxy:-}注意源碼中同時(shí)導(dǎo)出了大寫(xiě)和小寫(xiě)兩套變量http_proxy/HTTP_PROXY、https_proxy/HTTPS_PROXY、no_proxy/NO_PROXY并且ALL_PROXY與http_proxy保持一致——這正是為了兼容兩類(lèi)讀取習(xí)慣不同的工具。此外還提供了enable-proxy-alt函數(shù)它改用BASH_IT_HTTP_PROXY_ALT和BASH_IT_HTTPS_PROXY_ALT變量方便在主代理與備用代理如不同辦公地點(diǎn)之間切換。關(guān)于自定義腳本目錄的約定可參見(jiàn) docs/custom.rst$BASH_IT/custom下的文件會(huì)被 Bash-it 自動(dòng)加載且不會(huì)進(jìn)入 Git 倉(cāng)庫(kù)非常適合存放這類(lèi)本機(jī)專(zhuān)屬配置。配置示例proxy.env.bash# $BASH_IT/custom/proxy.env.bash export BASH_IT_HTTP_PROXYhttp://proxy.corp.example.com:8080 export BASH_IT_HTTPS_PROXYhttp://proxy.corp.example.com:8080 export BASH_IT_NO_PROXY127.0.0.1,localhost,*.corp.example.com # 備用代理可選供 enable-proxy-alt 使用 export BASH_IT_HTTP_PROXY_ALThttp://proxy2.corp.example.com:8080 export BASH_IT_HTTPS_PROXY_ALThttp://proxy2.corp.example.com:8080定義好這些變量后執(zhí)行reload加載變更即可開(kāi)始使用代理開(kāi)關(guān)命令。4. 核心命令enable-proxy / disable-proxy4.1 enable-proxyenable-proxy會(huì)完成兩件事設(shè)置當(dāng)前 Shell 的代理環(huán)境變量按上一節(jié)源碼中的方式導(dǎo)出大寫(xiě)/小寫(xiě)兩套變量配置 SVN、npm、SSH 配置文件中的代理支持。對(duì)應(yīng)的調(diào)用鏈如下見(jiàn) plugins/available/proxy.plugin.bash 的enable-proxynpm-enable-proxy ssh-enable-proxy svn-enable-proxy4.2 disable-proxydisable-proxy則執(zhí)行逆操作取消當(dāng)前 Shell 的代理環(huán)境變量——unset掉http_proxy、https_proxy、HTTP_PROXY、HTTPS_PROXY、ALL_PROXY、no_proxy、NO_PROXY共 7 個(gè)變量關(guān)閉 SVN、npm、SSH 配置中的代理支持npm-disable-proxy ssh-disable-proxy svn-disable-proxy每次執(zhí)行后命令都會(huì)打印一行提示如Disabled proxy environment variables方便確認(rèn)操作已生效。5. 更多代理命令與幫助體系Bash-it 提供了遠(yuǎn)不止一對(duì)開(kāi)關(guān)命令。運(yùn)行以下命令可以列出所有可用的 proxy 相關(guān)函數(shù)及簡(jiǎn)要說(shuō)明glossary proxy此外proxy-help函數(shù)會(huì)在終端打印一份完整的代理配置概覽。下表整理了 plugin 源碼中定義的全部 proxy 命令按后端分組命令作用enable-proxy啟用 Shell、npm、SSH、SVN 的代理設(shè)置enable-proxy-alt使用備用代理變量啟用上述設(shè)置disable-proxy關(guān)閉 Shell、npm、SSH、SVN 的代理設(shè)置show-proxy一次性顯示 Shell、Bash-it、npm、Git全局、SVN、SSH 的全部代理設(shè)置proxy-help打印 proxy 插件的配置說(shuō)明與當(dāng)前 Bash-it 代理變量bash-it-show-proxy僅顯示 Bash-it 的BASH_IT_*PROXY變量npm-enable-proxy/npm-disable-proxy/npm-show-proxynpm 后端的啟用/停用/查看git-enable-proxy/git-disable-proxy/git-show-proxy當(dāng)前 Git 項(xiàng)目的代理啟用/停用/查看git-global-enable-proxy/git-global-disable-proxy/git-global-show-proxyGit 全局配置的代理啟用/停用/查看svn-enable-proxy/svn-disable-proxy/svn-show-proxySVN 后端的啟用/停用/查看ssh-enable-proxy/ssh-disable-proxy/ssh-show-proxySSH 后端的啟用/停用/查看6. 后端工具深度解析插件如何改寫(xiě)各工具的配置文件6.1 npm修改 npm confignpm 后端依賴(lài)_command_exists npm判斷 npm 是否可用該輔助函數(shù)定義于 lib/utilities.bash本質(zhì)是type -t檢查。啟用時(shí)代理寫(xiě)入 npm 的三個(gè)配置項(xiàng)npm config set proxy ${my_http_proxy:?} npm config set https-proxy ${my_https_proxy:?} npm config set noproxy ${my_no_proxy:-}npm-enable-proxy支持三個(gè)可選位置參數(shù)依次為 HTTP 代理、HTTPS 代理、NO_PROXY 列表未傳入時(shí)回退到BASH_IT_HTTP_PROXY、BASH_IT_HTTPS_PROXY、BASH_IT_NO_PROXY。停用則對(duì)應(yīng)npm config delete proxy / https-proxy / noproxy。6.2 Git區(qū)分項(xiàng)目級(jí)與全局級(jí)Git 后端將當(dāng)前項(xiàng)目與全局配置區(qū)分開(kāi)項(xiàng)目級(jí)git-enable-proxy先git-disable-proxy清空再通過(guò)git config --add http.proxy與git config --add https.proxy寫(xiě)入$BASH_IT_HTTP_PROXY/$BASH_IT_HTTPS_PROXY。注意這里使用的是${BASH_IT_HTTP_PROXY:?}語(yǔ)法——變量未設(shè)置時(shí)會(huì)直接報(bào)錯(cuò)退出防止寫(xiě)入空值全局級(jí)git-global-enable-proxy同樣先--unset-all再--global --add將代理寫(xiě)入~/.gitconfig。查看命令分別對(duì)應(yīng)git config --get http.proxy與git config --global --get http.proxy。6.3 SVN改寫(xiě) ~/.subversion/serversSVN 后端通過(guò)內(nèi)嵌的 Python 2 腳本讀寫(xiě)~/.subversion/servers配置文件。啟用時(shí)插件先用urlparse從代理 URL 中解析出 host 與 port再寫(xiě)入global段的三個(gè)選項(xiàng)[global] http-proxy-host proxy.corp.example.com http-proxy-port 8080 http-proxy-exceptions 127.0.0.1,localhost停用時(shí)則移除這三個(gè)選項(xiàng)。從源碼看SVN 后端依賴(lài)_command_exists svn與_command_exists python2兩個(gè)條件同時(shí)成立即要求系統(tǒng)中存在 Python 2 解釋器這是使用該后端時(shí)需要留意的前提。svn-show-proxy則讀取并打印當(dāng)前global段中的代理配置。6.4 SSH注釋/取消注釋 ~/.ssh/config 中的 ProxyCommandSSH 后端采用注釋切換策略而非刪除配置行這保證了原有 SSH 配置結(jié)構(gòu)不被破壞啟用將# ProxyCommand以# Tab 開(kāi)頭的行替換為ProxyCommand去掉注釋符停用反向操作把^.*ProxyCommand行改為# ProxyCommand。兩處sed均使用了${BASH_IT_SED_I_PARAMETERS[]}數(shù)組實(shí)現(xiàn)跨平臺(tái)的原位編輯。該數(shù)組在 lib/helpers.bash 中按平臺(tái)自動(dòng)選擇GNU sedLinux使用-iBSD sedmacOS/FreeBSD使用-i 因此同樣的命令在兩大平臺(tái)都能無(wú)備份地原地修改文件。ssh-show-proxy則用awk分別列出當(dāng)前生效的與已被注釋停用的ProxyCommand行方便審計(jì)。7. show-proxy一次看清所有代理狀態(tài)排障時(shí)最有用的命令是show-proxy它會(huì)依次輸出當(dāng)前 Shell 環(huán)境中所有與 proxy 相關(guān)的環(huán)境變量通過(guò)env | grep -i proxy | grep -v BASH_IT同時(shí)過(guò)濾掉 Bash-it 自身的配置變量Bash-it 的BASH_IT_*PROXY配置變量npm 的proxy/https-proxy/noproxy配置Git 全局配置的http.proxy/https.proxySVN~/.subversion/servers中的代理設(shè)置SSH~/.ssh/config中生效與已禁用的ProxyCommand。在辦公室與家庭環(huán)境之間切換后用一條show-proxy即可全面核對(duì)各后端是否處于預(yù)期狀態(tài)避免Shell 通了但 git push 不走代理之類(lèi)的遺漏。8. 典型使用流程總結(jié)將以上內(nèi)容串成一套完整的工作流安裝并啟用插件bash-it enable plugin proxy定義代理變量在$BASH_IT/custom/proxy.env.bash中寫(xiě)入BASH_IT_HTTP_PROXY、BASH_IT_HTTPS_PROXY、BASH_IT_NO_PROXY如需備用代理再定義*_ALT系列加載配置執(zhí)行reload進(jìn)入辦公室運(yùn)行enable-proxyShell 與 Git/SVN/npm/SSH 全部走代理回到家中運(yùn)行disable-proxy一鍵清除全部代理設(shè)置需要多套代理使用enable-proxy-alt切換到備用代理排查問(wèn)題運(yùn)行show-proxy或glossary proxy查看當(dāng)前狀態(tài)與可用命令。這套機(jī)制的完整實(shí)現(xiàn)均可在 plugins/available/proxy.plugin.bash 中逐函數(shù)查閱它也是理解Bash 環(huán)境變量 各工具配置文件雙層代理管理模型的最佳參考。【免費(fèi)下載鏈接】bash-itA community Bash framework.項(xiàng)目地址: https://gitcode.com/gh_mirrors/ba/bash-it創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考