← Back to Blog

Go-मॉड्यूल डाउनलोड नहीं हो रहे हैं: GOPROXY, GOPRIVATE और HTTP-प्रॉक्सी को go get के लिए सेटअप करें

GOPROXY, GOPRIVATE और नेटवर्क प्रॉक्सी को सेटअप करने के लिए चरण-दर-चरण निर्देश — उन लोगों के लिए, जिनके Go-मॉड्यूल कॉर्पोरेट फायरवॉल या CI/CD में डाउनलोड नहीं हो रहे हैं।

📅November 20, 2026

go get कमांड लटक जाती है, टाइमआउट के साथ गिरती है या dial tcp: i/o timeout दिखाती है — यह कॉर्पोरेट फ़ायरवॉल, बंद नेटवर्क या निजी GitLab/GitHub रिपॉजिटरी के साथ काम करने वाले डेवलपर्स के लिए एक परिचित स्थिति है। 90% मामलों में, समस्या GOPROXY की गलत सेटिंग, GOPRIVATE की अनुपस्थिति या proxy.golang.org तक सीधी पहुंच को नेटवर्क फ़ायरवॉल द्वारा ब्लॉक करने के कारण होती है। आइए समझते हैं कि इसे सही तरीके से कैसे ठीक किया जाए।

क्यों Go-मॉड्यूल डाउनलोड नहीं हो रहे हैं

Go 1.13 संस्करण से, मॉड्यूल प्रणाली डिफ़ॉल्ट रूप से सार्वजनिक प्रॉक्सी proxy.golang.org और चेकसम सर्वर sum.golang.org को संदर्भित करती है। यदि दोनों सेवाएँ नेटवर्क स्तर पर अवरुद्ध हैं (जो रूस, चीन और सीमित कॉर्पोरेट क्षेत्रों के लिए सामान्य है), तो go build या go mod tidy कमांड टाइमआउट तक लटक जाएगी, और फिर एक त्रुटि दिखाएगी:

go: github.com/some/[email protected]: reading github.com/some/package/@v/v1.2.3.info: 
dial tcp 142.250.x.x:443: i/o timeout

मॉड्यूल डाउनलोड करने में विफलता के तीन सामान्य परिदृश्य हैं:

  • नेटवर्क ब्लॉकिंग — प्रदाता या कॉर्पोरेट फ़ायरवॉल Google इन्फ्रास्ट्रक्चर तक पहुँच को काटता है, जिस पर proxy.golang.org और sum.golang.org निर्भर करते हैं।
  • निजी रिपॉजिटरी — मॉड्यूल आंतरिक GitLab/Bitbucket में है, और सार्वजनिक GOPROXY भौतिक रूप से इसे नहीं पहुंचा सकता, और साथ ही इसे sum.golang.org पर चेकसम की जांच करने की कोशिश करता है, जबकि ऐसा नहीं करना चाहिए।
  • नेटवर्क में प्रॉक्सी सर्वर बिना सेट किए गए पर्यावरण चर — ट्रैफ़िक केवल HTTP/SOCKS5 प्रॉक्सी के माध्यम से बाहर जाता है, लेकिन Go इसके बारे में नहीं जानता, क्योंकि go get मानक net/http क्लाइंट का उपयोग करता है, जो पर्यावरण चर पढ़ता है, न कि ब्राउज़र से सिस्टम प्रॉक्सी सेटिंग्स।

आगे हम प्रत्येक मामले को विशिष्ट कमांड और कॉन्फ़िगरेशन फ़ाइलों के साथ समझेंगे।

GOPROXY क्या है और यह कैसे काम करता है

GOPROXY एक पर्यावरण चर है, जो Go टूलचेन को बताता है कि मॉड्यूल कहाँ से डाउनलोड करना है। डिफ़ॉल्ट रूप से (Go 1.14 से शुरू), इसका मान है:

GOPROXY=https://proxy.golang.org,direct

कॉमा द्वारा अलग किए गए मानों की सूची है, जिसे Go क्रम में जांचता है। direct का अर्थ है "यदि प्रॉक्सी ने 404 या 410 लौटाया, तो VCS (git, svn, hg) से सीधे डाउनलोड करें"। यदि प्रॉक्सी भौतिक रूप से अनुपलब्ध है (टाइमआउट, न कि 404), तो Go अगले स्रोत पर नहीं जाता — यह बस लटक जाता है या टाइमआउट के कारण गिर जाता है। यह एक महत्वपूर्ण बिंदु है, जिसे कई लोग नहीं समझते: फॉलबैक तंत्र केवल "मॉड्यूल नहीं मिला" के लिए काम करता है, न कि "नेटवर्क अनुपलब्ध है" के लिए।

proxy.golang.org के अलावा, कुछ सार्वजनिक मिरर हैं, जिन्हें वैकल्पिक रूप से उपयोग किया जा सकता है:

GOPROXY सर्वर URL विशेषता
Google आधिकारिक proxy.golang.org अक्सर बंद नेटवर्क में अवरुद्ध होता है
goproxy.cn goproxy.cn चीनी समुदाय द्वारा मिरर, स्थिरता से उपलब्ध
Astra (goproxy.io) goproxy.io वैकल्पिक वैश्विक मिरर
Athens (self-hosted) अपना सर्वर पूर्ण नियंत्रण, कॉर्पोरेट मॉड्यूल कैश के लिए उपयुक्त

GOPROXY सेटिंग: कार्यशील कॉन्फ़िगरेशन

Go के पर्यावरण चर को अस्थायी (सत्र के लिए) या स्थायी रूप से go env -w के माध्यम से सेट किया जा सकता है, जो मानों को Go कॉन्फ़िगरेशन फ़ाइल में सहेजता है (आमतौर पर ~/.config/go/env Linux/macOS पर और %APPDATA%\go\env Windows पर)।

स्थायी सेटिंग (अनुशंसित):

go env -w GOPROXY=https://goproxy.cn,direct
go env -w GOSUMDB=sum.golang.org

वर्तमान मान की जांच करें:

go env GOPROXY

यदि कई मिरर के साथ बैकअप की आवश्यकता है:

go env -w GOPROXY=https://goproxy.cn,https://goproxy.io,https://proxy.golang.org,direct

एक महत्वपूर्ण बिंदु: यदि सूची में पहला प्रॉक्सी टाइमआउट का उत्तर देता है, न कि HTTP त्रुटि, तो अगले स्रोत पर जाने में प्रत्येक मॉड्यूल के लिए एक मिनट तक लग सकता है — यह CI में निर्माण की गति को मारता है। इसलिए, यदि नेटवर्क भौतिक रूप से पहले प्रॉक्सी तक नहीं पहुँचता है, तो इसे सूची से तुरंत हटा देना बेहतर है या प्रॉक्सी सर्वर के माध्यम से नेटवर्क एक्सेस सेट करना (नीचे देखें), न कि फॉलबैक पर भरोसा करना।

यदि आप बाहरी प्रॉक्सी को पूरी तरह से बंद करना चाहते हैं और केवल स्थानीय कैश या सीधे VCS से काम करना चाहते हैं:

go env -w GOPROXY=direct

GOPRIVATE, GONOSUMCHECK और GOSUMDB

जब मॉड्यूल आंतरिक Git रिपॉजिटरी (कॉर्पोरेट GitLab, Bitbucket Server, self-hosted Gitea) में होता है, तो Go फिर भी डिफ़ॉल्ट रूप से इसे सार्वजनिक GOPROXY के माध्यम से जांचने की कोशिश करेगा और GOSUMDB के माध्यम से हैश की तुलना करेगा — और यह असंभव है, क्योंकि निजी कोड बाहर प्रकाशित नहीं होता है। परिणाम — त्रुटि 410 Gone या verifying module: checksum mismatch।

समाधान — GOPRIVATE चर, जो Go को बताता है: "ये मॉड्यूल पथ निजी हैं, इन्हें सार्वजनिक प्रॉक्सी में मत जाओ और चेकसम की तुलना मत करो"।

go env -w GOPRIVATE=gitlab.company.com/*,github.com/myorg/*

GOPRIVATE स्वचालित रूप से दो फ्लैग सेट करता है: GONOSUMCHECK (GOSUMDB के माध्यम से हैश की जांच को बंद करता है) और निर्दिष्ट पथों के लिए GOPROXY=direct। लेकिन यदि अधिक सूक्ष्म सेटिंग की आवश्यकता है, तो उन्हें अलग से सेट किया जा सकता है:

go env -w GONOSUMCHECK=1
go env -w GOSUMDB=off
go env -w GONOSUMDB=gitlab.company.com/*

GitHub पर निजी रिपॉजिटरी के लिए, HTTPS के माध्यम से क्लोन करते समय SSH के बजाय टोकन का उपयोग करने के लिए git को अतिरिक्त रूप से सेट करना आवश्यक है, क्योंकि Go टूलचेन इसके नीचे git का उपयोग करता है:

git config --global url."https://${GITHUB_TOKEN}@github.com/".insteadOf "https://github.com/"

यह कमांड github.com पर सभी HTTPS अनुरोधों को URL में टोकन के साथ बदल देती है, जिससे Go क्लाइंट बिना इंटरैक्टिव लॉगिन/पासवर्ड के निजी मॉड्यूल डाउनलोड कर सकता है।

go get के लिए HTTP/HTTPS प्रॉक्सी

यदि कार्यालय या सर्वर कॉर्पोरेट HTTP प्रॉक्सी (जैसे, Squid) के पीछे है, तो Go स्वचालित रूप से इसके बारे में नहीं जानता — यह केवल पर्यावरण चर HTTP_PROXY, HTTPS_PROXY और NO_PROXY पढ़ता है, जो Go net/http क्लाइंट के लिए मानक हैं।

Linux / macOS (bash/zsh):

export HTTP_PROXY=http://user:password@proxy-host:3128
export HTTPS_PROXY=http://user:password@proxy-host:3128
export NO_PROXY=localhost,127.0.0.1,gitlab.company.com

इसे हर बार लिखने से बचने के लिए, इन पंक्तियों को ~/.bashrc, ~/.zshrc या ~/.profile में जोड़ें।

Windows (PowerShell):

$env:HTTP_PROXY = "http://user:password@proxy-host:3128"
$env:HTTPS_PROXY = "http://user:password@proxy-host:3128"
$env:NO_PROXY = "localhost,127.0.0.1"

Windows पर स्थायी रूप से सहेजने के लिए setx का उपयोग करें:

setx HTTP_PROXY "http://user:password@proxy-host:3128"
setx HTTPS_PROXY "http://user:password@proxy-host:3128"

महत्वपूर्ण: NO_PROXY में आंतरिक डोमेन शामिल होना चाहिए (आंतरिक GitLab, स्थानीय Athens सर्वर), अन्यथा उनके लिए अनुरोध भी बाहरी प्रॉक्सी के माध्यम से जाएंगे और पहुँच त्रुटि के साथ गिरेंगे।

यदि सार्वजनिक GOPROXY आंतरिक फ़ायरवॉल के कारण नहीं, बल्कि किसी विशेष क्षेत्र में भू-प्रतिबंध के कारण अनुपलब्ध है — यह स्थिति उन टीमों के लिए होती है जिनके सर्वर विभिन्न देशों में फैले होते हैं — तो कॉर्पोरेट HTTP प्रॉक्सी के बजाय, आवश्यक भू-स्थान के साथ बाहरी प्रॉक्सी सर्वर के माध्यम से एक आउटबाउंड टनल स्थापित किया जा सकता है। ऐसे परिदृश्यों के लिए डेटा सेंटर प्रॉक्सी उपयुक्त हैं — ये स्थिर तेज चैनल और पूर्वानुमानित विलंबता प्रदान करते हैं, जो CI पाइपलाइन में निर्भरता के बड़े पैमाने पर डाउनलोड के लिए महत्वपूर्ण है।

SOCKS5 प्रॉक्सी और ब्लॉकों को बायपास करना

HTTP_PROXY/HTTPS_PROXY चर न केवल HTTP(S) प्रॉक्सी का समर्थन करते हैं, बल्कि SOCKS5 का भी — Go 1.10+ से, मानक पुस्तकालय socks5:// स्कीम के माध्यम से काम कर सकता है:

export ALL_PROXY=socks5://user:password@proxy-host:1080
export HTTP_PROXY=socks5://user:password@proxy-host:1080
export HTTPS_PROXY=socks5://user:password@proxy-host:1080

ALL_PROXY चर एक सार्वभौमिक है, जिसे कई CLI उपयोगिताएँ पढ़ती हैं, न कि केवल Go। यदि आपके पास पहले से SOCKS5 टनल है (जैसे, SSH के माध्यम से: ssh -D 1080 user@remote-host), तो आप बिना सर्वर पर अतिरिक्त सेटिंग के सभी ट्रैफ़िक go get के माध्यम से भेज सकते हैं।

विभिन्न क्षेत्रों से निर्माण का परीक्षण करने के लिए (उदाहरण के लिए, यह जांचने के लिए कि CI पाइपलाइन क्षेत्रीय पैकेज मिरर के लिए अनुरोध पर कैसे प्रतिक्रिया देती है या बाहरी सेवा किसी विशेष देश से अनुरोधों पर कैसे प्रतिक्रिया देती है) अक्सर एक चैनल की आवश्यकता होती है जिसमें वास्तविक IP पता होता है, जो सामान्य उपयोगकर्ता की तरह होता है, न कि डेटा सेंटर की तरह। ऐसे मामलों में, रहायशी प्रॉक्सी का चयन किया जाता है — ये सर्वर के पैकेज वितरण के पक्ष में स्वचालित प्रतिबंधों के तहत कम आते हैं।

यह जांचने के लिए कि प्रॉक्सी वास्तव में Go द्वारा उपयोग किया जा रहा है, आप विस्तृत आउटपुट के साथ एक सरल कमांड का उपयोग कर सकते हैं:

GODEBUG=http2debug=1 go get -x github.com/gin-gonic/gin

-x फ्लैग प्रत्येक निष्पादित कमांड को प्रिंट करता है, जिसमें नेटवर्क अनुरोध शामिल होते हैं, जो यह समझने में मदद करता है कि क्या go get प्रॉक्सी के माध्यम से जा रहा है या पर्यावरण चर को अनदेखा कर रहा है (यह तब होता है जब चर किसी अन्य टर्मिनल सत्र में निर्यात किए जाते हैं या उपप्रक्रिया में नहीं भेजे जाते)।

CI/CD और Docker में प्रॉक्सी

CI रनर्स (GitHub Actions, GitLab CI, Jenkins) में, पर्यावरण चर को स्पष्ट रूप से जॉब सेटिंग्स के माध्यम से पास करना आवश्यक है, न कि स्थानीय .bashrc पर भरोसा करना, जो कंटेनर में नहीं पढ़ा जाता है।

GitLab CI (.gitlab-ci.yml):

variables:
  GOPROXY: "https://goproxy.cn,direct"
  GOPRIVATE: "gitlab.company.com/*"
  HTTPS_PROXY: "http://user:password@proxy-host:3128"

build:
  script:
    - go mod download
    - go build ./...

Dockerfile (बहु-चरणीय निर्माण):

FROM golang:1.22 AS builder
ARG HTTP_PROXY
ARG HTTPS_PROXY
ENV HTTP_PROXY=${HTTP_PROXY}
ENV HTTPS_PROXY=${HTTPS_PROXY}
ENV GOPROXY=https://goproxy.cn,direct
WORKDIR /app
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN go build -o app .

निर्माण तर्क docker build को कॉल करते समय पास किए जाते हैं:

docker build --build-arg HTTP_PROXY=http://user:password@proxy-host:3128 \
  --build-arg HTTPS_PROXY=http://user:password@proxy-host:3128 \
  -t myapp .

यदि निर्माण कई रनर्स पर समानांतर में चल रहा है और पैकेज मिरर के पक्ष से एक साथ कई अनुरोधों के कारण IP पर प्रतिबंध से बचना है (यह उच्च लोड के तहत self-hosted Athens प्रॉक्सी के साथ होता है), तो आउटबाउंड अनुरोधों को IP रोटेशन के माध्यम से फैलाना उपयोगी होता है। लोड को समान रूप से वितरित करने और प्रॉक्सी सर्वर के मिरर पैकेज के पक्ष से दर सीमा को समाप्त करने के लिए अक्सर डेटा सेंटर प्रॉक्सी का उपयोग किया जाता है — ये कम विलंबता प्रदान करते हैं, जो CI के लिए महत्वपूर्ण है, जहाँ प्रत्येक अतिरिक्त सेकंड को जॉब्स की संख्या से गुणा किया जाता है।

आम गलतियाँ और उनके समाधान

त्रुटि कारण समाधान
dial tcp: i/o timeout proxy.golang.org नेटवर्क से अनुपलब्ध है GOPROXY को मिरर पर बदलें या HTTP_PROXY सेट करें
410 Gone निजी मॉड्यूल सार्वजनिक प्रॉक्सी के लिए अनुपलब्ध है आवश्यक मॉड्यूल पथ के लिए GOPRIVATE सेट करें
checksum mismatch GOSUMDB निजी मॉड्यूल की जांच करने की कोशिश कर रहा है GONOSUMDB या GOSUMDB=off के माध्यम से बंद करें
x509: certificate signed by unknown authority कॉर्पोरेट प्रॉक्सी TLS प्रमाणपत्र को बदलता है (MITM) कंपनी के रूट प्रमाणपत्र को सिस्टम स्टोर में जोड़ें
repository not found निजी git रिपॉजिटरी के लिए पहुँच टोकन नहीं है टोकन के साथ git config url.insteadOf सेट करें
प्रॉक्सी चर अनदेखा किए जा रहे हैं निर्यात किसी अन्य शेल/सत्र में किया गया है जाँच करें env | grep PROXY उसी सत्र में, जहाँ go चलाया जा रहा है

MITM प्रॉक्सी (कॉर्पोरेट Squid/Zscaler के साथ प्रमाणपत्रों को बदलने) के बारे में अलग से कहना चाहिए: यदि ऐसी प्रॉक्सी HTTPS ट्रैफ़िक को विश्लेषण के लिए रोकती है, तो Go क्लाइंट इसके स्व-हस्ताक्षरित प्रमाणपत्र पर भरोसा नहीं करता है, और यह x509 त्रुटि का कारण बनता है। समाधान — कंपनी के रूट प्रमाणपत्र को PEM प्रारूप में निर्यात करना और इसे चर में सेट करना:

export SSL_CERT_FILE=/etc/ssl/certs/company-root-ca.pem

यह चर Go रनटाइम द्वारा TLS श्रृंखला की जांच के दौरान पढ़ा जाता है और कॉर्पोरेट MITM प्रॉक्सी के माध्यम से प्रमाणपत्रों की जांच को पूरी तरह से बंद किए बिना काम करने की अनुमति देता है (जो सुरक्षा के कारण नहीं करना चाहिए)।

निष्कर्ष

यदि Go-मॉड्यूल डाउनलोड नहीं हो रहे हैं, तो 90% मामलों में तीन कदम पर्याप्त होते हैं: कार्यशील GOPROXY सेट करें (बंद proxy.golang.org के बजाय सार्वजनिक मिरर), आंतरिक रिपॉजिटरी के लिए GOPRIVATE जोड़ें और यदि नेटवर्क केवल कॉर्पोरेट प्रॉक्सी के माध्यम से बाहर जाता है तो HTTP_PROXY/HTTPS_PROXY सेट करें। CI/CD के लिए, इन चर को स्पष्ट रूप से जॉब या Docker के निर्माण तर्क के माध्यम से पास करना आवश्यक है, न कि डेवलपर के स्थानीय कॉन्फ़िगरेशन पर भरोसा करना।

यदि विफलताओं का कारण मॉड्यूल मिरर का भू-प्रतिबंध या CI में समानांतर निर्माण के दौरान प्रॉक्सी सर्वर के पक्ष से दर सीमा है, तो आउटबाउंड ट्रैफ़िक को स्थिर बाहरी चैनल के माध्यम से भेजना उचित है। ऐसे कार्यों के लिए डेटा सेंटर प्रॉक्सी अच्छी तरह से काम करते हैं — कम विलंबता और पूर्वानुमानित बैंडविड्थ बड़े पैमाने पर निर्भरता के डाउनलोड के लिए महत्वपूर्ण हैं। और यदि बाहरी सेवाओं की उपलब्धता का परीक्षण करते समय सामान्य उपयोगकर्ता ट्रैफ़िक का अनुकरण करने की आवश्यकता है, तो रहायशी प्रॉक्सी उपयुक्त होते हैं — ये पैकेज वितरण सर्वर के पक्ष में सुरक्षा प्रणालियों द्वारा संदेह में कम आते हैं।