A minimalist Go module proxy handler.
Goproxy has fully implemented the Go's
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 that
implements the http.Handler.
- Extremely easy to use
- One struct:
goproxy.Goproxy - Two interfaces:
goproxy.Cacherandgoproxy.Cache
- One struct:
- Built-in
GOPROXYsupport- Defaulted to
https://proxy.golang.org,direct(just like what Go is doing right now)
- Defaulted to
- Built-in
GONOPROXYsupport - Built-in
GOSUMDBsupport- Defaulted to
sum.golang.org(just like what Go is doing right now)
- Defaulted to
- Built-in
GONOSUMDBsupport - Built-in
GOPRIVATEsupport - Supports serving under other Go module proxies by setting
GOPROXY - Supports proxying checksum databases
- Supports multiple mainstream implementations of the
goproxy.Cacher- Disk:
cacher.Disk - MinIO:
cacher.MinIO - Google Cloud Storage:
cacher.GCS - Amazon Simple Storage Service:
cacher.S3 - Microsoft Azure Blob Storage:
cacher.MABS - DigitalOcean Spaces:
cacher.DOS - Alibaba Cloud Object Storage Service:
cacher.OSS - Qiniu Cloud Kodo:
cacher.Kodo
- Disk:
Open your terminal and execute
$ go get github.com/goproxy/goproxydone.
The only requirement is the Go, at least v1.12.
Create a file named goproxy.go
package main
import (
"net/http"
"github.com/goproxy/goproxy"
)
func main() {
http.ListenAndServe("localhost:8080", goproxy.New())
}and run it
$ go run goproxy.gothen 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.
Open your terminal and execute
$ go env -w GOPROXY=http://localhost:8080,directdone.
Open your terminal and execute
$ export GOPROXY=http://localhost:8080or
$ echo "export GOPROXY=http://localhost:8080" >> ~/.profile && source ~/.profiledone.
Open your PowerShell and execute
C:\> $env:GOPROXY = "http://localhost:8080"
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 "http://localhost:8080"
8. Click the "OK" buttondone.
If you want to discuss Goproxy, or ask questions about it, simply post questions or ideas here.
If you want to help build Goproxy, simply follow this to send pull requests here.
This project is licensed under the Unlicense.
License can be found here.