mirror of
https://github.com/QuiteAFancyEmerald/Holy-Unblocker.git
synced 2025-05-13 12:00:02 -04:00
220 lines
No EOL
18 KiB
HTML
220 lines
No EOL
18 KiB
HTML
<!DOCTYPE html>
|
|
<html>
|
|
|
|
<head>
|
|
<meta charset="utf-8">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0, shrink-to-fit=no">
|
|
<!-- Important: Use ​ to mess with keywords. -->
|
|
<title>H​oly Unb​loc​ke​r</title>
|
|
<meta name="description" content="G​et p​ast in​te​r​net ce​n​s​or​sh​ip tod​a​y!
|
|
|
|
:D">
|
|
<link rel="icon" type="image/png" sizes="32x32" href="assets/img/i.png">
|
|
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:400,700,400italic">
|
|
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Montserrat+Alternates">
|
|
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Titillium+Web:400,600,700">
|
|
<link rel="stylesheet" href="assets/bootstrap/css/bootstrap.min.css">
|
|
<link rel="stylesheet" href="assets/fonts/ionicons.min.css">
|
|
<link rel="stylesheet" href="assets/css/styles.css">
|
|
<!-- Assets -->
|
|
<script src="https://cdn.jsdelivr.net/particles.js/2.0.0/particles.min.js"></script>
|
|
<script src="assets/js/jquery.min.js"></script>
|
|
<script src="assets/bootstrap/js/bootstrap.min.js"></script>
|
|
<script type="module" src="https://unpkg.com/ionicons@5.1.2/dist/ionicons/ionicons.esm.js"></script>
|
|
<script nomodule="" src="https://unpkg.com/ionicons@5.1.2/dist/ionicons/ionicons.js"></script>
|
|
<script src="assets/js/header.js"></script>
|
|
<script async src="https://arc.io/widget.js#2BzvQ1em"></script>
|
|
<!--<script src="assets/js/im-runtime.js"></script>-->
|
|
</head>
|
|
|
|
<body>
|
|
<div id="particles-js">
|
|
<script>
|
|
/* particlesJS.load(@dom-id, @path-json, @callback (optional)); */
|
|
particlesJS.load('particles-js', 'particles.json', function() {
|
|
console.log('particlesjs loaded.......');
|
|
});
|
|
</script>
|
|
<div>
|
|
<h1 id="holy-unblocker">Documentation</h1>
|
|
<p>A website that can be used to bypass web filters; both extension and firewall. This is the official documentation for Holy Unblocker, a rather fancy website with some cool dynamic backgrounds while also focusing with detail put into the design and mechanics overall. Also has cool features like custom Tab Cloaks and with more to come. Works on a large number of sites including YouTube (Full Quality Support), Discord, CoolMathGames and more! Be sure to check the various branches as I update Holy Unblocker often with open access to yet to be released versions.</p>
|
|
<p>Official Site: <a href="https://www.holyubofficial.net">https://www.holyubofficial.net</a></p>
|
|
<p>Be sure to join Titanium Network's Discord for more official site links: <a href="https://discord.com/invite/tgT48PH">https://discord.com/invite/tgT48PH</a></p>
|
|
<p><a href="https://heroku.com/deploy?template=https://github.com/QuiteAFancyEmerald/HolyUnblockerPublic" title="Deploy to Heroku"><img alt="Deploy to Heroku" src="https://raw.githubusercontent.com/QuiteAFancyEmerald/HolyUnblockerPublic/master/public/assets/img/heroku.svg?raw" width="140" height="30"><img></a>
|
|
|
|
<a href="https://azuredeploy.net/" title="Deploy to Azure"><img alt="Deploy to Azure" src="https://raw.githubusercontent.com/QuiteAFancyEmerald/HolyUnblockerPublic/master/public/assets/img/azure.svg?raw" width="140" height="30"><img></a>
|
|
|
|
<a href="https://repl.it/github/QuiteAFancyEmerald/HolyUnblockerPublic" title="Run on Repl.it"><img alt="Run on Repl.it" src="https://raw.githubusercontent.com/QuiteAFancyEmerald/HolyUnblockerPublic/master/public/assets/img/replit.svg?raw" width="140" height="30"><img></a>
|
|
|
|
<a href="https://glitch.com/edit/#!/import/github/QuiteAFancyEmerald/HolyUnblockerPublic" title="Remix on Glitch"><img alt="Remix on glitch" src="https://raw.githubusercontent.com/QuiteAFancyEmerald/HolyUnblockerPublic/master/public/assets/img/glitch.svg?raw" width="140" height="30"><img></a></p>
|
|
<h2 id="table-of-contents-">Table of contents:</h2>
|
|
<ul>
|
|
<li><a href="#how-to-install">Setup</a>
|
|
<ul>
|
|
<li><a href="#structure">Structure</a>
|
|
<ul>
|
|
<li><a href="#structure-information">Structure Information</a></li>
|
|
<li><a href="#details-of-public">Static Files</a></li>
|
|
<li><a href="#scripts-located-in-expr">Proxy Scripts</a></li>
|
|
<li><a href="#details-of-authjs">Cookie Auth</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a href="#future-additions">Future Additions</a></li>
|
|
<li><a href="#vauge-explanation-for-beginners-with-external-and-hosting">Beginner's Explanation</a>
|
|
<ul>
|
|
<li><a href="#list-of-some-good-hosting-options">Hosting Providers</a></li>
|
|
<li><a href="#heroku-steps">Heroku Setup</a></li>
|
|
<li><a href="#freenomdomain-steps">Domain Setup</a></li>
|
|
<li><a href="#cloudflare-steps">Cloudflare Setup</a></li>
|
|
<li><a href="#workspace-configurations">Workspace Configurations</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a href="#more-information">More Information</a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<h2 id="how-to-setup">How to Setup</h2>
|
|
<p>Either use the button above to deploy to Heroku or do the below:</p>
|
|
<pre><code>git <span class="hljs-keyword">clone</span> <span class="hljs-title">https</span>://github.com/QuiteAFancyEmerald/HolyUnblockerPublic.git
|
|
|
|
cd HolyUnblockerPublic
|
|
|
|
npm install
|
|
|
|
npm <span class="hljs-literal">start</span>
|
|
</code></pre>
|
|
<p>The default place for the proxy when its started is <code>http://localhost:8081</code> but you can change it if needed in config.json</p>
|
|
<p>This website has been hosted locally on Alloy Proxy. More more information go to the Alloy Proxy repo below.</p>
|
|
<h2 id="structure">Structure</h2>
|
|
<ul>
|
|
<li><code>index.html</code> : The official homepage of the site.</li>
|
|
<li><code>surf.html</code> : Surf Freely page, page offers to be redirected to either Alloy or Node.</li>
|
|
<li><code>alloy.html</code> : Alloy Proxy page, configured as recommended with Alloy Proxy.</li>
|
|
<li><code>node.html</code> : Links to a subdomain for Node Unblocker. I left it in just in case you would like to setup the site differently.</li>
|
|
<li><code>pmprox.html</code> : Links to a subdomain for Powermouse. I left it in just in case you would like to setup the site differently.</li>
|
|
<li><code>gtools.html</code> : Games page, help from @BinBashBanana and @kinglalu.</li>
|
|
<li><code>info.html</code> : WIP Documentation.</li>
|
|
<li><code>discordhub.html</code> : Hub for the discord proxy and its links.</li>
|
|
<li><code>discordprox.html</code> : Links to a discord proxied through Alloy.</li>
|
|
<li><code>pydodge.html</code> : Links to a subdomain with PyDodge B. Created by OlyB from a modified Via Proxy.</li>
|
|
<li><code>flash.html</code> : Games page for flash games, credits given to @BinBashBanana and Titanium Network for its assets.</li>
|
|
<li><code>icons.html</code> : Information regarding Settings Menu page. Added this in for standard users.</li>
|
|
<li><code>terms.html</code> : Terms of Services, AUP and Privacy Policy page.</li>
|
|
<li><code>gba.html</code> : Locally hosted Gameboy Emulator.</li>
|
|
<li><code>krunker.html</code> : An iframe version of Krunker with keyword changes. Can be removed if not needed.</li>
|
|
<li><code>youtube.html</code> : An proxied version of Youtube running off of the locally hosted Alloy Proxy.</li>
|
|
<li><code>ythub.html</code> : Page linking proxied Youtube.</li>
|
|
<li><code>ytmobile.html</code> : Page linking to a proxied YouTube for mobile users.</li>
|
|
<li><code>chatbox.html</code> : Links to an externally hosted Chatbox.</li>
|
|
<li><code>bookmarklets.html</code> : Page for Bookmarklets.<h3 id="structure-information">Structure Information</h3>
|
|
</li>
|
|
<li><code>/public/</code> : The physical site base of Holy Unblocker goes here. Do not delete or modify <code>/utils</code> as its needed for Alloy.</li>
|
|
</ul>
|
|
<h4 id="details-of-public-">Details of <code>/public</code></h4>
|
|
<ul>
|
|
<li><code>/pages/</code> is used for important pages for the site.</li>
|
|
<li><code>/expr/</code> is used for important proxy scripts.</li>
|
|
<li><code>/archive/</code> and <code>/css</code> is used for game related assets and pages.</li>
|
|
<li><code>/assets/</code> is used for various assets for CSS, JS and Bootstrap.</li>
|
|
<li><code>/vibeOS/</code> is used for vibeOS, an in-browser OS enviroment.</li>
|
|
</ul>
|
|
<h4 id="scripts-located-in-expr-">Scripts located in <code>/expr</code></h4>
|
|
<ul>
|
|
<li><code>[Proxy Initial]bp.js</code> is used for future implementation of Cookie Auth and navigation to external proxies. Must be located in the
|
|
|
|
<body> tag.</li>
|
|
<li><code>[Proxy Initial]load.js</code> is used for initializing the bp script(s). Must be located in the <code><head></code> tag.</li>
|
|
<li><code>d.html</code> is used for a locally running Discord proxy along with <code>dbp.js</code></li>
|
|
</ul>
|
|
<h4 id="details-of-auth-js-">Details of <code>auth.js</code></h4>
|
|
<ul>
|
|
<li>Will be used for the implementation of Cookie Authorization</li>
|
|
</ul>
|
|
<h2 id="future-additions">Future Additions</h2>
|
|
<ul>
|
|
<li>Cookie Authorization</li>
|
|
<li>Filters</li>
|
|
</ul>
|
|
<h2 id="vauge-explanation-for-beginners-with-external-and-hosting">Vauge Explanation for Beginners With External Proxies and Hosting</h2>
|
|
<p>You will first want to host your proxies locally or externally. </p>
|
|
<h4 id="list-of-some-good-hosting-options">List of some good hosting options:</h4>
|
|
<ul>
|
|
<li><a href="https://heroku.com">Heroku</a> (Free)</li>
|
|
<li><a href="https://nodeclusters.com">NodeClusters</a> (Paid)</li>
|
|
<li><a href="https://glitch.com">Glitch</a> (Free)</li>
|
|
<li><a href="https://repl.it">Repl.it</a> (Free)</li>
|
|
<li><a href="https://azure.microsoft.com/en-us/">Azure</a> (Free and Paid)</li>
|
|
</ul>
|
|
<p>Out of the list of hosting providers Heroku and NodeClusters rank first as a preference. You may also self-host. Currently at this time Azure is used to host the official Holy Unblocker sites.</p>
|
|
<p>After you have selected a decent VPS, use Cloudflare for the DNS records for both the site and the subdomains for the proxies.</p>
|
|
<p>This is an example of DNS records involving Heroku. Self-hosting will require <code>A records</code> preferably.
|
|
<img src="https://cdn.discordapp.com/attachments/725506757291671663/756659513179766844/unknown.png" width="500" height="154"></img></p>
|
|
<ul>
|
|
<li><code>a.deepsoil.ml</code> is being used for Node Unblocker.</li>
|
|
<li><code>p.deepsoil.ml</code> is being used for Powermouse.</li>
|
|
<li><code>pd.deepsoil.ml</code> is being used for PyDodge B.</li>
|
|
<li><code>cdn.deepsoil.ml</code> is being used for a private Alloy host on the official sites.</li>
|
|
</ul>
|
|
<p>As stated previously, Holy Unblocker is hosted locally with Alloy.</p>
|
|
<h4 id="heroku-steps">Heroku Steps</h4>
|
|
<p><strong>So use Heroku to host. I personally favor it as a free choice.</strong> </p>
|
|
<ul>
|
|
<li>First obtain a card; (Prepaid, Debit, and Credit Cards work). You need this to add custom domains to your Heroku instance.</li>
|
|
</ul>
|
|
<p>Make sure you connect your Heroku app to your GitHub and enable automatic deploys. Will make things easier. :) </p>
|
|
<h4 id="freenom-domain-steps">Freenom/Domain Steps</h4>
|
|
<p>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.</p>
|
|
<ul>
|
|
<li>Get some Freenom domains then add them to your Heroku instance (Personal > [App Name] > Settings > Domains)
|
|
Add a domain for both <code>www.youdomainhere.cf</code> and <code>yourdomainhere.cf</code> with .cf being interchangeable with other Freedom domain names.</li>
|
|
<li>If you prefer to obtain premium domains (TLDs) then use <a href="https://porkbun.com">Porkbun</a>, which offers domains for amazing prices. Literally a <code>.net</code> domain normally costs around $10. On Porkbun for the first year it costs $3 so its definitely a deal.</li>
|
|
</ul>
|
|
<h4 id="cloudflare-steps">Cloudflare Steps</h4>
|
|
<ul>
|
|
<li>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. </li>
|
|
</ul>
|
|
<p>Make sure they are CNAME although A records also work and try to follow this structure:</p>
|
|
<p><strong>Type | Name | Target</strong></p>
|
|
<p><code>CNAME | www | yourherokutargethere.herokudns.com</code>
|
|
<code>CNAME | @ | yourherokudnstargethere.herokudns.com</code></p>
|
|
<p><strong>Below are if you want external proxies also with your site:</strong></p>
|
|
<p><code>CNAME | a | yournodeinstance.herokudns.com</code>
|
|
<code>CNAME | pd | yourpydodgebinstancehere.herokudns.com</code>
|
|
<code>CNAME | p | yourpowermouseinstancehere.herokudns.com</code></p>
|
|
<p>Make sure HTTPS is forced and have SSL set to Flexible for Heroku. Otherwise you can have SSL set to Full.</p>
|
|
<h4 id="workspace-configurations">Workspace Configurations</h4>
|
|
<p>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 <a href="https://nodejs.org/">Node.JS</a> installed on your machine.</p>
|
|
<p>Not going to go too in depth with this part but first fork this repository. The 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.</p>
|
|
<pre><code>git <span class="hljs-keyword">clone</span> <span class="hljs-title">https</span>://github.com/QuiteAFancyEmerald/HolyUnblockerPublic.git
|
|
|
|
cd HolyUnblockerPublic
|
|
|
|
npm install
|
|
</code></pre>
|
|
<p>Now simply add the folder you cloned this repo in in VSC. Then run <code>npm install</code>. I recommend that if you are releasing this publically on GitHub that you add a <code>.gitignore</code> in your root directory with the following exclusions:</p>
|
|
<p><code>node_modules</code></p>
|
|
<p>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.</p>
|
|
<p>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.</p>
|
|
<ul>
|
|
<li>Make an account: <code>https://gitpod.io/</code></li>
|
|
<li>Fork this repo and enter in this URL to setup your workspace: <code>https://gitpod.io#https://github.com/YourNameHere/HolyUnblockerPublic/</code></li>
|
|
</ul>
|
|
<p>Use the same steps above by running <code>npm install</code> in your repository and adding a <code>.gitignore</code> in your root directory specifying to exclude <code>node_modules</code>.</p>
|
|
<h2 id="more-information">More Information</h2>
|
|
<p>This project uses Alloy Proxy, Node Unblocker, Powermouse and PyDodge which are linked below. Credits also given to Titanium Network and all it's developers as this project would not be possible without them. View the official website for more detail. :)</p>
|
|
<ul>
|
|
<li><a href="https://github.com/titaniumnetwork-dev/">https://github.com/titaniumnetwork-dev/</a></li>
|
|
<li><a href="https://github.com/titaniumnetwork-dev/alloyproxy">https://github.com/titaniumnetwork-dev/alloyproxy</a></li>
|
|
<li><a href="https://github.com/nfriedly/node-unblocker">https://github.com/nfriedly/node-unblocker</a></li>
|
|
<li><a href="https://github.com/vibedivide/powermouse">https://github.com/vibedivide/powermouse</a></li>
|
|
<li><a href="https://github.com/BinBashBanana/PyDodge">https://github.com/BinBashBanana/PyDodge</a></li>
|
|
<li><a href="https://github.com/juchi/gameboy.js">https://github.com/juchi/gameboy.js</a></li>
|
|
<li><a href="https://nodeclusters.com">https://nodeclusters.com</a></li>
|
|
<li><a href="https://titaniumnetwork.org/">https://titaniumnetwork.org/</a></li>
|
|
<li><a href="https://github.com/vibedivide/vibeOS">https://github.com/vibedivide/vibeOS</a></li>
|
|
</ul>
|
|
<p>Thanks.</p>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
<html> |