easywall

<p align="center">
  <img src="https://raw.githubusercontent.com/jp1337/easywall/HEAD/web/static/icon.svg" alt="" width="88" height="88">
</p>

<h1 align="center">easywall</h1>

<p align="center"><em>आपका फ़ायरवॉल। आपके नियम। कोई आश्चर्य नहीं।</em></p>

<!-- One badge service, so the set shares a shape, a typeface and a logo
     treatment. The three status badges read from the workflows by name; the
     version, licence and Go badges read from the repository and go.mod, so
     none of them can drift the way a hand-written version number could. -->
<p align="center">
  <a href="https://github.com/jp1337/easywall/actions/workflows/test.yml"><img src="https://img.shields.io/github/actions/workflow/status/jp1337/easywall/test.yml?branch=main&amp;label=tests&amp;logo=github&amp;logoColor=white" alt="Tests"></a>
  <a href="https://github.com/jp1337/easywall/actions/workflows/build.yml"><img src="https://img.shields.io/github/actions/workflow/status/jp1337/easywall/build.yml?branch=main&amp;label=build&amp;logo=github&amp;logoColor=white" alt="Build"></a>
  <a href="https://github.com/jp1337/easywall/actions/workflows/security.yml"><img src="https://img.shields.io/github/actions/workflow/status/jp1337/easywall/security.yml?branch=main&amp;label=security&amp;logo=github&amp;logoColor=white" alt="Security"></a>
  <a href="https://codecov.io/gh/jp1337/easywall"><img src="https://img.shields.io/codecov/c/github/jp1337/easywall?logo=codecov&amp;logoColor=white&amp;label=coverage" alt="Coverage"></a>
</p>

<p align="center">
  <a href="https://github.com/jp1337/easywall/releases/latest"><img src="https://img.shields.io/github/v/release/jp1337/easywall?logo=github&amp;logoColor=white&amp;label=release" alt="Latest release"></a>
  <a href="https://go.dev"><img src="https://img.shields.io/github/go-mod/go-version/jp1337/easywall?logo=go&amp;logoColor=white&amp;label=go" alt="Go version"></a>
  <a href="https://www.gnu.org/licenses/gpl-3.0"><img src="https://img.shields.io/github/license/jp1337/easywall?logo=opensourceinitiative&amp;logoColor=white&amp;label=license&amp;color=blue" alt="GPL-3.0"></a>
  <a href="https://discord.gg/3zJMvChvUA"><img src="https://img.shields.io/badge/discord-join-5865F2?logo=discord&amp;logoColor=white" alt="Discord"></a>
  <a href="https://ko-fi.com/jp1337"><img src="https://img.shields.io/badge/ko--fi-support-13C3FF?logo=kofi&amp;logoColor=white" alt="Support on Ko-fi"></a>
</p>

<p align="center">
  <a href="https://demo.easywall-project.org"><strong>लाइव डेमो</strong></a> ·
  <a href="https://easywall-project.org"><strong>दस्तावेज़</strong></a> ·
  <a href="https://github.com/jp1337/easywall/blob/main/CHANGELOG.md">चेंजलॉग</a>
</p>

nftables एक वेब इंटरफ़ेस के माध्यम से जो आपको बाहर नहीं कर सकता: **हर लागू करना स्वयं को वापस ले लेता है जब तक आप पुष्टि नहीं करते।**

<picture>
  <source media="(prefers-color-scheme: dark)" srcset="docs/assets/img/screens/dashboard-dark.png">
  <img src="https://assets.kitploit.com/production/public/readmes/43596/614cbeca6ebf752bf79ddc8d910eb14f46b45390f1cb5b8f53032578aed5fb40.png" alt="The easywall dashboard: firewall status with acceptance state, pending changes and last apply; tiles counting TCP ports, UDP ports, blocklist, allowlist, custom rules and forwarding; and a recent-activity list.">
</picture>

## विचार

किसी नियम को संपादित करने से कुछ नहीं बदलता। उसे लागू करने से सब कुछ बदल जाता है — 120 सेकंड के लिए।
यदि नए नियम आपका कनेक्शन काट देते हैं तो आप Confirm पर क्लिक नहीं कर सकते, और *पुष्टि न करना*
ही पुराने नियमों को वापस लाता है।

<picture>
  <source media="(prefers-color-scheme: dark)" srcset="docs/assets/diagrams/apply-flow-dark.svg">
  <img src="https://raw.githubusercontent.com/jp1337/easywall/HEAD/docs/assets/diagrams/apply-flow-light.svg" alt="State machine: editing leads to Staged, applying leads to Live, confirming within the window leads to Confirmed, and letting the window expire leads to Rolled back, from where the staged edits are still available.">
</picture>

## आर्किटेक्चर

दो प्रक्रियाएँ। जो नेटवर्क के सामने उजागर है उसके पास चुराने लायक कोई विशेषाधिकार नहीं है।

<picture>
  <source media="(prefers-color-scheme: dark)" srcset="docs/assets/diagrams/architecture-dark.svg">
  <img src="https://raw.githubusercontent.com/jp1337/easywall/HEAD/docs/assets/diagrams/architecture-light.svg" alt="Browser talks HTTPS to easywall-web, which runs unprivileged; easywall-web talks typed JSON over a Unix socket to easywall-core, which runs as root and speaks netlink to the nftables table inet easywall.">
</picture>

मूल easywall का पूर्ण पुनर्लेखन — Python, Flask, subprocess के माध्यम से `iptables` — जिसे एक CVE के बाद 2022 में संग्रहीत किया गया था। दोनों मूल कारण समाप्त हो गए हैं:
विशेषाधिकार एक अलग प्रक्रिया में रहते हैं, और लागू करने का पथ कमांड लाइन के बजाय Go स्ट्रक्चर बनाता है। [यह कैसे काम करता है →](https://easywall-project.org/architecture/)

## इंस्टॉल करें

<picture>
  <source media="(prefers-color-scheme: dark)" srcset="docs/assets/diagrams/install-choice-dark.svg">
  <img src="https://raw.githubusercontent.com/jp1337/easywall/HEAD/docs/assets/diagrams/install-choice-light.svg" alt="Decision tree: just looking leads to demo mode; Debian or Ubuntu leads to the .deb package; already running containers leads to Docker; otherwise build from source.">
</picture>

```bash
# Debian / Ubuntu — amd64 and arm64
ARCH=$(dpkg --print-architecture)
wget https://github.com/jp1337/easywall/releases/latest/download/easywall_$ARCH.deb
sudo dpkg -i easywall_$ARCH.deb && sudo apt-get install -f

# Docker
git clone https://github.com/jp1337/easywall.git && cd easywall && docker compose up -d

# From source — Go 1.27+, nftables
git clone https://github.com/jp1337/easywall.git && cd easywall
make build && sudo make install
sudo systemctl enable --now easywall-core easywall-web
```

फिर `https://localhost:12227` खोलें। पहली विज़िट
[खाता सेट करती है और पहले नियम तैयार करती है](https://easywall-project.org/installation/first-run/)।

## आपको क्या मिलता है

| | |
|---|---|
| **पोर्ट** | TCP और UDP, एकल या रेंज, प्रति-नियम SSH ब्रूट-फ़ोर्स रूटिंग के साथ |
| **ब्लॉकलिस्ट और अनुमति सूची** | IPv4, IPv6 और CIDR, किसी भी पोर्ट नियम से पहले मूल्यांकित |
| **सुरक्षा मॉड्यूल** | बारह, डिफ़ॉल्ट रूप से पाँच सक्रिय — फ़्लड, स्कैन, बोगॉन, फ़्रैगमेंट, ब्रॉडकास्ट/मल्टीकास्ट/एनीकास्ट |
| **पोर्ट फ़ॉरवर्डिंग** | प्रोटोकॉल चयन के साथ NAT रीडायरेक्ट |
| **कस्टम नियम** | कच्चे nftables, लागू करने से पहले सिंटैक्स-जाँचे गए |
| **निर्यात / आयात** | पूरा नियम सेट JSON के रूप में |
| **ऑडिट लॉग** | क्या बदला और कब, प्रति पंक्ति एक JSON ऑब्जेक्ट |
| **Docker सहअस्तित्व** | `table inet easywall` का स्वामी, और कुछ नहीं छूता |
| **अंग्रेज़ी, जर्मन, फ़्रेंच** | इंटरफ़ेस में स्विच करने योग्य, साइन-इन से पहले भी। कोई भाषा आंशिक हो सकती है: जो अनुपस्थित है वह अंग्रेज़ी में प्रस्तुत होता है, और अंतराल छिपाने के बजाय रिपोर्ट किया जाता है |
| **लाइट और डार्क** | OS का अनुसरण करता है, मैन्युअल टॉगल के साथ; दोनों कंट्रास्ट-जाँचे गए |

## इसके साथ बनाया गया

| | |
|---|---|
| Go 1.27, एकल बाइनरी | `go-chi/chi` · `html/template` |
| `google/nftables` के माध्यम से nftables | सीधा netlink, कोई `nft` subprocess नहीं |
| Argon2id | `golang.org/x/crypto`, प्रति पासवर्ड 16-बाइट सॉल्ट |
| CSRF | `net/http.CrossOriginProtection`, Go 1.25 नेटिव |
| डिज़ाइन सिस्टम | [`DESIGN.md`](https://github.com/jp1337/easywall/blob/main/DESIGN.md) + Tailwind v4 — कोई तृतीय-पक्ष UI लाइब्रेरी नहीं |
| फ़ॉन्ट | Inter + JetBrains Mono, स्व-होस्टेड, ~145 KB — एयर-गैप्ड काम करता है |
| CI | `govulncheck`, `gosec`, CodeQL, `-race`, और एक वास्तविक कर्नेल के विरुद्ध एकीकरण सूट |

## सहायता प्राप्त करना

| | |
|---|---|
| कोई प्रश्न, या कुछ ठीक से व्यवहार नहीं कर रहा | [Discord](https://discord.gg/3zJMvChvUA) |
| कोई बग, या कोई सुविधा जो आप चाहते हैं | [GitHub issues](https://github.com/jp1337/easywall/issues) |
| कोई सुरक्षा भेद्यता | [Security advisory](https://github.com/jp1337/easywall/security/advisories/new) — **नहीं** Discord, और न ही सार्वजनिक issue |

## योगदान

सेटअप, कमिट परंपराएँ और समीक्षा चेकलिस्ट: [CONTRIBUTING.md](https://github.com/jp1337/easywall/blob/main/CONTRIBUTING.md)।
कोई भी दृश्य चीज़ पहले [`DESIGN.md`](https://github.com/jp1337/easywall/blob/main/DESIGN.md) से गुज़रती है।

सुरक्षा मुद्दे: सार्वजनिक issue के रूप में **नहीं** — [GitHub Security Advisories](https://github.com/jp1337/easywall/security/advisories/new) का उपयोग करें।

## लाइसेंस

GPL-3.0 — देखें [LICENSE](https://github.com/jp1337/easywall/blob/main/LICENSE)।