# goproxy-goproxy

**Repository Path**: tickCoder-mirrors/goproxy-goproxy

## Basic Information

- **Project Name**: goproxy-goproxy
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-04-04
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Goproxy

[![Go Report Card](https://goreportcard.com/badge/github.com/goproxy/goproxy)](https://goreportcard.com/report/github.com/goproxy/goproxy)
[![PkgGoDev](https://pkg.go.dev/badge/github.com/goproxy/goproxy)](https://pkg.go.dev/github.com/goproxy/goproxy)

A minimalist Go module proxy handler.

Goproxy has fully implemented the Go's
[module proxy protocol](https://golang.org/cmd/go/#hdr-Module_proxy_protocol).
Our goal is to find the most dead simple way to provide a minimalist handler
that can act as a full-featured Go module proxy for those who want to build
their own proxies. Yeah, there is no `Makefile`, no configuration files, no
crazy file organization, no lengthy documentation, no annoying stuff, just a
[`goproxy.Goproxy`](https://pkg.go.dev/github.com/goproxy/goproxy#Goproxy) that
implements the [`http.Handler`](https://pkg.go.dev/net/http#Handler).

## Features

* Extremely easy to use
	* One struct: [`goproxy.Goproxy`](https://pkg.go.dev/github.com/goproxy/goproxy#Goproxy)
	* Two interfaces: [`goproxy.Cacher`](https://pkg.go.dev/github.com/goproxy/goproxy#Cacher) and [`goproxy.Cache`](https://pkg.go.dev/github.com/goproxy/goproxy#Cache)
* Built-in [`GOPROXY`](https://golang.org/cmd/go/#hdr-Environment_variables) support
	* Defaulted to `https://proxy.golang.org,direct` (just like what Go is doing right now)
* Built-in [`GONOPROXY`](https://golang.org/cmd/go/#hdr-Environment_variables) support
* Built-in [`GOSUMDB`](https://golang.org/cmd/go/#hdr-Environment_variables) support
	* Defaulted to `sum.golang.org` (just like what Go is doing right now)
* Built-in [`GONOSUMDB`](https://golang.org/cmd/go/#hdr-Environment_variables) support
* Built-in [`GOPRIVATE`](https://golang.org/cmd/go/#hdr-Environment_variables) support
* Supports serving under other Go module proxies by setting [`GOPROXY`](https://golang.org/cmd/go/#hdr-Environment_variables)
* Supports [proxying checksum databases](http://golang.org/design/25530-sumdb#proxying-a-checksum-database)
* Supports multiple mainstream implementations of the [`goproxy.Cacher`](https://pkg.go.dev/github.com/goproxy/goproxy#Cacher)
	* Disk: [`cacher.Disk`](https://pkg.go.dev/github.com/goproxy/goproxy/cacher#Disk)
	* MinIO: [`cacher.MinIO`](https://pkg.go.dev/github.com/goproxy/goproxy/cacher#MinIO)
	* Google Cloud Storage: [`cacher.GCS`](https://pkg.go.dev/github.com/goproxy/goproxy/cacher#GCS)
	* Amazon Simple Storage Service: [`cacher.S3`](https://pkg.go.dev/github.com/goproxy/goproxy/cacher#S3)
	* Microsoft Azure Blob Storage: [`cacher.MABS`](https://pkg.go.dev/github.com/goproxy/goproxy/cacher#MABS)
	* DigitalOcean Spaces: [`cacher.DOS`](https://pkg.go.dev/github.com/goproxy/goproxy/cacher#DOS)
	* Alibaba Cloud Object Storage Service: [`cacher.OSS`](https://pkg.go.dev/github.com/goproxy/goproxy/cacher#OSS)
	* Qiniu Cloud Kodo: [`cacher.Kodo`](https://pkg.go.dev/github.com/goproxy/goproxy/cacher#Kodo)

## Installation

Open your terminal and execute

```bash
$ go get github.com/goproxy/goproxy
```

done.

> The only requirement is the [Go](https://golang.org), at least v1.13.

## Quick Start

Create a file named `goproxy.go`

```go
package main

import (
	"net/http"

	"github.com/goproxy/goproxy"
)

func main() {
	http.ListenAndServe("localhost:8080", goproxy.New())
}
```

and run it

```bash
$ go run goproxy.go
```

then try it by setting `GOPROXY` to `http://localhost:8080` by following the
instructions below. In addition, we also recommend that you set `GO111MODULE` to
`on` instead of `auto` when you are working with Go modules.

### Go 1.13 and above (RECOMMENDED)

Open your terminal and execute

```bash
$ go env -w GOPROXY=http://localhost:8080,direct
```

done.

### macOS or Linux

Open your terminal and execute

```bash
$ export GOPROXY=http://localhost:8080
```

or

```bash
$ echo "export GOPROXY=http://localhost:8080" >> ~/.profile && source ~/.profile
```

done.

### Windows

Open your PowerShell and execute

```poweshell
C:\> $env:GOPROXY = "http://localhost:8080"
```

or

```md
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 "http://localhost:8080"
8. Click the "OK" button
```

done.

## Community

If you want to discuss Goproxy, or ask questions about it, simply post questions
or ideas [here](https://github.com/goproxy/goproxy/issues).

## Contributing

If you want to help build Goproxy, simply follow
[this](https://github.com/goproxy/goproxy/wiki/Contributing) to send pull
requests [here](https://github.com/goproxy/goproxy/pulls).

## License

This project is licensed under the MIT License.

License can be found [here](LICENSE).