EonaCat.Proxy 0.0.4

EonaCat Proxy

Overview

EonaCat Proxy is a high-performance TCP/UDP proxy server written in C#. It supports features such as SSL/TLS, authentication, per-client bandwidth throttling, logging, heartbeats, and upstream proxy support.

This proxy is designed to be highly configurable with per-mapping settings, allowing you to control security, logging, bandwidth, and connection policies for each mapping.

Features

• Protocols: TCP and UDP

• SSL/TLS Support:

  • Accept SSL from client
  • Use SSL to server
  • Mutual SSL authentication
  • Client and server certificates

• Authentication: Optional username/password for clients

• Client Control:

  • Allowed and blocked clients
  • Max concurrent connections per mapping

• Bandwidth Management: Limit bytes per second per client

• Logging:

  • File logging with retention and max file size

• Heartbeat: Send periodic heartbeat messages to clients

• Upstream Proxy Support: Forward traffic through another proxy

• Retries: Automatic retries for failed upstream connections

Create a Mapping

var mapping = new Mapping
{
    Protocol = Protocol.TCP,
    SourceIp = "127.0.0.1",
    SourcePort = 8888,
    DestinationIp = "example.com",
    DestinationPort = 80,
    AcceptSslFromClient = false,
    UseSslToServer = false,
    Username = "user",
    Password = "pass",
    MaxBytesPerSecond = 1024 * 1024, // 1 MB/s
    EnableLogging = true
};

Start Proxy

var manager = new ProxyManager();
manager.OnConnectionEvent += (s, e) => Console.WriteLine($"[{e.Timestamp}] {e.ClientIp}: {e.Message}");
manager.OnException += (s, e) => Console.WriteLine($"Exception: {e.Message}");

manager.StartMapping(mapping);

Stop Proxy

manager.StopMapping(mapping.Id);
manager.Dispose();

Logging

• Logs are stored in the logs directory.
• File names are generated per mapping and date.
• Retention and maximum file size can be configured per mapping.

Security

• Only allow connections from clients listed in AllowedClients.
• Optionally block clients listed in BlockedClients.
• Use SSL/TLS for encrypted communication.
• Optional username/password authentication.