GitHub Desktop 在 macOS 下通过代理访问问题的解决方案

问题背景

在使用 GitHub Desktop 3.4.8 版本于 macOS 15.1 系统时，许多开发者遇到了无法通过终端进行 git 操作（如 clone、push、pull）的问题。虽然浏览器可以正常访问 github.com，但终端操作会返回 IP 允许列表错误，提示当前 IP 未被授权访问仓库。

问题分析

这种情况通常发生在企业或组织网络环境中，这些网络往往配置了网络访问管理策略来管理网络连接。终端环境下的 git 操作默认不会自动继承系统网络设置，导致无法建立与 GitHub 服务器的连接。

解决方案

经过实践验证，以下方法可以有效解决此问题：

1. 使用 Corkscrew 工具

Corkscrew 是一个简单的 HTTP 网络隧道工具，可以通过 Homebrew 安装：

brew install corkscrew

安装完成后，需要在 SSH 配置文件中添加网络命令。编辑 ~/.ssh/config 文件，添加以下内容：

Host github.com
    ProxyCommand /opt/homebrew/bin/corkscrew <network-host> <network-port> %h %p

将 <network-host> 和 <network-port> 替换为你所在组织的实际网络服务器地址和端口。

2. 配置 Git 网络设置

为了确保 git 操作始终通过 HTTPS 连接，可以设置以下 git 配置：

git config --global http.proxy http://<network-server>:<port>
git config --global https.proxy http://<network-server>:<port>

或者在 git 配置文件中添加专门针对 GitHub 的网络设置：

[http]
    proxy = http://<network-server>:<port>
[http "https://github.com"]
    proxy = http://<network-server>:<port>

3. 验证连接

配置完成后，可以通过以下命令测试连接是否正常：

ssh -T [e-mail]

如果返回成功认证信息，则说明配置正确。

技术原理

Corkscrew 的工作原理是通过 HTTP 网络建立隧道，将 SSH 流量封装在 HTTP 协议中传输。这种方法特别适合在企业网络环境下访问外部 git 仓库的场景。同时，明确指定 git 使用 HTTPS 协议可以避免一些网络环境下 SSH 端口被限制的问题。

注意事项

1. 确保你有权限使用组织提供的网络服务器
2. 网络配置信息属于敏感信息，不应公开分享
3. 如果组织使用认证网络，可能需要在配置中添加用户名和密码
4. 不同网络环境可能需要调整具体配置参数

通过以上方法，开发者可以在企业网络环境下顺畅地使用 GitHub Desktop 和终端 git 命令进行代码管理操作。