Go Repository Quick Reference

Configuration Templates

Hosted Repository

{
  "type": "Hosted"
}

Basic Proxy Repository

{
  "type": "Proxy",
  "config": {
    "go_module_cache_ttl": 3600,
    "routes": [
      {
        "url": "https://proxy.golang.org",
        "name": "Go Official Proxy",
        "priority": 10
      }
    ]
  }
}

Multi-Route Proxy Repository

{
  "type": "Proxy",
  "config": {
    "go_module_cache_ttl": 7200,
    "routes": [
      {
        "url": "https://proxy.golang.org",
        "name": "Go Official Proxy",
        "priority": 10
      },
      {
        "url": "https://goproxy.cn",
        "name": "China Proxy",
        "priority": 5
      },
      {
        "url": "https://goproxy.io",
        "name": "Alternative Proxy",
        "priority": 1
      }
    ]
  }
}

Essential Commands

Set GOPROXY Environment Variable

Use the Nitro Repo repository URL that includes the storage and repository name:

export GOPROXY=https://your-nitro-repo.example.com/repositories/<storage-name>/<repository-name>,https://proxy.golang.org,direct

Add to Shell Profile

echo 'export GOPROXY=https://your-nitro-repo.example.com/repositories/<storage-name>/<repository-name>,https://proxy.golang.org,direct' >> ~/.bashrc
source ~/.bashrc

Verify GOPROXY Configuration

go env GOPROXY

Test Go Repository Access

go mod init test-project
go get github.com/gin-gonic/gin@v1.9.1
go mod download

Clear Go Module Cache

go clean -modcache

Publishing to Hosted Repositories

Hosted Go repositories now accept authenticated uploads for .mod, .info, and .zip artifacts using an Athens-compatible multipart POST request. Nitro automatically updates @v/list, @latest, and go.mod aliases after the uploads land.

1. Authenticate using an API token (recommended) or username/password.
2. Upload the module:

   curl -X POST \
        -H "Authorization: Bearer $NITRO_TOKEN" \
        -F "module=@widgets-v1.0.0.zip" \
        -F "version=v1.0.0" \
        -F "module_name=github.com/acme/widgets" \
        "https://your-nitro-repo.example.com/repositories/<storage-name>/<repository-name>/upload"

   The server extracts go.mod automatically (you can include an explicit gomod field if desired) and accepts an optional info part containing v1.0.0.info. The same request is also available via the Artipie-style alias:

   curl -X POST \
        -H "Authorization: Bearer $NITRO_TOKEN" \
        -F "module=@widgets-v1.0.0.zip" \
        -F "version=v1.0.0" \
        -F "module_name=github.com/acme/widgets" \
        "https://your-nitro-repo.example.com/api/<repository-name>/upload"

After the upload completes, Nitro refreshes @v/list, @latest, and go.mod aliases automatically. Clients can immediately download the new version via the Go proxy protocol.

Cache Maintenance for Proxy Repositories

• Browse to Admin → Repository → Packages to inspect items stored under go-proxy-cache/.
• Use the search box to locate cached versions (github.com/acme/widgets/@v/v1.0.0.zip, etc.).
• Select rows and click Delete Selected to invalidate entries; the next go get will fetch fresh content from upstream.

Common Endpoints

Description	Endpoint	Example
Version List	GET /{module}/@v/list	https://your-nitro-repo.example.com/repositories/<storage>/<repo>/github.com/user/module/@v/list
Version Info	GET /{module}/@v/{version}.info	https://your-nitro-repo.example.com/repositories/<storage>/<repo>/github.com/user/module/@v/v1.2.3.info
Go Mod File	GET /{module}/@v/{version}.mod	https://your-nitro-repo.example.com/repositories/<storage>/<repo>/github.com/user/module/@v/v1.2.3.mod
Module Zip	GET /{module}/@v/{version}.zip	https://your-nitro-repo.example.com/repositories/<storage>/<repo>/github.com/user/module/@v/v1.2.3.zip
Latest Info	GET /{module}/@latest	https://your-nitro-repo.example.com/repositories/<storage>/<repo>/github.com/user/module/@latest

Troubleshooting Commands

Check Network Connectivity

curl -I https://your-nitro-repo.com/github.com/gin-gonic/gin/@v/list

Test Authentication

curl -H "Authorization: Bearer $TOKEN" \
     https://your-nitro-repo.com/api/repository/{id}/stats

Monitor Go Module Downloads

GOPROXY=https://your-nitro-repo.com go mod download -x

Configuration Options

Setting	Default	Recommended Range
Cache TTL	3600 seconds	300-86400 seconds
Route Priority	0	1-10 (higher = more priority)
Max Routes	No limit	3-5 for reliability

Performance Tips

• High Priority Routes: Fast, reliable proxies (8-10)
• Medium Priority Routes: Regional backups (3-7)
• Low Priority Routes: Fallback options (1-2)
• Cache TTL: Short for dev (300s), long for prod (7200s+)

Security Checklist

• [ ] Use HTTPS for all proxy URLs
• [ ] Enable authentication for private repositories
• [ ] Monitor access logs regularly
• [ ] Validate upstream proxy certificates
• [ ] Use API tokens for automation
• [ ] Regular security updates

Cache Optimization

Fast-Changing Modules

{
  "go_module_cache_ttl": 300
}

Stable Dependencies

{
  "go_module_cache_ttl": 86400
}

Offline Development

{
  "go_module_cache_ttl": 604800
}

---

Quick reference for Go repository configuration and usage. See Go Proxy Setup Guide for detailed documentation.