8000 GitHub - E-F-A/eFa6: eFa Project - Next Generation Email Filter Appliance for Enterprise Linux 10 · GitHub
[go: up one dir, main page]

Skip to content
E-F-APublic

About

eFa Project - Next Generation Email Filter Appliance for Enterprise Linux 10

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

EFA-NG: Email Filter Appliance (Next Generation)

License: GPL v3 Platform: CentOS Stream 10 / EL10 Repository Telegram Channel

EFA-NG (Email Filter Appliance - Next Generation) is a modern, high-performance, open-source email security gateway designed to protect mail infrastructures against spam, phishing, malware, and viruses.

Forked and modernized from eFa5, EFA-NG is re-engineered with full support for CentOS Stream 10 (and the Enterprise Linux 10 ecosystem: RHEL 10, AlmaLinux 10, Rocky Linux 10), leveraging native PHP 8.4, Perl 5.40, ClamAV 1.4+, SpamAssassin 4.0+, MariaDB 10.11+, and strict SELinux security policies.


Quick Installation

On a fresh minimal installation of CentOS Stream 10 (or a compatible EL10 system: RHEL 10, AlmaLinux 10, Rocky Linux 10), run the following command as root (or via sudo):

curl -sSL https://raw.githubusercontent.com/E-F-A/eFa6/main/build/build.bash | bash

Installation Options

You can pass an optional argument to the installation script:

Mode Command Description
Production (default) curl -sSL https://raw.githubusercontent.com/E-F-A/eFa6/main/build/build.bash | bash Standard production deployment with release repository
Testing curl -sSL https://raw.githubusercontent.com/E-F-A/eFa6/main/build/build.bash | bash -s -- testing Deployment utilizing the testing repository
Development curl -sSL https://raw.githubusercontent.com/E-F-A/eFa6/main/build/build.bash | bash -s -- dev Deployment utilizing dev builds and tooling
Kickstart / Automated ... | bash -s -- ksproduction Headless kickstart installation with automated root credential setup

Core Architecture & Components

EFA-NG unifies best-of-breed open-source security technologies into a cohesive, managed email filtering gateway:

  • MTA (Mail Transfer Agent): Postfix with milter integration and SASL/TLS support.
  • Mail Filter Engine: MailScanner 5 for high-throughput multi-engine scanning.
  • Antivirus: ClamAV 1.4+ with automated signature streaming and clamav-unofficial-sigs (SaneSecurity, Foxhole, etc.).
  • Antispam: Apache SpamAssassin 4.0+ with Pyzor, Razor2, and DCC (Distributed Checksum Clearinghouse).
  • Web Management & Quarantine: MailWatch adapted for PHP 8.3, featuring message quarantine, release/learn tokens, audit trails, and reporting.
  • Greylisting: SQLgrey with SQLgrey Web Interface (SGWI).
  • DNS Caching & Resolver: Unbound caching recursive DNS resolver for high-speed RBL queries.
  • Authentication & Validation: OpenDKIM and OpenDMARC for domain authentication and spoofing prevention.
  • Intrusion Prevention: Fail2ban with hardened jails for SSH, Postfix-SASL, and MailWatch UI.
  • Database Engine: MariaDB 10.11+ LTS with optimized InnoDB buffers and UTF8MB4 charset.

System Requirements

  • Operating System: CentOS Stream 10 (recommended), RHEL 10, AlmaLinux 10, or Rocky Linux 10. EL9/EL8 are not supported (no packages are published for them).
  • CPU: Minimum 2 vCPUs (4+ vCPUs recommended for production environments).
  • Memory: Minimum 4 GB RAM (8+ GB RAM recommended for multi-engine AV/AS processing).
  • Storage: 20 GB+ free disk space (SSD recommended for mail queue and MariaDB).
  • Network: Static IPv4 / IPv6 configuration with properly configured Reverse DNS (PTR).

Post-Installation & Initial Configuration

  1. Reboot the system after the installation script finishes:
    reboot
  2. First Login Setup Wizard:
    • Log in to the console as root.
    • The initial configuration wizard (eFa-Init) will start automatically to guide you through hostname, network, TLS certificate, and administrator password configuration.
    • You can also invoke the configuration utility anytime via:
      eFa-Configure
  3. Web Administration Interface:
    • Navigate to https://<your-server-ip>/ in your browser.
    • Log in using your configured administrative credentials to manage quarantined messages, domain transport maps, whitelist/blacklist rules, and view real-time traffic statistics.

Repository Configuration

To manually add the EFA-NG RPM repository to your CentOS Stream 10 system:

# Install EPEL & Enable CRB
dnf -y install epel-release
dnf config-manager --set-enabled crb

# Add EFA-NG repository
curl -sSL https://raw.githubusercontent.com/E-F-A/eFa6/main/repos/efa-ng-centos10.repo -o /etc/yum.repos.d/efa-ng.repo

Developer Guide & Building RPMs

To set up an RPM build environment and compile all EFA-NG packages locally on CentOS 10:

# Clone the repository
git clone https://github.com/E-F-A/eFa6.git
cd eFa6

# Prepare the build toolchain
./build/devprebuild.sh

# Build all RPM packages
cd rpmbuild/SPECS
./build_all_rpms.sh

Built RPMs and repository metadata will be generated in rpm/efa-ng/centos10/release/.


Community & Official Support


Contributing

Contributions, bug reports, and pull requests are welcome! Please ensure that all code comments, documentation, and commit messages follow standard English conventions.

  1. Fork the repository (https://github.com/E-F-A/eFa6).
  2. Create your feature branch (git checkout -b feature/amazing-feature).
  3. Commit your changes (git commit -m 'Add amazing feature').
  4. Push to the branch (git push origin feature/amazing-feature).
  5. Open a Pull Request.

License & Acknowledgements

About

eFa Project - Next Generation Email Filter Appliance for Enterprise Linux 10

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages

0