brainstate

goproxy/goproxy.cn · source

Snapshot 0 · 2026-11-04T12:47:25Z · HTML · MIT

Content fingerprint9ab53315baf3e5cb00f69ff31b6588ae73760e396829551c2386ece46bd7ab04

GitHub description at capture

The most trusted Go module proxy in China.

README at capture

[English](README.md) ∙ [简体中文](README.zh-CN.md)

# Goproxy.cn

The most trusted Go module proxy in China.

Goproxy.cn has fully implemented the [GOPROXY protocol](https://go.dev/ref/mod#goproxy-protocol). It's a non-profit
project supported by China's well-trusted cloud service provider [Qiniu Cloud](https://www.qiniu.com/en). Our goal is to
provide a free, trusted, always-on, and globally CDN-accelerated Go module proxy for Gophers in China. Please subscribe
to our real-time and historical data on system performance at [status.goproxy.cn](https://status.goproxy.cn).

Goproxy.cn focuses on the development of the web application that serves at
[https://goproxy.cn](https://goproxy.cn). If you're looking for a simple way to build your own Go module proxy,
check out [Goproxy](https://github.com/goproxy/goproxy), which Goproxy.cn is based on.

Happy coding, Gophers! ;-)

## Usage

### Go 1.13 and above (RECOMMENDED)

Open your terminal and execute

```bash
$ go env -w GO111MODULE=on
$ go env -w GOPROXY=https://goproxy.cn,direct
```

done.

### macOS or Linux

Open your terminal and execute

```bash
$ export GO111MODULE=on
$ export GOPROXY=https://goproxy.cn
```

or

```bash
$ echo "export GO111MODULE=on" >> ~/.profile
$ echo "export GOPROXY=https://goproxy.cn" >> ~/.profile
$ source ~/.profile
```

done.

### Windows

Open your PowerShell and execute

```powershell
C:\> $env:GO111MODULE = "on"
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 "GO111MODULE"
7. Choose the "Variable value" input bar, type in "on"
8. Click the "OK" button
9. Click the "New..." button
10. Choose the "Variable name" input bar, type in "GOPROXY"
11. Choose the "Variable value" input bar, type in "https://goproxy.cn"
12. Click the "OK" button

done.

## FAQ

### Why create Goproxy.cn?

Due to China's network restrictions, many Go modules in the ecosystem are inaccessible to Chinese Gophers, including
the widely-used `golang.org/x/...` packages. Additionally, downloading modules from GitHub in mainland China can be
slow. We created Goproxy.cn to help Chinese Gophers use Go modules more effectively. Since Goproxy.cn is globally
CDN-accelerated, it can be used anywhere in the world.

### Is it safe to use Goproxy.cn?

Absolutely. Like all Go module proxies, we cache modules in their original, unmodified state, ensuring complete
integrity on our end. If you need additional verification, you can use the trusted checksum database
[sum.golang.org](https://sum.golang.org) to verify that modules obtained from us remain untampered, as Goproxy.cn
fully supports [proxying checksum databases](https://go.dev/design/25530-sumdb#proxying-a-checksum-database).

### Is Goproxy.cn legal in China?

Goproxy.cn is a business-supported project rather than a personal project. And it has been ICP filed in the MIIT of
China (ICP license: [沪ICP备11037377号-56](https://beian.miit.gov.cn)), which means it's **fully legal** in China.

### Why not use [proxy.golang.org](https://proxy.golang.org)?

Since [proxy.golang.org](https://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
[proxy.golang.org](https://proxy.golang.org), after all, it looks more official. Once you enter the mainland of China,
we hope that you'll think of Goproxy.cn in the first place, which is the main reason why we choose the `.cn` as the
domain name extension.

### Who will answer the questions that I have asked in [here](https://github.com/goproxy/goproxy.cn/issues/new?assignees=&labels=&template=new-question.md&title=Question%3A+)?

Members of Goproxy.cn and enthusiastic volunteers from our great Go community.

## Credits

- Author: [Aofei Sheng](https://aofeisheng.com)
- Maintainer: [Aofei Sheng](https://aofeisheng.com)
- Promoters: [Shiwei Xu (Qiniu Cloud's founder-CEO)](https://baike.baidu.com/item/许式伟), Chuntang Tao, [Lifu Mao](https://github.com/forrest-mao) and [Jianyu Chen](https://github.com/eddycjy)

## Sponsors

As a community-driven open source project, Goproxy.cn is made possible by the generous support of our sponsors.

### [![Qiniu Cloud](https://github.com/user-attachments/assets/8eeedef5-8b59-4bd5-abc9-1231631ae580)](https://www.qiniu.com/en)

[Qiniu Cloud](https://www.qiniu.com/en) is our primary sponsor, providing essential infrastructure including servers,
object storage, and CDN services.

### [![DigitalOcean](https://github.com/user-attachments/assets/95bd1397-9415-4d46-a7e5-16a5fb825982)](https://www.digitalocean.com)

[DigitalOcean](https://www.digitalocean.com) provides servers for our [Stats API](https://goproxy.cn/stats), log
analytics, and backup infrastructure to enhance availability.

### [![Atlassian](https://github.com/user-attachments/assets/5f12924b-17be-4f37-8a80-376cc556a873)](https://www.atlassian.com)

[Atlassian](https://www.atlassian.com) provides our [Statuspage](https://www.atlassian.com/software/statuspage)
subscription, enabling us to maintain our system status page at [status.goproxy.cn](https://status.goproxy.cn).

## Community

If you have any questions or ideas about this project, feel free to discuss them
[here](https://github.com/goproxy/goproxy.cn/discussions).

## Contributing

If you would like to contribute to this project, please submit issues
[here](https://github.com/goproxy/goproxy.cn/issues) or pull requests
[here](https://github.com/goproxy/goproxy.cn/pulls).

When submitting a pull request, please make sure its commit messages adhere to
[Conventional Commits 1.0.0](https://www.conventionalcommits.org/en/v1.0.0/).

## License

This project is licensed under the [MIT License](LICENSE).