Skip to content

Instantly share code, notes, and snippets.

@aucker
Forked from ozbillwang/Git_Behind_Proxy.md
Last active November 24, 2023 13:26
Show Gist options
  • Save aucker/02f18da8e36e92ea562ce8df7472e2d8 to your computer and use it in GitHub Desktop.
Save aucker/02f18da8e36e92ea562ce8df7472e2d8 to your computer and use it in GitHub Desktop.
Configure Git to use a proxy (https or SSH+GIT)

There are several ways to clone a repository from github. Similar from other providers, such as bitbucket, gitlab, etc.

https://git-scm.com/book/en/v2/Git-on-the-Server-The-Protocols

Mostly, we use

  • http
  • ssh

Sample clone commands:

The clone command with protocol https

git clone https://github.com/kubernetes/kubernetes.git

The clone command with protocol ssh+git

git clone [email protected]:kubernetes/kubernetes.git

Work with ssh config

When we are behind proxy, I have to set ssh config (~/.ssh/config) with ProxyCommand properly, git clone start working with proxy.

Install corkscrew or other proxy tool first.

with this way, we don't need provide username and password each time when clone the repository behind proxy

set ssh config

Host github.com
    Hostname github.com
    ServerAliveInterval 55
    ForwardAgent yes
    ProxyCommand /usr/bin/corkscrew <replace_with_your_company_proxy_server> <3128> %h %p

Note: the corkscrew is used for HTTP proxy, but when you use the socks proxy, you can use nc instead. Then config will be ProxyCommand /usr/bin/nc -X 5 -x <proxy_server>:<port> %h %p

need write down username and password for your proxy.

In some company policies, the password need be changed every 90 days, so don't remember to update this configuration file when your proxy password is changed.

cat ~/.ssh/myauth
proxyUsername:proxyPassword

set ssh config

Host github.com
    Hostname github.com
    ServerAliveInterval 55
    ForwardAgent yes
    ProxyCommand /usr/bin/corkscrew <replace_with_your_company_proxy_server> <3128> %h %p ~/.ssh/myauth

Work with http/https

update ~/.gitconfig

[http]
[http "https://github.com"]
	proxy = http://proxyUsername:[email protected]:port
	sslVerify = false

sslVerify setting is not necessary.

Notes:

If you only need access github by the way of ssh+git, you needn't set any proxy in ~/.gitconfig and run git config --global http.proxy ... and similar commands at all

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment