一、问题背景
在公司的开发环境里，很多时候需要连接公司代理来访问外部资源。用 macOS 开发机做开发时，经常会用到 npm 来管理项目依赖，用 git 来进行代码版本控制。可有时候，连接上公司代理之后，npm 和 git 操作老是超时中断，让人头疼。下面就来好好剖析一下这里面涉及的系统代理链和证书信任机制，再给出一些解决办法。
二、系统代理链剖析
2.1 什么是系统代理链
系统代理链就像是一个中间人，我们的开发机和外部网络之间的通信都要经过它。公司设置代理，可能是出于安全、网络管理等方面的考虑。当我们的开发机连接上代理后，所有的网络请求都会先发到代理服务器，再由代理服务器转发到目标网站。
2.2 macOS 系统代理设置
在 macOS 里，可以通过“系统偏好设置” -> “网络” -> “高级” -> “代理”来设置代理。这里有几种常见的代理类型，比如 HTTP 代理、HTTPS 代理、SOCKS 代理等。
# 查看当前系统的 HTTP 代理设置
defaults read com.apple.systempreferences NetworkingProxies -dict
2.3 代理链对 npm 和 git 操作的影响
当 npm 和 git 进行网络请求时，它们会遵循系统的代理设置。如果代理链配置有问题，比如代理服务器地址错误、端口号不对，或者代理服务器本身性能不佳，就会导致请求超时中断。
举个例子，我们在使用 npm 安装依赖时：
# 尝试安装 express 依赖
npm install express
如果代理链有问题，这个安装过程可能就会卡在某个地方，最后超时中断。
三、证书信任机制剖析
3.1 为什么需要证书
在网络通信中，证书就像是一个身份证，用来证明对方的身份。当我们的开发机和目标网站进行通信时，网站会提供一个证书，开发机通过验证这个证书来确保通信的安全性。
3.2 macOS 证书信任机制
macOS 有一个证书信任数据库，里面存储着系统信任的证书。当开发机收到一个证书时，会先在这个数据库里查找是否信任这个证书。如果证书不在信任列表里，就会提示证书不受信任，从而影响网络通信。
3.3 公司代理证书问题
公司代理可能会使用自己的证书，这个证书可能没有被 macOS 系统默认信任。当 npm 和 git 通过代理访问外部资源时，就会因为证书不受信任而出现问题。
比如，使用 git 拉取代码：
# 从远程仓库拉取代码
git clone https://github.com/someuser/someproject.git
如果代理证书不受信任，git 可能会报错，提示证书验证失败。
四、问题排查
4.1 检查代理设置
首先，要确认代理设置是否正确。可以通过前面提到的“系统偏好设置”里的代理选项进行检查，也可以使用命令行来查看：
# 查看当前系统的 HTTP 代理设置
echo $http_proxy
# 查看当前系统的 HTTPS 代理设置
echo $https_proxy
如果发现代理设置有问题，可以手动修改：
# 设置 HTTP 代理
export http_proxy=http://proxy.example.com:8080
# 设置 HTTPS 代理
export https_proxy=http://proxy.example.com:8080
4.2 检查证书信任
可以在“钥匙串访问”应用里查看和管理证书。找到公司代理的证书，看看是否被标记为“始终信任”。如果没有，可以手动将其设置为信任。
4.3 检查网络连接
有时候，超时中断问题可能是因为网络本身不稳定。可以尝试访问一些常见的网站，看看网络是否正常。
# 测试网络连接
ping www.google.com
五、旁路方案
5.1 临时禁用代理
如果只是想临时解决问题，可以在进行 npm 和 git 操作时，临时禁用代理。
# 临时禁用 HTTP 代理
unset http_proxy
# 临时禁用 HTTPS 代理
unset https_proxy
# 然后进行 npm 或 git 操作
npm install express
git clone https://github.com/someuser/someproject.git
不过这种方法只适用于开发机可以直接访问外部网络的情况，如果没有外网权限，就没办法用了。
5.2 使用代理配置文件
npm 和 git 都支持通过配置文件来设置代理。我们可以创建一个配置文件，专门为 npm 和 git 配置代理。
npm 配置代理
# 为 npm 设置代理
npm config set proxy http://proxy.example.com:8080
npm config set https-proxy http://proxy.example.com:8080
git 配置代理
# 为 git 设置 HTTP 代理
git config --global http.proxy http://proxy.example.com:8080
# 为 git 设置 HTTPS 代理
git config --global https.proxy http://proxy.example.com:8080
5.3 信任公司代理证书
如果是因为证书不受信任导致的问题，可以将公司代理的证书添加到 macOS 的信任列表里。
# 导入证书到系统钥匙串
sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain /path/to/proxy.crt
六、应用场景
6.1 公司内部开发
在公司的开发环境中，使用 npm 和 git 进行项目的开发和管理是很常见的。由于公司网络的安全策略，往往需要连接公司代理才能访问外部资源，这时就可能会遇到我们前面说的超时中断问题。
6.2 多环境开发
如果开发者需要在不同的网络环境下工作，比如公司网络和家里的网络，在切换网络时可能需要重新配置代理，这也可能会导致 npm 和 git 操作出现问题。
七、技术优缺点
7.1 临时禁用代理
优点：操作简单，能够快速尝试解决问题。 缺点：只适用于有外网权限的情况，而且只是临时解决办法，不能长期使用。
7.2 使用代理配置文件
优点：可以为 npm 和 git 单独配置代理，不影响系统的其他网络设置。 缺点：需要手动配置，如果代理服务器地址或端口号发生变化，需要及时更新配置。
7.3 信任公司代理证书
优点：从根本上解决了证书不受信任的问题，保证了通信的安全性。 缺点：需要获取公司代理的证书，并且可能需要管理员权限来添加证书到信任列表。
八、注意事项
8.1 权限问题
在进行一些操作时，比如添加证书到信任列表，可能需要管理员权限。如果没有权限，操作可能会失败。
8.2 代理配置更新
如果公司的代理服务器地址或端口号发生变化，需要及时更新 npm 和 git 的代理配置，否则会导致操作失败。
8.3 安全问题
在信任公司代理证书时，要确保证书的来源可靠，避免受到中间人攻击。
九、文章总结
在 macOS 开发机连接公司代理后，npm 和 git 操作超时中断的问题，主要是由系统代理链配置问题和证书信任问题引起的。我们可以通过检查代理设置、证书信任和网络连接来排查问题，然后根据具体情况选择合适的旁路方案，比如临时禁用代理、使用代理配置文件或信任公司代理证书。在实际应用中，要注意权限问题、代理配置更新和安全问题，以确保开发工作的顺利进行。
评论
围绕“macOS开发机连接公司代理后npm与git操作超时中断，剖析系统代理链与证书信任机制并给出旁路方案”参与讨论