Nginx Geo Formatter

ReadMe.md

@@ -201,7 +201,36 @@ instagram-p3-shv-01-atl3.fbcdn.net.
 31.13.65.0/24
 ```
 
-# What Else Can We Do
+# How to Set This Project Up?
+
+When setting up this project, you have to take your environment into consideration. This includes checking if you proxy your server with a proxy such as Cloudflare as well as determining what system you are running on your server as well as what commands and config files you have access to.
+
+If servers connect to you your server directly and not through a proxy, and you are running on your own Linux server, you can likely use the iptables approach. The iptables approach downloads and formats the ip addresses for blocking with iptables. It even features different methods of blocking such as silently dropping the connection, giving a rejection message, and even redirecting the connection to a different server (both on and off the same computer).
+
+```bash
+# Dropping IP Addresses
+python3 main.py -f iptables -p DROP | bash
+
+# Routing IP Addresses To Port 8081
+python3 main.py -f iptables -p DNAT -d :8081 | bash
+```
+
+If you have your own solution and can read formats such as plain text or jsonl, then you can output the ip addresses in those formats and then read them with your own software.
+
+```bash
+# Outputting IP Addresses as Plain Text
+python3 main.py -f plain
+
+# Outputting IP Addresses as JSONL
+python3 main.py -f jsonl
+
+# Help Command
+python3 main.py --help
+```
+
+When outputting 
+
+# What Else Can We Do?
 
 * If you are an admin on a server, you can issue a block against threads.net. You can use any of the reasons mentioned in this ReadMe, such as enabling harassment and transphobia.
 
@@ -239,6 +268,7 @@ I intentionally set everything in this repo as Public Domain (or [CC0 1.0 Univer
 * Sending Fake Data
 * Abandon Session After SSL Negotiation
 * [Fault Injection][fault-filter]
+* Explicit Netfilter Support
 
 [github-repo]: https://github.com/lexi-the-cute/block-meta-from-fedi
 [codeberg-repo]: https://codeberg.org/alexis/block-meta-from-fedi
@@ -265,4 +295,5 @@ I intentionally set everything in this repo as Public Domain (or [CC0 1.0 Univer
 [facebook-abortion-police]: https://www.theverge.com/2022/8/10/23299502/facebook-chat-messenger-history-nebraska-teen-abortion-case
 [activitypub-domain-block-list]: https://github.com/greyhat-academy/lists.d/blob/main/activitypub.domains.block.list.tsv
 [florida-bathroom-ban]: https://www.erininthemorning.com/p/floridas-trans-bathroom-ban-signed
-[fault-filter]: https://www.envoyproxy.io/docs/envoy/latest/configuration/http/http_filters/fault_filter
+[fault-filter]: https://www.envoyproxy.io/docs/envoy/latest/configuration/http/http_filters/fault_filter
+[nginx-drop-connection]: https://stackoverflow.com/a/21072774/21794394

functions/nginx_geo_formatter.py

@@ -0,0 +1,17 @@
+from typing import Generator
+
+import argparse
+
+def format_addresses(addresses: list[dict], args: argparse.Namespace) -> Generator[str, dict, None]:
+    # Variables
+    var_name: str = "meta_ip_addresses"
+
+    header: str = f"geo ${var_name} \u007b"
+    footer: str = "\n    default 1;\n}"
+    
+    yield header
+    for address in addresses:
+        if "route" in address:
+            yield f"    {address['route']};"
+
+    yield footer

main.py

@@ -1,4 +1,4 @@
-from functions import plaintext_formatter, whois_lookup, iptables_generator, json_formatter
+from functions import plaintext_formatter, whois_lookup, iptables_generator, json_formatter, nginx_geo_formatter
 
 import argparse
 
@@ -18,7 +18,7 @@ if __name__ == "__main__":
                            const="iptables",
                            nargs="?",
                            type=str,
-                           choices=("iptables", "plain", "jsonl"),
+                           choices=("iptables", "plain", "jsonl", "nginx-geo"),
                            help="Output format of IP address list (default: %(default)s)")
 
     argParser.add_argument("-p", "--policy",
@@ -93,5 +93,9 @@ if __name__ == "__main__":
         # JSON Formatted Addresses
         for address in json_formatter.format_addresses(addresses=addresses, args=args):
             print(address)
+    elif args.format == "nginx-geo":
+        # Nginx Config Formatted Addresses
+        for address in nginx_geo_formatter.format_addresses(addresses=addresses, args=args):
+            print(address)
     else:
         print(f"Unknown format: `{args.format}`")