Skip to content

1.0

Choose a tag to compare

@emericklaw emericklaw released this 26 Sep 05:01
· 7 commits to master since this release

v1.0 - Initial Release (2025-09-26)

πŸš€ New Features

  • Multi-Pattern Proxy: Support for multiple URL patterns via URL_PATTERNS environment variable
  • Placeholder System: Dynamic URL construction using {placeholder} syntax
  • Wildcard Allow-lists: Security filtering with wildcard (*) and regex support via ALLOWED environment variable
  • CORS Support: Built-in CORS headers for browser compatibility
  • Docker Support: Full containerization with multi-platform builds (linux/amd64, linux/arm64)

πŸ› οΈ Improvements

  • Comprehensive Logging: Configurable log levels (DEBUG, INFO, WARN, ERROR) with timestamps
  • Request Middleware: Automatic request logging for all incoming requests
  • Error Handling: Proper validation and error responses for missing parameters and invalid requests
  • Parameter Validation: Ensures all required placeholders are provided before making upstream requests

πŸ” Examples

Basic multi-service setup:

URL_PATTERNS=github=https://github.com/{owner}/{repo}/releases/download/{tag}/{filename},gitlab=https://gitlab.com/{owner}/{repo}/-/releases/{tag}/downloads/{filename}
URL: /service/github/owner/twbs/repo/bootstrap/tag/v5.3.8/filename/bootstrap.zip

With allow-list security:

ALLOWED=owner=twbs;repo=bootstrap,owner=facebook;repo=react*

πŸ“‹ Technical Notes

  • Uses named key/value pair URL structure: /service/<SERVICE>/key/value/key2/value2
  • Environment variables: URL_PATTERNS (required), ALLOWED (optional), LOG_LEVEL (optional)
  • Default log level: INFO