:writing_hand: Introduction

November 1, 2023 · View on GitHub

:writing_hand: Introduction

This is an Enhanced and All-in-One set of geo-location routing files optimized for Iranian users to use in v2ray/xray and all their compatible clients.

:bulb: For Sing-Box geolocation rules please refer to Iran Sing-Box Rules
:bulb: For Clash geolocation rules please refer to Iran Clash Rules

:page_with_curl: Categories

GeoIP

geoip:ir
Contains Iran IP addresses from Maxmind and IP2Location databases and IP addresses of Iranian messengers such as eitaa, rubika, etc.
geoip:cn
Contains China IP addresses from Loyalsoldier/v2ray-rules-dat repository.
geoip:ru
Contains Russia IP addresses from Maxmind database.
geoip:us
Contains United States IP addresses from Maxmind database.
geoip:private
Contains a list of local (LAN) IP addresses.
geoip:arvancloud
Contains the IP addresses of ArvanCloud.ir CDN.
geoip:derakcloud
Contains the IP addresses of Derak.cloud CDN.
geoip:iranserver
Contains the IP addresses of IranServer.com CDN.
geoip:parspack
Contains the IP addresses of ParsPack.com CDN.
geoip:cloudflare
Contains the IP addresses of Cloudflare CDN.
geoip:google
Contains the IP addresses of Google, GoogleCloud and GoogleBot.
geoip:amazon
Contains the IP addresses of Amazon and Amazon Web Services (AWS).
geoip:microsoft
Contains the IP addresses of Microsoft and Azure Platform.
geoip:bing
Contains the IP addresses of Bing and Bingbot.
geoip:github
Contains the IP addresses of GitHub.
geoip:facebook
Contains the IP addresses of the Meta ecosystem, including Facebook, Instagram and WhatsApp.
geoip:twitter
Contains the IP addresses of Twitter (now called X!).
geoip:telegram
Contains the IP addresses of Telegram Messenger.
geoip:oracle
Contains the IP addresses of Oracle Cloud.
geoip:digitalocean
Contains the IP addresses of DigitalOcean-related services.
geoip:linode
Contains the IP addresses of Linode-related services.
geoip:openai
Contains the IP addresses of OpenAI and ChatGPT.
geoip:phishing
Contains Phishing IP addresses.
geoip:malware
Contains Active Malware IP addresses.

GeoIP-Lite

geoip:ir
Contains Iran IP addresses from Maxmind and IP2Location databases and IP addresses of Iranian messengers such as eitaa, rubika, etc.
geoip:private
Contains a list of local (LAN) IP addresses.

Country.mmdb

Same as GeoIP but in Maxmind's MMDB format.

Country-lite.mmdb

Same as GeoIP Lite but in Maxmind's MMDB format.

Security-IP

geoip:phishing
Contains Phishing IP addresses.
geoip:malware
Contains Active Malware IP addresses.

Security-IP.mmdb

Same as Security-IP but in Maxmind's MMDB format.

GeoSite

All categories from domain-list-community are supported, plus the following categories:
geosite:ir
Contains non-ir TLD Iranian domains (e.g. .com .net .org etc.) and rules to bypass all .ir domains.
geosite:ads
Contains a list of Persian advertisement and tracking domains.
geosite:category-ads-all
Contains a curated list of Persian and Foreign advertisement and tracking domains based on multiple sources. It is optimized to have as low as possible false positives while also retaining a small size and efficiency.
geosite:malware
Contains a list of active malware domains.
geosite:phishing
Contains a list of scam and phishing domains.
geosite:cryptominers
Contains a list of cryptocurrency miners that run in the background of a web browser and affect system performance.
geosite:social
Contains Domain Addresses of popular social media platforms, including Facebook, Instagram, Whatsapp, Twitter, LinkedIn, MySpace, Pinterest, Tumblr, Reddit, TikTok, clubhouse.
geosite:nsfw Contains a list of porn and gambling websites.

GeoSite-Lite

geosite:ir
Contains non-ir TLD Iranian domains (e.g. .com .net .org etc.) with dead domains removed and rules to bypass all .ir domains.
All IR domains from normal GeoSite get checked every 24 hours and after the removal of non-active domains, will get in this category.
The test may not be very accurate, so I recommend updating this list daily or regularly.
geosite:ads
Contains a list of Persian advertisement and tracking domains.

Security

geosite:category-ads-all
Contains a curated list of Persian and Foreign advertisement and tracking domains based on multiple sources. It is optimized to have as low as possible false positives while also retaining a small size and efficiency.
geosite:malware
Contains a list of active malware domains.
geosite:phishing
Contains a list of scam and phishing domains.
geosite:cryptominers
Contains a list of cryptocurrency miners that run in the background of a web browser and affect system performance.

:arrow_down: How to download

From GitHub

GeoIP https://github.com/chocolate4u/Iran-v2ray-rules/releases/latest/download/geoip.dat
GeoSite https://github.com/chocolate4u/Iran-v2ray-rules/releases/latest/download/geosite.dat

GeoIP-Lite https://github.com/chocolate4u/Iran-v2ray-rules/releases/latest/download/geoip-lite.dat
GeoSite-Lite https://github.com/chocolate4u/Iran-v2ray-rules/releases/latest/download/geosite-lite.dat

Security-IP https://github.com/chocolate4u/Iran-v2ray-rules/releases/latest/download/security-ip.dat
Security https://github.com/chocolate4u/Iran-v2ray-rules/releases/latest/download/security.dat

From jsDelivr CDN

GeoIP https://cdn.jsdelivr.net/gh/chocolate4u/Iran-v2ray-rules@release/geoip.dat
GeoSite https://cdn.jsdelivr.net/gh/chocolate4u/Iran-v2ray-rules@release/geosite.dat

GeoIP-Lite https://cdn.jsdelivr.net/gh/chocolate4u/Iran-v2ray-rules@release/geoip-lite.dat
GeoSite-Lite https://cdn.jsdelivr.net/gh/chocolate4u/Iran-v2ray-rules@release/geosite-lite.dat

Security-IP https://cdn.jsdelivr.net/gh/chocolate4u/Iran-v2ray-rules@release/security-ip.dat
Security https://cdn.jsdelivr.net/gh/chocolate4u/Iran-v2ray-rules@release/security.dat

:computer: Usage

v2ray/xray core

Add the following to your v2ray/xray client configuration:

"outbounds": [
  {
    "tag": "direct",
    "protocol": "freedom",
    "settings": {}
  },
  {
    "tag": "block",
    "protocol": "blackhole",
    "settings": {}
  }
],
"routing": {
  "domainStrategy": "IPIfNonMatch",
  "rules": [
    {
      "outboundTag": "block",
      "domain": [
        "geosite:category-ads-all",
        "geosite:malware",
        "geosite:phishing",
        "geosite:cryptominers"
      ],
      "type": "field"
    },
    {
      "outboundTag": "block",
      "ip": [
        "geoip:malware",
        "geoip:phishing"
      ],
      "type": "field"
    },
    {
      "outboundTag": "direct",
      "domain": [
        "geosite:ir"
      ],
      "type": "field"
    },
    {
      "outboundTag": "direct",
      "ip": [
        "geoip:ir",
        "geoip:private",
        "geoip:arvancloud",
        "geoip:derakcloud,
        "geoip:iranserver,
        "geoip:parspack
      ],
      "type": "field"
    },
  ]
}

:information_desk_person: How is this made?

geoip.dat,geoip-lite.dat and Country.mmdb,Country-lite.mmdb are generated using source code from geoip repository by Loyalsoldier. Please refer to the mentioned repository for instructions on how to make custom geoip files.
geosite.dat,geosite-lite.dat is generated using source code from Domain list community. Please refer to the mentioned repository for instructions on how to make custom geosite files.

:handshake: Contribution

All contributions are welcome and appreciated. You can contribute to this project in 2 ways:

Contribute to its upstream sources
Do you know a Domain that should be bypassed? report it to Iran Hosted Domains
Do you know a Persian advertisement domain that should be blocked or a false positive? report it to PersianBlocker
Do you know... OK, you got the idea!
Contribute directly to this project
Report issues, open pull requests, suggest new sources or categories or any idea, in general, to make this repository more useful for everyone.

:raising_hand_man: Also one more thing, if this repository was useful to you, kindly leave a :star: up there so this project can be seen by more people.

:copyright: License

This project, except for upstream sources, is licensed under the GNU GPLv3 License - see the LICENSE file for details.

All rights are reserved for All upstream sources used in this project according to their respective licenses. Please refer to Sources section for more details.

:package: Sources

GeoIP

Source	Maintainer	Home Page	License	Category
GeoLite2	MaxMind	Home Page	CC BY-SA 4.0	ir, ru, us
IP2Location LITE	IP2Location	Home Page	CC BY-SA 4.0	ir
ITO GOV	ITO GOV	Home Page	N/A	ir(messenger IPs)
V2ray-rules-dat	Loyalsoldier	Home Page	GPL-3.0	cn
Arvan Cloud	Arvan Cloud	Home Page	All rights reserved	arvancloud
Derak Cloud	Derak Cloud	Home Page	All rights reserved	derakcloud
IranServer	IranServer	Home Page	All rights reserved	iranserver
ParsPack	ParsPack	Home Page	All rights reserved	parspack
Cloudflare	Cloudflare	Home Page	All rights reserved	cloudflare
Telegram	Telegram	Home Page	All rights reserved	Telegram
URLhaus	abuse.ch	Home Page	CC0	malware
Phishing URL Blocklist	malware-filter Group	Home Page	MIT	phishing
IPRanges	lord-alfred	Home Page	CC0 1.0	everything else

GeoSite

Source	Maintainer	Home Page	License	Category
Iran Hosted Domains	bootmortis	Home Page	MIT	ir
PersianBlocker	MasterKia	Home Page	AGPL-3.0	ads
DNS Blocklists	Hagezi	Home Page	All rights reserved	ads
Ad and tracking server list	Peter Lowe	Home Page	McRae GPL	ads
GoodbyeAds	jerryn70	Home Page	MIT	ads
AdGuard DNS filter	Adguard Team	Home Page	GPL-3.0	ads
URLhaus	abuse.ch	Home Page	CC0	malware
Phishing URL Blocklist	malware-filter Group	Home Page	MIT	phishing
NoCoin adblock list	hoshsadiq	Home Page	MIT	cryptominers
Unified Hosts	StevenBlack	Home Page	MIT	social, nsfw
Domain list community	Domain list community	Home Page	MIT	everything else

:warning: Disclaimer

This repository is not affiliated, associated, authorized, endorsed by, or in any way officially connected to any of the aforementioned resources, websites, services, or any entity which this may concern, in any way.
The data in this repository is gathered from publicly available resources and is provided as-is, intended for informational purposes only with no guarantee of accuracy, liability or availability and We are not responsible for any harm or damage that may arise from using the data in this repository. Please do your research before using any data from this repository.

:pray: Special Thanks

All maintainers that are mentioned in this project.
Project V
Project X
Domain list community
Loyalsoldier