Skip to content
The most trusted Go module proxy in China.
Branch: master
Clone or download
Latest commit e150abf Jul 15, 2019

README.md

English简体中文

Goproxy China

The most trusted Go module proxy in China.

Goproxy China has fully implemented the Go's module proxy protocol. And it's a non-profit project that will (when it is fully tested) run on China's well-trusted cloud service provider Qiniu Cloud. Our goal is to provide a free, trusted, always on, and CDNed Go module proxy for Gophers in China and the rest of the world.

Note that Goproxy China will (and will only) focus on the development of the web application that serves at the https://goproxy.cn. If you are looking for a dead simple way to build your own Go module proxy, then you should take a look at Goproxy which is Goproxy China based on.

Happy coding, Gophers! ;-)

FAQ

Q: Why create Goproxy China?

A: Due to the Chinese government's network supervision system, there are lot of modules in the Go ecosystem that Chinese Gophers cannot go get, such as the most famous golang.org/x/.... And the speed of getting modules from GitHub in the mainland of China is a bit slow. So we created Goproxy China to make Gophers in China better use Go modules. In fact, since the goproxy.cn will be CDNed, Gophers in other countries can also use it.

Q: Is it safe to use Goproxy China?

A: Of course, as with all other Go module proxies, we just cache the modules as they are, so we can assure you that they will never be tampered with on our side. However, if you still can't fully trust us, then you can use the most trusted checksum database sum.golang.org to ensure that the modules you get from us have not been tampered with, since Goproxy China has supported proxying checksum databases.

Q: Is Goproxy China legal in China?

A: The Goproxy China will be a business-supported project rather than a personal project. This means that it will be fully legal in China.

Q: Why not use the proxy.golang.org?

A: The proxy.golang.org has been blocked in the mainland of China. So, no. However, if you're not in the mainland of China, then we recommend that you give priority to using the proxy.golang.org, after all, it looks more official. Once you enter the mainland of China, we hope that you'll think of the goproxy.cn in the first place, which is the main reason why we choose the .cn as the domain name extension.

Usage

macOS or Linux

Open your terminal and execute

$ export GOPROXY=https://goproxy.cn

or

$ echo "GOPROXY=https://goproxy.cn" >> ~/.profile && source ~/.profile

done.

Windows

Open your PowerShell and execute

C:\> $env:GOPROXY = "https://goproxy.cn"

or

1. Open the Start Search, type in "env"
2. Choose the "Edit the system environment variables"
3. Click the "Environment Variables…" button
4. Under the "User variables for <YOUR_USERNAME>" section (the upper half)
5. Click the "New..." button
6. Choose the "Variable name" input bar, type in "GOPROXY"
7. Choose the "Variable value" input bar, type in "https://goproxy.cn"
8. Click the "OK" button

done.

Community

If you want to discuss Goproxy China, or ask questions about it, simply post questions or ideas here.

Contributing

If you want to help build Goproxy China, simply follow this to send pull requests here.

License

This project is licensed under the Unlicense.

License can be found here.

You can’t perform that action at this time.