Skip to content

Faroxy 1.0.0 - Initial Release

Choose a tag to compare

@vinipx vinipx released this 19 Jan 19:05
· 33 commits to main since this release

Faroxy v1.0.0 Release Notes

We're excited to announce the first release of Faroxy, a modern HTTP proxy server with real-time traffic monitoring and analysis capabilities!

馃殌 Features

HTTP Proxy Server

  • Full support for HTTP/HTTPS protocols
  • Support for all HTTP methods (GET, POST, PUT, DELETE, etc.)
  • Automatic handling of form data and multipart requests
  • Custom header forwarding and manipulation
  • Query parameter handling and URL rewriting
  • Configurable timeout and connection settings

Real-time Traffic Monitoring

  • Modern web interface for live traffic inspection
  • Real-time request/response visualization
  • Detailed view of headers, parameters, and body content
  • Search and filter capabilities
  • Response time tracking and performance metrics

Data Storage and Analysis

  • In-memory H2 database for traffic storage
  • Persistent logging of all requests and responses
  • Searchable traffic history
  • Export functionality for logs and traffic data
  • Database console access for custom queries

Developer Tools

  • RESTful API for programmatic access
  • Customizable configuration options
  • Environment-specific settings support
  • Local configuration overrides
  • Detailed logging and debugging capabilities

Security Features

  • Configurable CORS settings
  • Request validation and sanitization
  • Error handling and secure logging
  • Support for HTTPS traffic

Integration Support

  • Docker container support
  • Spring Boot integration
  • Gradle-based build system
  • Comprehensive API documentation
  • Easy-to-use client libraries

馃摎 Documentation

  • Complete documentation available at https://vinipx.github.io/faroxy/
  • API reference with examples
  • Configuration guide
  • Tutorial and getting started guides
  • Troubleshooting documentation

馃洜 Technical Details

  • Built with Spring Boot 3.2.1
  • Requires Java 17 or higher
  • Uses H2 database for storage
  • Gradle-based build system
  • Docker support included

馃敡 Installation

Gradle

dependencies {
    implementation 'io.faroxy:faroxy:1.0.0'
}

Docker

docker pull ghcr.io/vinipx/faroxy:1.0.0

馃専 Getting Started

  1. Start the server:
./gradlew bootRun
  1. Access the web interface:
http://localhost:8080
  1. Send requests through the proxy:
curl "http://localhost:8080/proxy?url=https://api.example.com/data"

馃攳 Configuration

Basic configuration in application.properties:

server.port=8080
faroxy.proxy.port=8080
logging.level.io.faroxy=INFO

馃悰 Known Issues

  • Large file uploads (>1GB) may require additional memory configuration
  • WebSocket support is planned for future releases

馃敎 Upcoming Features

  • WebSocket support
  • Advanced request/response transformation
  • Traffic replay capabilities
  • Extended metrics and analytics
  • Performance optimization for large payloads

馃摑 License

This release is available under the MIT License.

馃檹 Acknowledgments

Special thanks to all contributors who helped make this release possible!


For more information, visit our GitHub repository or documentation site.