BlackWeb includes several configuration files that allow you to customize blocking behavior, whitelist essential domains, and fine-tune your Squid-Cache setup.
Use this file to exclude essential domains or subdomains from blocking. This is critical for services that might be incorrectly flagged.Location:/path_to/allowdomains.txtPurpose: Whitelist domains that should never be blocked, even if they appear in BlackWeb.Example content:
.accounts.youtube.com
According to Squid’s documentation, subdomains like accounts.google.com and accounts.youtube.com may be used by Google for authentication. Blocking them could disrupt Gmail, Drive, Docs, and other services.
Use this file to block additional domains not included in blackweb.txt.Location:/path_to/blockdomains.txtPurpose: Add custom domains to block that aren’t in the main BlackWeb list.Example content:
Use this file to block entire top-level domains (TLDs) including gTLD, sTLD, and ccTLD.Location:/path_to/blocktlds.txtPurpose: Block all domains under specific TLDs known for spam, phishing, or malicious content.Example content:
## GENERIC TOP LEVEL DOMAIN (gTLD)# Spam & Malicious TLDs by Cloudflare# https://blog.cloudflare.com/top-level-domains-email-phishing-threats.accountant.autos.bar.beauty.best.bet.bid.bio.boats.buzz.cam.center.cf.cfd.christmas.click.country.cricket.cyou.date.directory.ee.faith.fun.ga.gdn.gq.hair.homes.host.icu.info.ink.ir.kim.lat.life.link.live.lol.ltd.makeup.men.ml.mobi.mom.monster.ninja.one.online.party.pics.pro.pw.racing.realtor.rest.review.sbs.science.services.shop.site.skin.space.stream.tattoo.tk.today.top.uno.wang.wf.wiki.win.work.world.xyz.yachts.zip# TLDs Abused (Based on Reputation Block Lists RBLs).adult.beer.bingo.camera.cash.casino.channel.chat.cheap.club.download.entertainment.fan.fm.game.games.guru.lotto.market.marketing.markets.media.meet.meme.money.mov.movie.music.photo.photos.pictures.play.poker.porn.promo.pub.radio.rocks.sex.sexy.social.song.store.tube.tv.video.vodka.watch.webcam.wtf.xxx## COUNTRY CODE TOP LEVEL DOMAIN (ccTLD) (Optional)# Financial Action Task Force FATF-GAFI / OFAC's Sanctions List# https://www.fatf-gafi.org/en/countries/black-and-grey-lists.html#.by#.cn#.cu#.et#.iq#.kp#.lb#.ly#.ni#.rf#.ru#.ss#.su#.sy#.ye#.zw
With .xxx, .adult, .porn, and .ru in blocktlds.txt, output:
.foodomain.com
All domains with blocked TLDs are automatically denied.
Blocking country-code TLDs (ccTLDs) like .ru or .cn may block legitimate websites. Use with caution and uncomment only if required by your security policy.
Use this file to block streaming domains not included in blackweb.txt.Location:/path_to/streaming.txtPurpose: Block video streaming services like YouTube, Facebook Video, TikTok, Netflix, etc.Example content (first 20 lines):
Internal whitelist used during the BlackWeb update process to exclude false positives.Location:bwupdate/lst/debugwl.txtPurpose: Prevents essential domains from being added to BlackWeb during the update process.Partial content (first 50 lines):
Punycode domains starting with xn-- represent non-ASCII characters. Attackers use them for homograph attacks where visually similar characters create fake domains:
