goproxyio/goproxy
Goproxy
goproxy is a Go module proxy server that caches and serves Go module dependencies to accelerate builds and improve reliability. It acts as an HTTP server that proxies requests to upstream sources, caching downloaded modules locally so repeated requests are served instantly without re-downloading. The project provides a mirror that stores a read-only copy of public Go modules for offline or accelerated access, and can bypass checksum database verification for private or unrecognized modules.
The proxy is configured entirely through Go environment variables like GOPROXY, GONOSUMCHECK, and GONOSUMDB, without requiring source code modifications. It supports glob-pattern routing to selectively route module requests to the proxy, bypass it, or skip checksum verification based on path matching. Private module paths can be marked to bypass the public proxy and checksum database, while checksum database integration verifies module integrity by comparing cryptographic hashes against a trusted public database for reproducible builds.
The project includes Docker container deployment with optional volume mounts to persist the module cache across restarts, and supports shell-profile persistence so every terminal session inherits the proxy configuration automatically. IDE proxy configuration is available for GoLand to route module downloads through the proxy instead of direct version control access. Health-monitoring infrastructure with automated uptime monitoring and alerting systems detects and responds to proxy service outages or degradation, maintaining a 99.99% uptime SLA for reliable module access.
Features
- Cached Module Servers - A caching proxy that stores downloaded modules locally so repeated requests are served instantly without re-downloading.
- Module Proxies - An HTTP server that caches and serves Go module dependencies to speed up builds and reduce direct VCS fetches.
- Proxy Caches - Acts as a caching proxy that intercepts and stores public Go module requests to accelerate installation.
- Go Module Organization - Provides a cached proxy server that fetches and serves Go module dependencies to accelerate builds.
- Module Mirrors - Ships a mirror server that caches Go module downloads to reduce latency and avoid upstream failures.
- Module Proxy Environment Configurations - Configures the Go module proxy URL so the go command fetches modules through the proxy instead of directly.
- Module Proxy Protocols - Implements the Go module proxy protocol to route module requests through a central caching server.
- Proxy Configurations - Configures the Go toolchain to fetch dependencies through a global proxy server for faster and more reliable downloads.
- Module Checksum Verifications - Authenticate downloaded modules by comparing cryptographic checksums against a trusted database to ensure repeatable builds.
- Private Module Bypasses - Marking specific module paths as private to bypass the public proxy and checksum database for internal code.
- Glob Pattern Selectors - Uses glob patterns to selectively route module requests to the proxy, bypass it, or skip checksum verification.
- Module Proxy Override Rules - Sets separate glob patterns to control which modules bypass the proxy and which skip checksum verification.
- Environment Variable Configuration - Configures proxy behavior entirely through Go environment variables like GOPROXY, GONOSUMCHECK, and GONOSUMDB.
- Docker Container Deployments - Deploy the proxy as a Docker container with optional volume mounts to persist the module cache.
- Private Module Path Markings - Mark specific module path patterns as private so the go command bypasses the public proxy and checksum database for them.
- Module Proxy High Availability - Maintain enterprise monitoring and a 99.99% uptime SLA to ensure reliable module access.
- Checksum Bypasses - A proxy that can skip checksum database verification for private or unrecognized modules to accept them without validation.
- Checksum Verification Bypasses - Disable checksum database lookups for specific modules or globally to accept unrecognized modules without verification.
- Checksum Verification Overrides - Overriding or disabling checksum database lookups for specific modules to accept unrecognized dependencies.
- Private Repository Access - Allow specified private repositories to be fetched directly, bypassing the proxy for secure access.
- Proxy Bypass Configurations - Exclude specified repositories from the proxy so private modules are fetched directly from their source.
- Upstream Health Monitoring - Using automated monitoring and alerting to maintain high availability for Go module proxy services.
- Service Uptime Monitors - Use automated monitoring and alerting to maintain high availability for module proxy services.
- Module Request Routings - Routes public module requests to an upstream proxy and private ones directly to their source repositories.
- Dependency Management - GOPROXY server.
