> For the complete documentation index, see [llms.txt](https://alexrios.gitbook.io/gomodules/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://alexrios.gitbook.io/gomodules/avancado/go-module-proxy.md).

# Go Module Proxy

## Go Module Proxy

O [Go Team](http://golang.org) provê alguns serviços através do Google, como um mirror para acelerar o download, um banco de dados com checksums para validação do conteúdo dos módulos e um indice para descoberta de novos módulos.

### O que é um Go Proxy?

É qualquer servidor que aceite uma requisição GET no padrão esperado. um exemplo seria: 

```
$ GET $GOPROXY/<module>/@v/list
```

Irá retornar uma lista com as versões conhecidas do modulo, sendo uma por linha, veja aqui um exemplo: <https://proxy.golang.org/rsc.io/quote/@v/list>

#### mod

Agora um ponto interessante a ser analisado é o `.mod` da dependência, que pode ser acessado seguindo o padrão:

```
$ GET $GOPROXY/<module>/@v/<version>.mod
```

Como, por exemplo: <https://proxy.golang.org/rsc.io/quote/@v/v1.5.1.mod>

#### zip

O download do pacote pode ser feito diretamente através do:

```
$ GET $GOPROXY/<module>/@v/.zip
```

Como, por exemplo: <https://proxy.golang.org/rsc.io/quote/@v/v1.5.1.zip>

### Para que serve o proxy?&#x20;

Do ponto de vista de uso, o `go build` irá realizar as operações da sessão anterior automaticamente. Então temos uma situação interessante, o proxy armazena versões de cada pacote, ou seja, se por ventura o pacote original sair do ar, suas dependências não irão quebrar e caso alguém injete código malicioso a versão do proxy não é afetada!

### Configurando o proxy

Por padrão o go irá utilizar o repositório [oficial](https://index.golang.org/index), porém é possivel configurar outros repositórios conforme a sua necessidade. Um exemplo seria um desenvolvedor utilizando o proxy chinês, para go 1.13 ou superior:

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

Em caso de versões anteriores é preciso trabalhar com variáveis de ambiente:&#x20;

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

Outro ponto de atenção é caso você tenha a necessidade de utilizar um repositório privado, o go permite o uso da variavel:

```
go env -w GOPRIVATE="minhaempresa.com"
```

### Mais informações

#### Mais informações sobre o proxy

```
go help goproxy
```

#### Mais informações sobre as variáveis do go

```
go help environment
```