| src | ||
| views | ||
| .gitignore | ||
| .gitmodules | ||
| .gitpod.yml | ||
| app.js | ||
| app.json | ||
| config.json | ||
| LICENSE | ||
| package.json | ||
| README.md | ||
Holy Unblocker 
Titanium Network is sponsored by:
Holy Unblocker, an official flagship Titanium Network site is a website that can be used to bypass web filters regardless if its an extension or network based. This is the public source code for Holy Unblocker, a rather fancy website with some cool dynamic backgrounds while also focusing with detail put into the design, mechanics and features overall like custom Tab Cloaks with more to come in the future.
Works with a large number of sites including YouTube, Discord and more! Be sure to read below for information if the official site is blocked or for obtaining more links.
YouTube has specialized support with the ablity to view steams, comments, bypass restricted mode, and have full quality on videos.
Be sure to check the various branches as I update Holy Unblocker often with open access to yet to be released versions.
Also has a good amount of locally hosted games featured on the site.
Supports
- Youtube.com
- Discord.com
- Google.com
- Reddit.com
- Bing.com
- And more!
Be sure to join Titanium Network's Discord for more official site links: https://discord.gg/unblock
Simply do %proxy hu for more Holy Unblocker links on the Titanium Network Discord server.
Official Site: https://www.holyubofficial.net
Site Documentation: Documentation
Table of contents:
How to Setup
Either use the button above to deploy to Heroku or do the below:
$ git clone https://github.com/QuiteAFancyEmerald/HolyUnblockerPublic.git
$ cd HolyUnblockerPublic
$ npm install
Afterwards run:
$ npm start
For more detailed documentation on workspace setup please view this.
The default place for the proxy when its started is http://localhost:8080 but you can change it if needed in config.json
This website has been hosted locally on Alloy Proxy. More more information go to the Alloy Proxy repository below.
Structure
index.html: The official homepage of the site.surf.html: Web Proxies page, page offers to be redirected to any proxies you would like to add. In this case Alloy, Womginx, Powermouse and Via Unblocker.alloy.html: Official Alloy Proxy page which features Alloy hosted locally but can be configured to redirect to an external instance.womginx.html: Womginx Proxy page. Script links to a subdomain for Womginx, a highly fast proxy with captcha support.pmprox.html: Powermouse Proxy pagge. Script links to a subdomain for Powermouse, a flexible secondary proxy compared to Alloy with support for Discord.pydodge.html: Via Unblocker page. Links to a subdomain with PyDodge or Via, a proxy which successes Node Unblockeryoutube.html: An proxied version of Youtube running off of the locally hosted Alloy Proxy.discordhub.html: Hub for the Discord proxy and its links using a mixture of Alloy, Womginx and Ocean Proxy.gtools.html: Games page, help from @BinBashBanana and @kinglalu.flash.html: Games page for flash games, credits given to @BinBashBanana and Titanium Network for its assets.emulators.html: Emulator navigation page, hosted locally on Holy Unblocker.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.info.html: Official Documentation page. To be worked on.terms.html: Terms of Services, AUP and Privacy Policy page.
Deprecated
I left all of these just in case you would like to setup the site differently as surf.js can be used instead.
ythub.html: Page linking proxied Youtube.ytmobile.html: Page linking to a proxied YouTube for mobile users.discordprox.html: Links to a discord proxied through Alloy.gba.html: Locally hosted Gameboy Emulator.chatbox.html: Links to an externally hosted Chatbox.krunker.html: An iframe version of Krunker with keyword changes. Can be removed if not needed.
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/
/pages/is used for important pages for the site./expr/is used for important proxy scripts./archive/is used for game related assets and pages./assets/is used for various assets for CSS, JS and Bootstrap./vibeOS/is used for vibeOS, an in-browser OS enviroment.
Scripts located in /expr
surf.jsis used for proxy navigation; both Stealth mode and Classic mode.h5-nav.jsis used for navigation on the games page, Stealth mode only.surf-dev.jsis used for proxy navigation on the official sites.load.jsis used for initializing the surf script. Must be located in the<head>tag. To be removed.
Future Additions
- Expand the game library.
- Go through various parity changes.
- Cleanup the source a bit.
- Add more locally hosted proxies possibly.
Vauge Explanation for Beginners With External Proxies and Hosting
You will first want to host your proxies locally or externally. Note that an older version of Alloy proxy is the only proxy that is hosted locally with this distribution of Holy Unblocker.
Proxies which you will need for a full setup for Holy Unblocker:
(Womginx) - https://github.com/binary-person/womginx (SysYA Proxy) - https://github.com/sysce/proxy (Via Unblocker/PyDodge: The source used for this proxy on the official sites is not public sadly.) - https://github.com/BinBashBanana/PyDodge or (Alloy Proxy: Latest version) - https://github.com/titaniumnetwork-dev/alloy
List of some good hosting options:
- Dedipath (Paid and Dedicated)
- Heroku (Free)
- NodeClusters (Paid)
- Glitch (Free)
- Repl.it (Free)
- Azure (Free and Paid)
Out of the list of hosting providers Heroku and Dedipath rank first as a preference. You may also self-host. Currently at this time Dedipath is used to host the official Holy Unblocker sites.
After you have selected a decent VPS, use Cloudflare for the DNS records for both the site and the subdomains for the proxies.
This is an example of DNS records involving Heroku. Self-hosting will require A records preferably.
The configuration being used on the official sites currently are the below:
a.example.comis being used for Womginx.c.example.comis being used for SysYA Proxy, Via Unblocker and the Chatbox.cdn.example.comis being used for a private, updated Alloy instance.
Heroku Steps
So use Heroku to host. I personally favor it as a free choice.
- First obtain a card; (Prepaid, Debit, and Credit Cards work). You need this to add custom domains to your Heroku instance.
Make sure you connect your Heroku app to your GitHub and enable automatic deploys. Will make things easier. :)
Freenom/Domain Steps
For beginners, Freenom is a good provider for obtaining domains for free. However the catch is that you can only use properly "Freenom" domains for free being .cf, .ml, .gq, ga and .tk. However these can be blocked rather easily.
- Get some Freenom domains then add them to your Heroku instance (Personal > [App Name] > Settings > Domains)
Add a domain for both
www.youdomainhere.cfandyourdomainhere.cfwith .cf being interchangeable with other Freedom domain names. - If you prefer to obtain premium domains (TLDs) then use Porkbun, which offers domains for amazing prices. Literally a
.netdomain normally costs around $10. On Porkbun for the first year it costs $3 so its definitely a deal.
Cloudflare Steps
- Use Cloudflare (make an account), add your site (Freenom Domain or Domain) and then add your various DNS targets to Cloudflare. Make sure you add Cloudflare's Nameservers which will be specified more when you are adding your site.
Lastly for targets make sure they are either a CNAME, AAAA or A records and try to follow this structure:
Type | Name | Target
CNAME | @ | yourherokudnstargethere.herokudns.com or CNAME | @ | example.com
CNAME | www | yourherokutargethere.herokudns.com or CNAME | www | example.com
Below are if you want external proxies also with your site:
CNAME | a | yourwomginxinstance.herokudns.com or CNAME | a | example.com
CNAME | c | yourpowermouseinstancehere.herokudns.com or CNAME | c | example.com
(You get the idea.)
Make sure HTTPS is forced and have SSL set to Flexible for Heroku. Otherwise you can have SSL set to Full. Use LetsEncrypt for SSL certificates or Cloudflare.
Workspace Configurations
Preferably if you have your own device use Visual Studio Code. Pretty much the best option you can get but obviously this is an opinion. Also make sure you have Node.JS installed on your machine.
Not going to go too in depth with this part but first fork this repository. Then clone it locally through a terminal of some sort depending on what OS you are on. Make sure you navigate to the folder you want to set this up in.
$ git clone https://github.com/QuiteAFancyEmerald/HolyUnblockerPublic.git
$ cd HolyUnblockerPublic
$ npm install
Setup pm2 (Optional - Node.js Process Manager)
$ npm install pm2@latest -g
$ pm2 start app.js
Useful pm2 Flags
# Specify an app name
--name <app_name>
# Watch and Restart app when files change
--watch
# Set memory threshold for app reload
--max-memory-restart <200MB>
For more information view the official pm2 documentation here.
Workspace Setup (continued)
Now simply add the folder you cloned in VSC. Then run npm install. I recommend that if you are releasing this publically on GitHub that you add a .gitignore in your root directory with the following exclusions:
node_modules
Now you have your following workspace environment setup. To deploy the following workspace you just created you will need to look up depending on your hosting provider.
For an online IDE that you can use on your school computer and/or chromebook use GitPod. Basically the equivalent of Visual Studio Code but with in-browser support.
- Make an account:
https://gitpod.io/ - Fork this repo and enter in this URL to setup your workspace:
https://gitpod.io#https://github.com/YourNameHere/HolyUnblockerPublic/
Use the same steps above by running npm install in your repository and adding a .gitignore in your root directory specifying to exclude node_modules.
Detailed FAQ
A detailed FAQ with common issues and solutions can be found at here or on any official HU site on the FAQ page.
Why are YouTube videos not working?
If you are having persistent issues even after doing the steps above there is a chance that the instance is down temporarily, especially if large groups of people are also having the issue. The latest release of Alloy currently does not have support for YouTube. However manually putting in full links like https://www.youtube.com/watch?v=mauV2NdCs60 will work. You may also try doing a Hard Reload (Ctrl+Shift+R)
A later release of Alloy may fix this issue. Sorry.
Why is the site I am on not working correctly or having CAPTCHA errors?
Captcha has limited support on Womginx. However support is not available on some of the older proxies sadly. Therefore some sites may not work with any of the sites. Read below for issues with links on sites.
Why are page links not working or leading to 404 pages?
This is an issue with the latest release of Alloy proxy but it may also occur with other proxies. In this case manually entering the URL of the page you would like to view can solve this or try navigating using the home button. (Reddit, Twitter) The next release of Alloy may fix this also.
When using YouTube on any of the proxy sites, why does the page not load fully or the video is just white?
There are two methods for fixing this:
- Reloading the page normally when the error above happens should load the video.
- Or right-clicking the page and doing Reload Frame if you are using some form of Stealth Mode.
When using Discord under Alloy or Powermouse, why does the page stay gray/white or the QR code not load? Womginx now support logging in normally for Discord. However here are the steps related to Alloy troubleshooting.
Note that this is for the older discord proxy steps with Alloy and Powermouse.
On the official sites, I am getting 502 errors. What do I do?
The proxy may be down, being worked on or is under high load.
When this happens you may either switch sites to fix the error or wait a bit. Sometimes clearing your cache can help by doing Ctrl+Shift+R or reloading the page normally. (Hard Reload which purges cache.)
More Information
This project is maintained by Quite A Fancy Emerald and is an official flagship Titanium Network proxy site.
View the official website for more details or credits.
Proxy Sources:
This project uses Alloy Proxy, Womginx, SysYA Proxy and Via Unblocker which are linked below.
- https://github.com/titaniumnetwork-dev/alloy (Alloy)*
- https://github.com/binary-person/womginx (Womginx)
- https://github.com/sysce/proxy (SysYA Proxy)
- https://github.com/hypothesis/via (Via)**
- https://github.com/BinBashBanana/PyDodge (PyDodge)**
- https://github.com/nfriedly/node-unblocker (Node Unblocker)***
Notable Mentions:
- https://dedipath.com (Hosting Provider)
Footnotes:
- This distribution of Holy Unblocker uses an older version of Alloy Proxy.
- The official Holy Unblocker sites used a private, modified version of Via and also goes under the name PyDodge for any modified version of it.
- Node Unblocker is no longer used on any of the official Titanium Network flagship sites.
Thanks.