Skip to content
Permalink
Browse files

chore: update READMEs

  • Loading branch information
aofei committed Dec 1, 2019
1 parent 49fd8a5 commit e8191702e11f562f0c78faa039a97255298a847d
Showing with 29 additions and 29 deletions.
  1. +15 −15 README.md
  2. +14 −14 README.zh-CN.md
@@ -84,64 +84,64 @@ done.

## FAQ

### Q: Why create Goproxy China?
### Why create Goproxy China?

A: Due to the Chinese government's network supervision system, there're lot of
Due to the Chinese government's network supervision system, there're 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](https://goproxy.cn) has been CDNed, Gophers in other countries can
also use it.

### Q: Is it safe to use Goproxy China?
### Is it safe to use Goproxy China?

A: Of course, as with all other Go module proxies, we just cache the modules as
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](https://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](https://go.googlesource.com/proposal/+/master/design/25530-sumdb.md#proxying-a-checksum-database).

### Q: Is Goproxy China legal in China?
### Is Goproxy China legal in China?

A: Goproxy China is a business-supported project rather than a personal project.
Goproxy China 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](http://beian.miit.gov.cn)), which means it's **fully
legal** in China.

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

A: The [proxy.golang.org](https://proxy.golang.org) has been blocked in the
The [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 the
[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 the
[goproxy.cn](https://goproxy.cn) in the first place, which is the main reason
why we choose the `.cn` as the domain name extension.

### Q: I committed a new revision to a repository, why isn't it showing up when I run `go get -u` or `go list -m -versions`?
### I committed a new revision to a repository, why isn't it showing up when I run `go get -u` or `go list -m -versions`?

A: In order to improve caching and serving latencies, new revisions may not show
up right away. If you want new revision to be immediately available in the
In order to improve caching and serving latencies, new revisions may not show up
right away. If you want new revision to be immediately available in the
[goproxy.cn](https://goproxy.cn), then first make sure there is a semantically
versioned tag for this revision in the source repository. Then explicitly
request that tagged version via `go get module@version`. After couple of minutes
for caches to expire, the `go` command will see that tagged version.

### Q: I removed a bad release from my repository but it still appears, what should I do?
### I removed a bad release from my repository but it still appears, what should I do?

A: Whenever possible, Goproxy China aims to cache content in order to avoid
Whenever possible, Goproxy China aims to cache content in order to avoid
breaking builds for people that depend on your module, so this bad release may
still be available in the [goproxy.cn](https://goproxy.cn) even if it is not
available at the origin. The same situation applies if you delete your entire
repository. We suggest creating a new release and encouraging people to use that
one instead.

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

A: Members of Goproxy China and enthusiastic volunteers from our great Go
Members of Goproxy China and enthusiastic volunteers from our great Go
community. Please keep in mind that in order to alleviate the workload of
others, don't forget to check if our
[FAQ](https://goproxy.cn/faq) page already has the question you want to ask.
@@ -67,33 +67,33 @@ C:\> $env:GOPROXY = "https://goproxy.cn"

## 常见问题

### 问:为什么创建 Goproxy 中国?
### 为什么创建 Goproxy 中国?

答:由于中国政府的网络监管系统,Go 生态系统中有着许多中国 Gopher 们无法获取的模块,比如最著名的 `golang.org/x/...`。并且在中国大陆从 GitHub 获取模块的速度也有点慢。因此,我们创建了 Goproxy 中国,使在中国的 Gopher 们能更好地使用 Go 模块。事实上,由于 [goproxy.cn](https://goproxy.cn) 已通过 CDN 加速,所以其他国家的 Gopher 们也可以使用它。
由于中国政府的网络监管系统,Go 生态系统中有着许多中国 Gopher 们无法获取的模块,比如最著名的 `golang.org/x/...`。并且在中国大陆从 GitHub 获取模块的速度也有点慢。因此,我们创建了 Goproxy 中国,使在中国的 Gopher 们能更好地使用 Go 模块。事实上,由于 [goproxy.cn](https://goproxy.cn) 已通过 CDN 加速,所以其他国家的 Gopher 们也可以使用它。

### 问:使用 Goproxy 中国是否安全?
### 使用 Goproxy 中国是否安全?

答:当然,和所有其他的 Go 模块代理一样,我们只是将模块原封不动地缓存起来,所以我们可以向你保证它们绝对不会在我们这边被篡改。不过,如果你还是不能够完全信任我们,那么你可以使用最值得信任的校验和数据库 [sum.golang.org](https://sum.golang.org) 来确保你从我们这里获取的模块没有被篡改过,因为 Goproxy 中国已经支持了[代理校验和数据库](https://go.googlesource.com/proposal/+/master/design/25530-sumdb.md#proxying-a-checksum-database)。
当然,和所有其他的 Go 模块代理一样,我们只是将模块原封不动地缓存起来,所以我们可以向你保证它们绝对不会在我们这边被篡改。不过,如果你还是不能够完全信任我们,那么你可以使用最值得信任的校验和数据库 [sum.golang.org](https://sum.golang.org) 来确保你从我们这里获取的模块没有被篡改过,因为 Goproxy 中国已经支持了[代理校验和数据库](https://go.googlesource.com/proposal/+/master/design/25530-sumdb.md#proxying-a-checksum-database)。

### 问:Goproxy 中国在中国是合法的吗?
### Goproxy 中国在中国是合法的吗?

答:Goproxy 中国是一个由商业支持的项目而不是一个个人项目。并且它已经 ICP 备案在中华人民共和国工业和信息化部(ICP 备案号:[沪ICP备11037377号-56](http://beian.miit.gov.cn)),这也就意味着它在中国完全合法。
Goproxy 中国是一个由商业支持的项目而不是一个个人项目。并且它已经 ICP 备案在中华人民共和国工业和信息化部(ICP 备案号:[沪ICP备11037377号-56](http://beian.miit.gov.cn)),这也就意味着它在中国完全合法。

### 问:为什么不使用 [proxy.golang.org](https://proxy.golang.org)?
### 为什么不使用 [proxy.golang.org](https://proxy.golang.org)?

答:因为 [proxy.golang.org](https://proxy.golang.org) 在中国大陆被屏蔽了,所以,不使用。但是,如果你不在中国大陆,那么我们建议你优先考虑使用 [proxy.golang.org](https://proxy.golang.org),毕竟它看起来更加官方。一旦你进入了中国大陆,我们希望你能在第一时间想到 [goproxy.cn](https://goproxy.cn),这也是我们选择 `.cn` 作为域名后缀的主要原因。
因为 [proxy.golang.org](https://proxy.golang.org) 在中国大陆被屏蔽了,所以,不使用。但是,如果你不在中国大陆,那么我们建议你优先考虑使用 [proxy.golang.org](https://proxy.golang.org),毕竟它看起来更加官方。一旦你进入了中国大陆,我们希望你能在第一时间想到 [goproxy.cn](https://goproxy.cn),这也是我们选择 `.cn` 作为域名后缀的主要原因。

### 问:我对一个库提交了新的修改,为什么在我运行 `go get -u``go list -m -versions` 时它却没有出现?
### 我对一个库提交了新的修改,为什么在我运行 `go get -u``go list -m -versions` 时它却没有出现?

答:为了改善缓存和服务等待时间,新修改可能不会立即出现。如果你希望新修改立即出现在 [goproxy.cn](https://goproxy.cn) 中,则首先确保在源库中有此修改的语义化版本的标签,接着通过 `go get module@version` 来显式地请求那个发行版。在几分钟过后缓存过期,`go` 命令就能看到那个发行版了。
为了改善缓存和服务等待时间,新修改可能不会立即出现。如果你希望新修改立即出现在 [goproxy.cn](https://goproxy.cn) 中,则首先确保在源库中有此修改的语义化版本的标签,接着通过 `go get module@version` 来显式地请求那个发行版。在几分钟过后缓存过期,`go` 命令就能看到那个发行版了。

### 问:我从我的库中移除了一个有问题的发行版,但它却仍然出现,我该怎么办?
### 我从我的库中移除了一个有问题的发行版,但它却仍然出现,我该怎么办?

答:为了避免依赖你的模块的人的构建被破坏,Goproxy 中国会尽可能地缓存内容。因此,即使一个发行版在源库中已经不存在了,但它在 [goproxy.cn](https://goproxy.cn) 中却仍然有可能继续存在。如果你删除了你的整个库,则情况相同。我们建议你创建一个新的发行版并鼓励人们使用它,而不是移除一个已发布的。
为了避免依赖你的模块的人的构建被破坏,Goproxy 中国会尽可能地缓存内容。因此,即使一个发行版在源库中已经不存在了,但它在 [goproxy.cn](https://goproxy.cn) 中却仍然有可能继续存在。如果你删除了你的整个库,则情况相同。我们建议你创建一个新的发行版并鼓励人们使用它,而不是移除一个已发布的。

### 问:谁将回答我在[这里](https://github.com/goproxy/goproxy.cn/issues/new?assignees=&labels=&template=questions-related-to-go-modules.zh-CN.md&title=Go+%E6%A8%A1%E5%9D%97%EF%BC%9A)咨询的问题?
### 谁将回答我在[这里](https://github.com/goproxy/goproxy.cn/issues/new?assignees=&labels=&template=questions-related-to-go-modules.zh-CN.md&title=Go+%E6%A8%A1%E5%9D%97%EF%BC%9A)咨询的问题?

答:Goproxy 中国的成员以及我们伟大的 Go 社区中热心肠的志愿者们。请牢记,为了减轻他人的工作量,别忘了先去检查我们的[常见问题](https://goproxy.cn/faq)页面中是否已经有了你想要问的问题。
Goproxy 中国的成员以及我们伟大的 Go 社区中热心肠的志愿者们。请牢记,为了减轻他人的工作量,别忘了先去检查我们的[常见问题](https://goproxy.cn/faq)页面中是否已经有了你想要问的问题。

## 功劳

0 comments on commit e819170

Please sign in to comment.
You can’t perform that action at this time.