A minimalist Go module proxy handler.
Goproxy has fully implemented the GOPROXY protocol. The goal of this project 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.
- Extremely easy to use
- Three structs:
goproxy.Goproxy,goproxy.GoFetcher, andgoproxy.DirCacher - Two interfaces:
goproxy.Fetcherandgoproxy.Cacher
- Three structs:
- Built-in support for
GOPROXY,GONOPROXY,GOSUMDB,GONOSUMDB, andGOPRIVATE - Supports serving under other Go module proxies by setting
GOPROXY - Supports proxying checksum databases
- Supports
Disable-Module-Fetchheader
- To use this project programmatically,
go getit:
go get github.com/goproxy/goproxy- To use this project from the command line, download the pre-built binaries from here or build it from source:
go install github.com/goproxy/goproxy/cmd/goproxy@latest- To use this project with Docker, pull the pre-built images from here:
docker pull ghcr.io/goproxy/goproxyWrite code
Create a file named goproxy.go:
package main
import (
"net/http"
"github.com/goproxy/goproxy"
)
func main() {
http.ListenAndServe("localhost:8080", &goproxy.Goproxy{})
}Then run it with a GOMODCACHE that differs from go env GOMODCACHE:
GOMODCACHE=/tmp/goproxy-gomodcache go run goproxy.goFinally, set GOPROXY to try it out:
go env -w GOPROXY=http://localhost:8080,directFor more details, refer to the documentation.
Run from command line
Refer to the Installation section to download or build the binary.
Then run it with a GOMODCACHE that differs from go env GOMODCACHE:
GOMODCACHE=/tmp/goproxy-gomodcache goproxy server --address localhost:8080Finally, set GOPROXY to try it out:
go env -w GOPROXY=http://localhost:8080,directFor more details, check its usage:
goproxy --helpRun with Docker
Refer to the Installation section to pull the image.
Then run it:
docker run -p 8080:8080 ghcr.io/goproxy/goproxy server --address :8080Finally, set GOPROXY to try it out:
go env -w GOPROXY=http://localhost:8080,directFor more details, check its usage:
docker run ghcr.io/goproxy/goproxy --helpIf you have any questions or ideas about this project, feel free to discuss them here.
If you would like to contribute to this project, please submit issues here or pull requests here.
This project is licensed under the MIT License.
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent