mirror of
https://github.com/QuiteAFancyEmerald/Holy-Unblocker.git
synced 2025-05-15 04:40:01 -04:00
Merge branch 'master' of https://github.com/QuiteAFancyEmerald/HolyUB
This commit is contained in:
TheEmeraldStarr
commit
23b3746ffa
2 changed files with 26 additions and 65 deletions
86
README.md
86
README.md
|
|
@ -1,78 +1,40 @@
|
||||||
# Alloy Proxy
|
# Holy Unblocker
|
||||||
|
A website that can be used to bypass web filters; both extension and firewall. This is the public source code for Holy Unblocker.
|
||||||
|
|
||||||
A node.js proxy that features URL encoding, and amazing compatablity!
|
[](https://heroku.com/deploy?template=https://github.com/QuiteAFancyEmerald/HolyUB/)
|
||||||
|
|
||||||
[](https://heroku.com/deploy?template=https://github.com/QuiteAFancyEmerald/HolyUB)
|
## How to Install
|
||||||
|
|
||||||
# How to install and use:
|
Either use the button above to deploy to Heroku or do the below:
|
||||||
|
|
||||||
`git clone https://github.com/titaniumnetwork-dev/alloyproxy.git`
|
`git clone https://github.com/QuiteAFancyEmerald/HolyUnblockerPublic.git`
|
||||||
|
|
||||||
`cd alloyproxy`
|
`cd HolyUnblockerPublic`
|
||||||
|
|
||||||
`npm install`
|
`npm install`
|
||||||
|
|
||||||
`npm start`
|
`npm start`
|
||||||
|
|
||||||
The default place for the proxy when its started is `http://localhost:8080` but feel free to change it in config.json!
|
The default place for the proxy when its started is `http://localhost:8080` but you can change it if needed in config.json
|
||||||
|
|
||||||
# How the proxy works:
|
This website has been hosted locally on Alloy Proxy. More more information go to the Alloy Proxy repo below.
|
||||||
|
|
||||||
The proxy works by using node-fetch (Basically Window.fetch ported to Node-js).
|
|
||||||
Basically what the app is doing is node-fetch is sending the request to the server then
|
|
||||||
the app sends the response back to the server with the modifactions made to the attributes and elements.
|
|
||||||
|
|
||||||
When a attribute is rewritten, depending on the contents inside. It will turn:
|
## Structure
|
||||||
|
- `index.html` : The official homepage of the site.
|
||||||
|
- `z.html` : Surf Freely page, redirectly to either Alloy or Node.
|
||||||
|
- `a.html` : Alloy Proxy page, configured as recommended with Alloy Proxy.
|
||||||
|
- `b.html` : Links to a subdomain for Node Unblocker. I left it in just in case you would like to setup the site differently.
|
||||||
|
- `g.html` : Games page, credits given to OlyB and Titanium Network for its assets.
|
||||||
|
- `k.html` : An iframed version of Krunker. Can be removed if not needed.
|
||||||
|
- `yt.html` : An iframe of Youtube running off of the locally hosted Alloy Proxy.
|
||||||
|
|
||||||
`href="/assets/js/main.js"` into `href="/fetch/websiteURL/assets/js/main.js"`.
|
## Future Additions
|
||||||
|
- Cookie Authorization
|
||||||
|
- Filters
|
||||||
|
|
||||||
A porition of its rewriting is in client-side JS so `Element.setAttribute`, `window.fetch()`, XMLHttpRequest, and more are rewritten.
|
This project uses Alloy Proxy and Node Unblocker, linked below. Credits also given to Titanium Network and all its developers as this project would not be possible without them. View the official website for more detail.
|
||||||
|
|
||||||
# Implementing your website in Alloyproxy
|
- https://github.com/titaniumnetwork-dev/
|
||||||
|
- https://github.com/titaniumnetwork-dev/alloyproxy
|
||||||
To implement your website into AlloyProxy. Upload all of your files into the `public` folder then your done. Avoid having the directory `alloy`
|
- https://github.com/nfriedly/node-unblocker
|
||||||
Since that might mess up script injection stuff.
|
|
||||||
|
|
||||||
# Things not to do
|
|
||||||
|
|
||||||
We recommend NOT to delete the `alloy` folder. It contains script injection and error pages. And don't tamper with any rewriting that adds script injection since script injection makes websites such as Discord and Youtube work more properly.
|
|
||||||
|
|
||||||
# Extra information:
|
|
||||||
|
|
||||||
If your gonna have an external website redirect to this proxy. Then we recommend you have the value base64 encoded and redirected to `/alloy?url=` then value.
|
|
||||||
|
|
||||||
# Deploying to Heroku:
|
|
||||||
|
|
||||||
If your gonna be hosting this on something like Heroku. You need to make sure SSL mode is turned off so this will work.
|
|
||||||
|
|
||||||
# Known websites that work
|
|
||||||
|
|
||||||
- Google Search
|
|
||||||
|
|
||||||
- Discord
|
|
||||||
|
|
||||||
- LittleBigSnake
|
|
||||||
|
|
||||||
- Surviv.io
|
|
||||||
|
|
||||||
- Youtube
|
|
||||||
|
|
||||||
- Y8
|
|
||||||
|
|
||||||
- 1v1.LOL
|
|
||||||
|
|
||||||
- Old Reddit
|
|
||||||
|
|
||||||
and plenty more!
|
|
||||||
|
|
||||||
# Known issues that need to be fixed
|
|
||||||
|
|
||||||
- Better POST body parsing instead of using body-parser.
|
|
||||||
|
|
||||||
- Cookie header rewriting
|
|
||||||
|
|
||||||
# Updates to come in the future
|
|
||||||
|
|
||||||
- Full URL encoding / encryption mode
|
|
||||||
|
|
||||||
- Websocket proxing
|
|
||||||
|
|
|
||||||
5
app.json
5
app.json
|
|
@ -1,7 +1,6 @@
|
||||||
{
|
{
|
||||||
"name": "Alloy Proxy",
|
"name": "Holy Unblocker",
|
||||||
"description": "A node.js web proxy featuring URL encoding, and amazing compatablity!",
|
"description": "A website that can be used to bypass web filters; both extension and firewall. Hosted on Alloy Proxy. Node Unblocker hosted externally.",
|
||||||
"repository": "https://github.com/QuiteAFancyEmerald/HolyUB/",
|
"repository": "https://github.com/QuiteAFancyEmerald/HolyUB/",
|
||||||
"logo": "https://avatars1.githubusercontent.com/u/47227492?s=200&v=4",
|
|
||||||
"keywords": ["node", "proxy", "unblocker"]
|
"keywords": ["node", "proxy", "unblocker"]
|
||||||
}
|
}
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue