How to Fix Golang.org/x Package Download Failures with Proxies and Go Modules

When developing Go projects, downloading certain dependencies such as packages under golang.org/x/ often fails, interrupting work. This article presents several permanent solutions.

Problem Description

Commands like go get, go install, and go mod cannot download packages from golang.org/x/.... For example: go get -u golang.org/x/sys The download fails, as shown in the screenshot below.

Set Proxy

If you have a proxy server, set the http_proxy and https_proxy environment variables:

export http_proxy=http://proxyAddress:port
export https_proxy=http://proxyAddress:port

Example using a local proxy 192.168.21.1:1080:

export http_proxy=http://192.168.21.1:1080
export https_proxy=http://192.168.21.1:1080

After setting the proxy, the command succeeds:

go get -u golang.org/x/sys

Manual Download and Install

If a proxy is unavailable, you can manually clone the mirror repository from GitHub (e.g., zieckey/golang.org) into $GOPATH/src/golang.org/x:

mkdir $GOPATH/src/golang.org/x
cd $GOPATH/src/golang.org/x
git clone https://github.com/zieckey/golang.org.git   # or clone a specific sub‑repo
# Example: clone the text package
git clone https://github.com/golang/text.git

Note that most mirror repositories lack tags, so specifying exact versions may be impossible.

Use go.mod Replace

Since Go 1.11, modules support a replace directive to alias packages, which can also solve the download issue.

Enable modules (if your code resides in $GOPATH): export GO111MODULE=on Example go.mod:

module example.com/demo

require (
    golang.org/x/text v0.3.0
)

replace (
    golang.org/x/text => github.com/golang/text v0.3.0
)

Use GOPROXY Environment Variable

Go 1.11 also introduced the GOPROXY variable. Setting it directs the Go toolchain to download modules through a proxy such as https://goproxy.io instead of accessing the original source directly.

export GO111MODULE=on
export GOPROXY=https://goproxy.io

To disable the proxy, set GOPROXY=.

Windows PowerShell example: $env:GOPROXY = "https://goproxy.io" We recommend using the GOPROXY method for Go versions ≥ 1.11.

Final Download

Now the package can be fetched successfully:

go get -u golang.org/x/sys

The downloaded package resides in $GOPATH/pkg/mod/golang.org/x/: