1.0
v1.0 - Initial Release (2025-09-26)
π New Features
- Multi-Pattern Proxy: Support for multiple URL patterns via
URL_PATTERNSenvironment variable - Placeholder System: Dynamic URL construction using
{placeholder}syntax - Wildcard Allow-lists: Security filtering with wildcard (
*) and regex support viaALLOWEDenvironment 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