[فارسی](README.fa.md)
# :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](https://github.com/Chocolate4U/Iran-sing-box-rules)
:bulb: For Clash geolocation rules please refer to [Iran Clash Rules](https://github.com/Chocolate4U/Iran-clash-rules)
# :arrow_down: How to download
## From GitHub
### geoip.dat
[https://raw.githubusercontent.com/Chocolate4U/Iran-v2ray-rules/release/geoip.dat](https://raw.githubusercontent.com/Chocolate4U/Iran-v2ray-rules/release/geoip.dat)
QR Code
---
### geosite.dat
[https://raw.githubusercontent.com/Chocolate4U/Iran-v2ray-rules/release/geosite.dat](https://raw.githubusercontent.com/Chocolate4U/Iran-v2ray-rules/release/geosite.dat)
QR Code
---
### geoip-lite.dat
[https://raw.githubusercontent.com/Chocolate4U/Iran-v2ray-rules/release/geoip-lite.dat](https://raw.githubusercontent.com/Chocolate4U/Iran-v2ray-rules/release/geoip-lite.dat)
QR Code
---
### geosite-lite.dat
[https://raw.githubusercontent.com/Chocolate4U/Iran-v2ray-rules/release/geosite-lite.dat](https://raw.githubusercontent.com/Chocolate4U/Iran-v2ray-rules/release/geosite-lite.dat)
QR Code
---
### security-ip.dat
[https://raw.githubusercontent.com/Chocolate4U/Iran-v2ray-rules/release/security-ip.dat](https://raw.githubusercontent.com/Chocolate4U/Iran-v2ray-rules/release/security-ip.dat)
QR Code
---
### security.dat
[https://raw.githubusercontent.com/Chocolate4U/Iran-v2ray-rules/release/security.dat](https://raw.githubusercontent.com/Chocolate4U/Iran-v2ray-rules/release/security.dat)
QR Code
---
## From jsDelivr CDN
### geoip.dat
[https://cdn.jsdelivr.net/gh/chocolate4u/Iran-v2ray-rules@release/geoip.dat](https://cdn.jsdelivr.net/gh/chocolate4u/Iran-v2ray-rules@release/geoip.dat)
QR Code
---
### geosite.dat
[https://cdn.jsdelivr.net/gh/chocolate4u/Iran-v2ray-rules@release/geosite.dat](https://cdn.jsdelivr.net/gh/chocolate4u/Iran-v2ray-rules@release/geosite.dat)
QR Code
---
### geoip-lite.dat
[https://cdn.jsdelivr.net/gh/chocolate4u/Iran-v2ray-rules@release/geoip-lite.dat](https://cdn.jsdelivr.net/gh/chocolate4u/Iran-v2ray-rules@release/geoip-lite.dat)
QR Code
---
### geosite-lite.dat
[https://cdn.jsdelivr.net/gh/chocolate4u/Iran-v2ray-rules@release/geosite-lite.dat](https://cdn.jsdelivr.net/gh/chocolate4u/Iran-v2ray-rules@release/geosite-lite.dat)
QR Code
---
### security-ip.dat
[https://cdn.jsdelivr.net/gh/chocolate4u/Iran-v2ray-rules@release/security-ip.dat](https://cdn.jsdelivr.net/gh/chocolate4u/Iran-v2ray-rules@release/security-ip.dat)
QR Code
---
### security.dat
[https://cdn.jsdelivr.net/gh/chocolate4u/Iran-v2ray-rules@release/security.dat](https://cdn.jsdelivr.net/gh/chocolate4u/Iran-v2ray-rules@release/security.dat)
QR Code
---
# :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"
],
"type": "field"
},
]
}
```
# :page_with_curl: Categories
## GeoIP
Categories in geoip.dat
- Contains IP Addresses of all countries from Maxmind and IP2Location databases.
- `geoip:ir`
Contains Iran IP addresses from Maxmind and IP2Location databases, IP addresses of Iranian messengers such as `eitaa`, `rubika`, etc. and IP addresses of `arvancloud`, `derakcloud`, `iranserver` and `parspack` CDNs.
- `geoip:private`
Contains a list of local (LAN) IP addresses.
- `geoip:arvancloud`
Contains the IP addresses of ArvanCloud.ir CDN. :information_source: Integrated in `geoip:ir` and no longer needed to be written as a separate rule.
- `geoip:derakcloud`
Contains the IP addresses of Derak.cloud CDN. :information_source: Integrated in `geoip:ir` and no longer needed to be written as a separate rule.
- `geoip:iranserver`
Contains the IP addresses of IranServer.com CDN. :information_source: Integrated in `geoip:ir` and no longer needed to be written as a separate rule.
- `geoip:parspack`
Contains the IP addresses of ParsPack.com CDN. :information_source: Integrated in `geoip:ir` and no longer needed to be written as a separate rule.
- `geoip:cloudflare`
Contains the IP addresses of Cloudflare CDN.
- `geoip:cloudfront`
Contains the IP addresses of Cloudfront CDN.
- `geoip:fastly`
Contains the IP addresses of Fastly CDN.
- `geoip:gcore`
Contains the IP addresses of G-Core 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:netflix`
Contains the IP addresses of Netflix.
- `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:tor`
Contains the IP addresses of Tor exit nodes.
- `geoip:phishing`
Contains Phishing IP addresses.
- `geoip:malware`
Contains Active Malware IP addresses.
Categories in geoip-lite.dat
- `geoip:ir`
Contains Iran IP addresses from Maxmind and IP2Location databases, IP addresses of Iranian messengers such as `eitaa`, `rubika`, etc. and IP addresses of `arvancloud`, `derakcloud`, `iranserver` and `parspack` CDNs.
- `geoip:private`
Contains a list of local (LAN) IP addresses.
Categories in security-ip.dat
- `geoip:phishing`
Contains Phishing IP addresses.
- `geoip:malware`
Contains Active Malware IP addresses.
Categories in geoip-services.dat
- `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:cloudfront`
Contains the IP addresses of Cloudfront CDN.
- `geoip:fastly`
Contains the IP addresses of Fastly CDN.
- `geoip:gcore`
Contains the IP addresses of G-Core 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:netflix`
Contains the IP addresses of Netflix.
- `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:tor`
Contains the IP addresses of Tor exit nodes.
Categories in Country.mmdb
Same as `GeoIP` but in Maxmind's MMDB format.
Categories in Country-lite.mmdb
Same as `GeoIP Lite` but in Maxmind's MMDB format.
Categories in Security-IP.mmdb
Same as `Security-IP` but in Maxmind's MMDB format.
Categories in Services.mmdb
same as `GeoIP-Services` but in Maxmind's MMDB format.
## GeoSite
Categories in geosite.dat
- All categories from [domain-list-community](https://github.com/v2fly/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:category-ir`
Mirror of `geosite:ir` with inactive domains removed.
All IR domains get checked every 24 hours for inactive 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:sanctioned`
Contains a list of websites that sanctioned Iran.
Categories in geosite-lite.dat
- `geosite:ir`
Contains non-ir TLD Iranian domains (e.g. `.com` `.net` `.org` etc.) and rules to bypass all `.ir` domains.
- `geosite:category-ir`
Mirror of `geosite:ir` with inactive domains removed.
All IR domains get checked every 24 hours for inactive domains.
- `geosite:ads`
Contains a list of Persian advertisement and tracking domains.
Categories in security.dat
- `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.
# :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](https://github.com/Loyalsoldier/geoip) repository by [Loyalsoldier](https://github.com/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](https://github.com/v2fly/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:
1. Contribute to its upstream sources
Do you know a Domain that should be bypassed? report it to [Iran Hosted Domains](https://github.com/bootmortis/iran-hosted-domains)
Do you know a Persian advertisement domain that should be blocked or a false positive? report it to [PersianBlocker](https://github.com/MasterKia/PersianBlocker)
Do you know... OK, you got the idea!
2. 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](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](#sources) section for more details.
# :package: Sources
## GeoIP
| Source | Maintainer | Home Page | License | Category |
| ---------------------- | -------------------- | ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ | ----------------- |
| GeoLite2 | MaxMind | [Home Page](https://dev.maxmind.com/geoip/geolite2-free-geolocation-data) | [CC BY-SA 4.0](https://dev.maxmind.com/geoip/geolite2-free-geolocation-data#license) | Country IPs |
| IP2Location LITE | IP2Location | [Home Page](https://lite.ip2location.com/ip2location-lite) | [CC BY-SA 4.0](https://lite.ip2location.com/terms-of-use) | Country IPs |
| ITO GOV | ITO GOV | [Home Page](https://eservices.ito.gov.ir/Page/IPListMessenger) | N/A | ir(messenger IPs) |
| Arvan Cloud | Arvan Cloud | [Home Page](https://www.arvancloud.ir/en/dev/ips) | All rights reserved | arvancloud |
| Derak Cloud | Derak Cloud | [Home Page](https://derak.cloud/لیست-بازه-های-ip) | All rights reserved | derakcloud |
| IranServer | IranServer | [Home Page](https://docs.iranserver.com/irserver-cloud/cdn/allow-iranserver-ip-addresses) | All rights reserved | iranserver |
| ParsPack | ParsPack | [Home Page](https://parspack.com/cdnips.txt) | All rights reserved | parspack |
| Cloudflare | Cloudflare | [Home Page](https://www.cloudflare.com/ips) | All rights reserved | cloudflare |
| Cloudfront | Cloudfront | [Home Page](https://ip-ranges.amazonaws.com/ip-ranges.json) | All rights reserved | cloudfront |
| Fastly | Fastly | [Home Page](https://api.fastly.com/public-ip-list) | All rights reserved | fastly |
| G-Core | G-Core | [Home Page](https://api.gcore.com/cdn/public-ip-list) | All rights reserved | gcore |
| Netflix | Netflix | [Home Page](https://www.netflix.com) | All rights reserved | netflix |
| Telegram | Telegram | [Home Page](https://core.telegram.org/resources/cidr.txt) | All rights reserved | telegram |
| Tor | Tor Project | [Home Page](https://check.torproject.org/torbulkexitlist) | All rights reserved | tor |
| URLhaus | abuse.ch | [Home Page](https://urlhaus.abuse.ch) | [CC0](https://urlhaus.abuse.ch/api/#tos) | malware |
| Phishing URL Blocklist | malware-filter Group | [Home Page](https://gitlab.com/malware-filter/phishing-filter) | [MIT](https://gitlab.com/malware-filter/phishing-filter/-/blob/main/LICENSE) | phishing |
| IPRanges | lord-alfred | [Home Page](https://github.com/lord-alfred/ipranges) | [CC0 1.0](https://github.com/lord-alfred/ipranges/blob/main/LICENSE) | everything else |
## GeoSite
| Source | Maintainer | Home Page | License | Category |
| ---------------------- | --------------------- | --------------------------------------------------------------- | ------------------------------------------------------------------------------- | --------------- |
| Iran Hosted Domains | bootmortis | [Home Page](https://github.com/bootmortis/iran-hosted-domains) | [MIT](https://github.com/bootmortis/iran-hosted-domains/blob/main/LICENSE) | ir |
| PersianBlocker | MasterKia | [Home Page](https://github.com/MasterKia/PersianBlocker) | [AGPL-3.0](https://github.com/MasterKia/PersianBlocker/blob/main/LICENSE) | ads |
| DNS Blocklists | Hagezi | [Home Page](https://github.com/hagezi/dns-blocklists) | All rights reserved | ads |
| GoodbyeAds | jerryn70 | [Home Page](https://github.com/jerryn70/GoodbyeAds) | [MIT](https://github.com/jerryn70/GoodbyeAds/blob/master/LICENSE) | ads |
| AdGuard DNS filter | Adguard Team | [Home Page](https://github.com/AdguardTeam/AdGuardSDNSFilter) | [GPL-3.0](https://github.com/AdguardTeam/AdGuardSDNSFilter/blob/master/LICENSE) | ads |
| URLhaus | abuse.ch | [Home Page](https://urlhaus.abuse.ch) | [CC0](https://urlhaus.abuse.ch/api/#tos) | malware |
| Phishing URL Blocklist | malware-filter Group | [Home Page](https://gitlab.com/malware-filter/phishing-filter) | [MIT](https://gitlab.com/malware-filter/phishing-filter/-/blob/main/LICENSE) | phishing |
| NoCoin adblock list | hoshsadiq | [Home Page](https://github.com/hoshsadiq/adblock-nocoin-list) | [MIT](https://github.com/hoshsadiq/adblock-nocoin-list/blob/master/LICENSE) | cryptominers |
| Unified Hosts | StevenBlack | [Home Page](https://github.com/StevenBlack/hosts) | [MIT](https://github.com/StevenBlack/hosts/blob/master/license.txt) | social, nsfw |
| DynX-AntiBan-Domains | MrDevAnony | [Home Page](https://github.com/MrDevAnony/DynX-AntiBan-Domains) | [MIT](https://github.com/MrDevAnony/DynX-AntiBan-Domains/blob/main/LICENSE) | sanctioned |
| ir-sanctioned-domain | filteryab | [Home Page](https://github.com/filteryab/ir-sanctioned-domain) | All rights reserved | sanctioned |
| Domain list community | Domain list community | [Home Page](https://github.com/v2fly/domain-list-community) | [MIT](https://github.com/v2fly/domain-list-community/blob/master/LICENSE) | 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](https://github.com/v2fly)
- [Project X](https://github.com/XTLS)
- [Domain list community](https://github.com/v2fly/domain-list-community)
- [Loyalsoldier](https://github.com/Loyalsoldier)
