/iran-hosted-domains

"Iran Hosted Domains" is a comprehensive list of Iranian domains and services that are hosted within the country.

Primary LanguagePythonMIT LicenseMIT

Iran Hosted Domains

Note

🚨 For safety reasons, it may be advisable to use a separate, non-personal account for your Github activity.

🚨 Ensure that your personal email address is not visible when you push commits to Github More info

A lot of services and domains are outside of Iran and they are restricted or blocked, for accessing this service you need to use VPN or proxies with tunneling option, apart from these problems, when we use proxies the domestic services are unavailable because our IP is not in Iran; for bypassing these issues we gathered a list of Iranian domains and services to help our people bypass this situation.

Disclaimer

This repository is a compiled list of public information about websites hosted in Iran. It is intended for informational purposes only and is not intended to provide guidance on how to connect to or create or manage a virtual private network (VPN). The content in this repository is provided as-is and we make no representations or warranties of any kind, express or implied, about the completeness, accuracy, reliability, suitability or availability of the information contained in this repository. Any reliance you place on such information is strictly at your own risk. We will not be liable for any errors or omissions in the information or for any losses, damages, or other liabilities that may arise from its use. Please use caution and consult with a qualified professional before using any information from this repository.

Usage

This can differ depending on which tool you use. You can download the domains list from the release page. In v2ray clients you can set Domain Resolution Strategy to IPIfNonMatch for better routing. more info.

Qv2ray

In the release section, you'll find the qv2ray_schema file.

  1. Download the file.
  2. open preferences and click on Advanced Route Settings.
  3. From the bottom of the screen, click on import schema....
  4. choose the downloaded file (qv2ray_schema.json).
  5. in the opened dialogue box, click on yes.
  6. Click on OK.

.dat file

It can be used in all v2fly, v2ray and xray clients.

  1. Download iran.dat file from here.

  2. Copy/Import file in your client. for example:

    • v2ray macOS: /usr/local/share/v2ray

  3. Add proper rules:

    • ext:iran.dat:ir in bypass section
    • ext:iran.dat:other in bypass section
    • ext:iran.dat:ads in block section

  4. Reconnect.

SagerNet

  1. Download iran.dat file from here.

  2. Import .dat file from Route -> Three dots -> Manage Route Assets:

  3. Add proper rules Route -> Create Route:

    • Block Ads:
      • domain: geosite:category-ads-all
      • outbound: Block
    • Block Iran Ads:
      • domain: ext:iran.dat:ads
      • outbound: Block
    • Bypass Iran .ir Domains:
      • domain: regexp:.+\.ir$
      • outbound: Bypass
    • Bypass Iran non .ir Domains:
      • domain: ext:iran.dat:other
      • outbound: Bypass
    • Bypass Iran geoip:
      • ip: geoip:ir
      • outbound: Bypass

for screenshots of routing settings click here.

  1. Reconnect.

Shadowrocket

  1. Download shadowrocket.conf file.
  2. Tap Import From Cloud in the Shadowrocket app and then import the file.
  3. Finally, tap on the shadowrocket.conf and select Use Config.

Clash (Like ClashX / clash_for_windows_pkg / Clash .NET / ...)

  1. Open your current profile/config that you use.
  2. Add these lines to the file:
rule-providers:
  iran:
    type: http
    behavior: classical
    url: "https://github.com/bootmortis/iran-hosted-domains/releases/latest/download/clash_rules.yaml"
    path: ./ruleset/iran.yaml
    interval: 432000
  1. Add this line to rules: section
  - RULE-SET,iran,DIRECT
  1. Save the file.
  2. Based on the client, you may need to set clash on Rule mode.

Nekoray

In the release section, you'll find the domains.txt file.

  1. Download the file.
  2. Open Program in the man page of nekoray.
  3. Open preferences and click on Routing Setting.
  4. Paste domains.txt file on domain-direct section.
  5. Press OK button and restart the app.

Create .dat file manually (Tutorial)

1. Install golang

It's important to install the right version. Always check it from v2fly/domain-list-community.

2. Clone v2fly/domain-list-community

git clone https://github.com/v2fly/domain-list-community

3. Prepare domains

In a .dat file, you can have as many distinct groups as you want. Each of these groups can be in bypass, proxy or blocked sections. Each group can have as many domains as you want.

Each group is a txt file containing domains. For example, you can have an ads.txt file containing ad domains.

4. Move files to /data

When cloning domain-list-community, you also clone all the groups that have been there before. Since you don't need them, delete everything in /data directory.

Now you have to copy your files to /data directory. Make sure to remove their file extension. So for example, ads.txt needs to be ads.

cd domain-list-community
rm data/*

cp ~/ads.txt data/ads

5. Run the program

go run ./ --outputdir=../

Files

  • iran.dat: Contains all websites hosted in Iran and ADs in a special format.
  • domains.txt: Contains all websites hosted in Iran.
  • qv2ray_schema.json: Importable json schema that can be used in Qv2ray.
  • shadowrocket.conf: Importable conf file that can be used in Shadowrocket.

Sources & Acknowledgements

If you know of any other source, or you found a website that isn't here, please open an issue or add that specific website to custom_domains.py and make a PR.

How does it work?

A Python script is executed by Github Action and generates files that are on the release page.