Bash-it 代理支持完全指南一条命令管理 Shell、Git、SVN、npm 与 SSH 的代理配置【免费下载链接】bash-itA community Bash framework.项目地址: https://gitcode.com/gh_mirrors/ba/bash-it在公司内网环境办公室有代理、家中无代理之间切换时手动设置 OS 代理变量非常痛苦。Bash-it 的proxy插件把这一过程压缩为enable-proxy/disable-proxy两个命令它不仅接管 Shell 的代理环境变量还能同步改写 Git、SVN、npm、SSH 各自的代理配置实现开/关代理的全局一键切换。读完本文你将掌握 Bash-it proxy 插件的完整使用方式、底层配置变量体系以及它与各大工具配置文件的交互原理。1. 为什么需要代理插件Shell 代理变量的痛点Bash Shell以及大量命令行工具通过以下几组环境变量来感知代理而手工管理它们极其繁琐环境变量作用HTTP_PROXY小写http_proxy定义 HTTP 请求使用的代理服务器HTTPS_PROXY小写https_proxy定义 HTTPS 请求使用的代理服务器ALL_PROXY小写all_proxy部分工具将其用于与上两者相同的用途NO_PROXY小写no_proxy逗号分隔的主机名列表这些主机无需经过代理在大写与小写两种形式之间保持同步是常见的出错点许多工具只读取小写形式另一些尤其是某些 Java/Node 工具链则只识别大写形式。手动设置时漏掉任何一边都会导致部分工具走代理、部分不走的诡异现象。Bash-it 的 proxy 插件正是为了解决这类问题而存在。2. 启用 proxy 插件Bash-it 插件按约定存放于plugins/available/目录proxy 插件的实现文件是 plugins/available/proxy.plugin.bash。要启用它只需执行bash-it enable plugin proxy启用后 Bash-it 会自动重新加载参考 docs/commands/reload.rstBash-it 在激活/停用插件、别名或补全后会自行 reload因此无需手动重启 Shell 即可使用下文介绍的所有命令。除 Shell 环境变量之外Bash-it 还支持为多种常见 shell 工具同步启用/禁用代理设置。目前支持的后端包括Git、SVN、npm、SSH。proxy 插件通过修改这些工具自身的配置文件来写入或清除代理设置因此对这些工具来说是持久化的配置变更而不是临时环境变量。3. 配置代理参数BASH_IT_* 变量调用enable-proxy时Bash-it 使用以下变量填充 Shell 的代理设置。这些变量最适合定义在 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逗号分隔的代理排除列表例如127.0.0.1,localhost在 plugins/available/proxy.plugin.bash 的enable-proxy函数中可以清晰看到这些变量的实际消费逻辑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:-}注意源码中同时导出了大写和小写两套变量http_proxy/HTTP_PROXY、https_proxy/HTTPS_PROXY、no_proxy/NO_PROXY并且ALL_PROXY与http_proxy保持一致——这正是为了兼容两类读取习惯不同的工具。此外还提供了enable-proxy-alt函数它改用BASH_IT_HTTP_PROXY_ALT和BASH_IT_HTTPS_PROXY_ALT变量方便在主代理与备用代理如不同办公地点之间切换。关于自定义脚本目录的约定可参见 docs/custom.rst$BASH_IT/custom下的文件会被 Bash-it 自动加载且不会进入 Git 仓库非常适合存放这类本机专属配置。配置示例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定义好这些变量后执行reload加载变更即可开始使用代理开关命令。4. 核心命令enable-proxy / disable-proxy4.1 enable-proxyenable-proxy会完成两件事设置当前 Shell 的代理环境变量按上一节源码中的方式导出大写/小写两套变量配置 SVN、npm、SSH 配置文件中的代理支持。对应的调用链如下见 plugins/available/proxy.plugin.bash 的enable-proxynpm-enable-proxy ssh-enable-proxy svn-enable-proxy4.2 disable-proxydisable-proxy则执行逆操作取消当前 Shell 的代理环境变量——unset掉http_proxy、https_proxy、HTTP_PROXY、HTTPS_PROXY、ALL_PROXY、no_proxy、NO_PROXY共 7 个变量关闭 SVN、npm、SSH 配置中的代理支持npm-disable-proxy ssh-disable-proxy svn-disable-proxy每次执行后命令都会打印一行提示如Disabled proxy environment variables方便确认操作已生效。5. 更多代理命令与帮助体系Bash-it 提供了远不止一对开关命令。运行以下命令可以列出所有可用的 proxy 相关函数及简要说明glossary proxy此外proxy-help函数会在终端打印一份完整的代理配置概览。下表整理了 plugin 源码中定义的全部 proxy 命令按后端分组命令作用enable-proxy启用 Shell、npm、SSH、SVN 的代理设置enable-proxy-alt使用备用代理变量启用上述设置disable-proxy关闭 Shell、npm、SSH、SVN 的代理设置show-proxy一次性显示 Shell、Bash-it、npm、Git全局、SVN、SSH 的全部代理设置proxy-help打印 proxy 插件的配置说明与当前 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当前 Git 项目的代理启用/停用/查看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. 后端工具深度解析插件如何改写各工具的配置文件6.1 npm修改 npm confignpm 后端依赖_command_exists npm判断 npm 是否可用该辅助函数定义于 lib/utilities.bash本质是type -t检查。启用时代理写入 npm 的三个配置项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支持三个可选位置参数依次为 HTTP 代理、HTTPS 代理、NO_PROXY 列表未传入时回退到BASH_IT_HTTP_PROXY、BASH_IT_HTTPS_PROXY、BASH_IT_NO_PROXY。停用则对应npm config delete proxy / https-proxy / noproxy。6.2 Git区分项目级与全局级Git 后端将当前项目与全局配置区分开项目级git-enable-proxy先git-disable-proxy清空再通过git config --add http.proxy与git config --add https.proxy写入$BASH_IT_HTTP_PROXY/$BASH_IT_HTTPS_PROXY。注意这里使用的是${BASH_IT_HTTP_PROXY:?}语法——变量未设置时会直接报错退出防止写入空值全局级git-global-enable-proxy同样先--unset-all再--global --add将代理写入~/.gitconfig。查看命令分别对应git config --get http.proxy与git config --global --get http.proxy。6.3 SVN改写 ~/.subversion/serversSVN 后端通过内嵌的 Python 2 脚本读写~/.subversion/servers配置文件。启用时插件先用urlparse从代理 URL 中解析出 host 与 port再写入global段的三个选项[global] http-proxy-host proxy.corp.example.com http-proxy-port 8080 http-proxy-exceptions 127.0.0.1,localhost停用时则移除这三个选项。从源码看SVN 后端依赖_command_exists svn与_command_exists python2两个条件同时成立即要求系统中存在 Python 2 解释器这是使用该后端时需要留意的前提。svn-show-proxy则读取并打印当前global段中的代理配置。6.4 SSH注释/取消注释 ~/.ssh/config 中的 ProxyCommandSSH 后端采用注释切换策略而非删除配置行这保证了原有 SSH 配置结构不被破坏启用将# ProxyCommand以# Tab 开头的行替换为ProxyCommand去掉注释符停用反向操作把^.*ProxyCommand行改为# ProxyCommand。两处sed均使用了${BASH_IT_SED_I_PARAMETERS[]}数组实现跨平台的原位编辑。该数组在 lib/helpers.bash 中按平台自动选择GNU sedLinux使用-iBSD sedmacOS/FreeBSD使用-i 因此同样的命令在两大平台都能无备份地原地修改文件。ssh-show-proxy则用awk分别列出当前生效的与已被注释停用的ProxyCommand行方便审计。7. show-proxy一次看清所有代理状态排障时最有用的命令是show-proxy它会依次输出当前 Shell 环境中所有与 proxy 相关的环境变量通过env | grep -i proxy | grep -v BASH_IT同时过滤掉 Bash-it 自身的配置变量Bash-it 的BASH_IT_*PROXY配置变量npm 的proxy/https-proxy/noproxy配置Git 全局配置的http.proxy/https.proxySVN~/.subversion/servers中的代理设置SSH~/.ssh/config中生效与已禁用的ProxyCommand。在办公室与家庭环境之间切换后用一条show-proxy即可全面核对各后端是否处于预期状态避免Shell 通了但 git push 不走代理之类的遗漏。8. 典型使用流程总结将以上内容串成一套完整的工作流安装并启用插件bash-it enable plugin proxy定义代理变量在$BASH_IT/custom/proxy.env.bash中写入BASH_IT_HTTP_PROXY、BASH_IT_HTTPS_PROXY、BASH_IT_NO_PROXY如需备用代理再定义*_ALT系列加载配置执行reload进入办公室运行enable-proxyShell 与 Git/SVN/npm/SSH 全部走代理回到家中运行disable-proxy一键清除全部代理设置需要多套代理使用enable-proxy-alt切换到备用代理排查问题运行show-proxy或glossary proxy查看当前状态与可用命令。这套机制的完整实现均可在 plugins/available/proxy.plugin.bash 中逐函数查阅它也是理解Bash 环境变量 各工具配置文件双层代理管理模型的最佳参考。【免费下载链接】bash-itA community Bash framework.项目地址: https://gitcode.com/gh_mirrors/ba/bash-it创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考