fedora-metalink-proxy/README.md

Fedora Metalink Proxy

A Flask-based web application that acts as a proxy for Fedora Metalink files, allowing filtering based on various criteria such as country, protocol, and preference.

Features

• Proxy for Fedora Metalink files with configurable filtering options
• Web interface for configuring filter settings
• Basic statistics and logging for monitoring request patterns

Prerequisites

• Docker
• Docker Compose

Setup

1. Clone the repository with: git clone <repository-url> Then navigate to the project directory: cd <repository-directory>

2. Configure environment variables by copying the example file: cp .env.example .env Then edit the .env file to set your desired configuration options.

3. Build and run the Docker container with: docker-compose up --build This command will build the Docker image and start the container.

Usage

Access the Application

Open a web browser and navigate to http://localhost:8182 to access the application.

Configure Filter Settings

Navigate to /dash/config to configure the filter settings for the Metalink proxy.

View Statistics

Navigate to /dash/stats to view basic statistics on request patterns.

Access Metalink Files

Use the /metalink endpoint with query parameters to fetch and filter Metalink files.

Example URL format: http://localhost:8182/metalink?repo=fedora-42&arch=x86_64

Configuration

The application uses environment variables for configuration. Set these variables in the .env file:

• EXCLUDED_COUNTRIES: List of country codes to exclude
• PREFERRED_PROTOCOLS: List of preferred protocols
• PREFERRED_TYPES: List of preferred types
• MIN_PREFERENCE: Minimum preference value for filtering

License

MIT