Skip to content
Titanium Network

Holy Unblocker LTS

HolyUnblocker

Holy Unblocker LTS, an experimental web proxy service, can bypass web filters or ‘blockers’ regardless of whether the method of censorship is client-side or network-based. This includes the potential ability to bypass content blockers overseas, Chrome extensions, localized client firewalls, and network-related filters.

You can support Holy Unblocker by starring the repository!

This project serves mostly as a proof of concept for the ideal clientless solution to bypassing censorship. Being a secure web proxy service, it supports numerous sites while being updated frequently and concentrating on detail with design, mechanics, and features.

Works with a large number of sites, including YouTube, Discord, and more! Also has a good amount of locally hosted games featured on the site.

preview settings

Read below for information if the official site is blocked or for obtaining more links. Can’t deploy using any of the free options below? Check out Railway or look into cheap, paid VPS hosting solutions.

Be sure to join Titanium Network’s Discord for more official site links: https://discord.gg/unblock

Deploy Holy Unblocker

Free Deployments

Deploy to Koyeb Deploy to Oracle Cloud

How to Setup

Either use the button above to deploy to Koyeb/Oracle Cloud or do the below:

Terminal window
git clone https://github.com/QuiteAFancyEmerald/Holy-Unblocker
cd Holy-Unblocker
npm install
npm run start

The default place for the proxy when its started is http://localhost:8080, but you can change it if needed in /src/config.json.

This website is hosted locally with Ultraviolet and Rammerhead built-in.

Structure

  • index.html: The homepage of the site.
  • error.html: A general error page for all 404 errors and other errors.
  • info.html: Documentation (This page!)
  • faq.html: Frequently asked questions page.
  • hidden.html: Fake “Site not Found” page (unused)
  • frame.html: Handles any pages under stealth.
  • surf.html: Web Proxies page, page offers to be redirected to any proxies you would like to add. In this case, Ultraviolet and Rammerhead.
  • credits.html: List of all contributors to the site.
  • bookmarklets.html: Bookmarklets page, to be worked on more in the future.
  • icons.html: Information regarding Settings Menu page. Added this in for standard users.
  • terms.html: Terms of Services, AUP and Privacy Policy page.
  • gtools.html: Games page, help from @BinBashBanana and @kinglalu.
  • games5.html: HTML5 game navigation page.
  • emulators.html: Emulator navigation page, using webretro
  • emulibrary.html: Games page for emulated games (not included in public release)
  • flash.html: Games page for flash games, credits given to @BinBashBanana and Titanium Network for its assets.
  • ultraviolet.html: TODO
  • rammerhead.html: TODO
  • youtube.html: A proxied version of Youtube running off the locally hosted Ultraviolet.
  • discord.html: Hub for the Discord proxy.
  • reddit.html: Hub for the Reddit proxy.

Structure Information

  • /views/: The physical site base of Holy Unblocker goes here where static assets are served.
  • /src/: For future implementation of obfuscation and keyword removing features.

Details of /views/

  • /archive/ is used for game pages and vibeOS.
  • /pages/ is used for the HTML for the site.
  • /assets/ is used for storing various CSS, JS, image, and JSON files.

Scripts located in /views/assets/js/

  • bareTransport.js is a locally installed version of the bare transport module which allows Ultraviolet to function.
  • card.js adds a fancy visual effect to the box cards displayed on the welcome screen.
  • common.js is used on all pages and allows commonly used features to function.
  • csel.js manages the settings menu on the header.
  • particles.js is the animated background effect that’s present on all pages.
  • register-sw.js creates and manages service workers that allow Ultraviolet to function, and also uses bare transport.

Changelog

  • Added wisp support
  • Fixed AD config setting being opt-out; ads are not implemented in the project however
  • Added Rammerhead support (locally)
  • Drastically updated visuals across the service and refactored stylesheets
  • Bumped games page functionality
  • Updated randomization scripts to ES6 syntax and implemented the alternative to RegEx string replacement
  • Helmet for express implemented into backend
  • Improved component handling via templates.mjs along with deletion of obsolete files that previously handled this standard in a poor format
  • Fixed oddly slow speeds with Ultraviolet (as well as a general version bump to support epoxy-tls and bare-mux)
  • Implemented testing scripts for an improved GitHub actions workflow by doing a quick test on proxy + site functionality
  • Greatly optimized client-side scripts across the site with a new standard, and generally reworked to no longer leave global variables
  • Changes to server.mjs with path logic and error handling
  • Updated standards for common scripts
  • libcurl and bare-as-module support added
  • Deleted 5 JS scripts and moved lots of data into JSON files. Big reorganization. Games menu core scripts now nested inside of common.js utilizing a JSON system
  • Massive updates to the Settings menu visually and functionality wise; added Bare-Mux support for swapping transports to work with Ultraviolet, default icons and selective adblocking + Tor on any proxy instances
  • CSS Has been partially restructured for mobile support, and is now properly arranged into clearly labeled sections (for the most part)
  • Incorporated makeshift domain blacklisting functionality into Ultraviolet, currently used for blocking ads if ads are disabled in settings

Detailed FAQ

Quick FAQ

Where can I find the games for this repo? (404 errors, etc.)

Due to piracy concerns, size, etc. this has been moved over here. EmuLibrary is not featured in the public version.

Why is the site I am on not working correctly or having CAPTCHA errors?

Captcha support is currently not available on all of the current proxies sadly. Therefore some sites may not work with any of the sites. Read below for issues with links on sites.

I am getting 502 errors. What do I do?

When this happens you may either switch sites to fix the error or wait a bit. Sometimes clearing your cache can help.

If you still have any questions feel free to ask them in the discord linked here.

Why are official domains now numbered? Is this project maintained again?

Yes, this project is active again for LTS support! However, the approach is now much simpler to ensure functionality: traffic will be focused on a single domain. More than ever, this project serves as a proof of concept for the brave souls willing to innovate in the web proxy service space.

More Information

This project is maintained by the Holy Unblocker LTS team and is an official flagship Titanium Network web proxy site.

View the official website for more detail and credits.

Web Proxy Sources:

This project currently uses Ultraviolet, Wisp, Womginx, and Rammerhead, linked below.

Other Dependencies:

Notable Mentions: