Nebula

NebulaWeb is an official flagship of Nebula Services and Nebula Developer Labs. NebulaWeb is a stunning, sleek, and functional web-proxy with support for thousands of popular sites. With NebulaWeb, the sky is the limit.

Features

• Stunning and highly functional UI with multiple themes
• XOR/b64 encoding all traffic
• Hides your IP from sites
• List of officially supported sites
• limited mobile support
• Stealth Mode (buffed about:blank cloaking)
• NEW Clickoff cloaking
• NEW Email OTP verification

Deployment

Table of contents

• Quick & easy deployment
• Deployment configuration explaination
• how to use email OTP Verification mode
• Advanced Deployment
• Filesystem

Quick & Easy Deployment Options

---

Deployment Configuration Guide

(Example configuration with none-json notes)

{ 
  "verification": false, // disabled by default 
  "api_key":" Your sendgrid API key used to access your account from the API to send emails",
  "sendFromEmail":"The email that will send the one time password (MUST BE VERIFIED IN SENDGRID)",
  "type": "code", // DO NOT TOUCH
  "email": " The email you want to use for recieving OTP "
}

Email Verification OTP

What is this?

Email verification is a new and unique feature that we’ve implemented in the event that someone wants to keep their deployment of Nebula private and secure.

What does it do

When a user tries to access the website, before allowed access they will be asked for a One time password sent to an email set in the deployment configuration. Once verified, they will have 15 day access to the site.

• Firstly, We need to enable verification within the deployment configuration
  • change "verification":false, to "verification":true,
  • Note: You have to reboot the node app for any changes to take place.
• Now, we need to use an api to send a message
  • Make an account at Sendgrid (https://app.sendgrid.com/)
  • Note: It is likely that other versions of Nebula will use a different package to send emails.
• Verify the email you want to recieve emails from (Create a sender identity)
  • Go to settings -> Sender authentication and click Verify a Single Sender
• Now, We need to get the API key to connect to the API
  • Go to settings -> API Keys -> and make an API key.
• Complete the information in the deployment config deployment.config.json such as:

Advanced Deployment

Initial configuration

credits to @ProgrammerIn-wonderland for writing this wonderful tutorial (which can also be found in the docs :)

• Create an account at https://www.cloudflare.com/
• Create an account at https://www.freenom.com/ (or any registrars)
• Find a free domain name at Freenom
• Click checkout
  • Select (12 Months @ FREE)
  • Select “Use DNS”
    • Select Use your own DNS
• Go to cloudflare, click add new site, and enter the free domain name
• Select “Free Plan”
• Click continue, ignore DNS
  • Copy the name servers cloudflare gives you
• Go back to your Freenom tab, enter in the name servers which cloudflare gave you
  • You can keep IP blank
• Click continue
• Click complete order
• Go back to cloudflare tab, click “Check Nameservers”
• Select DNS on your right bar
• Enter in the IP of the server which will be hosting Nebula
  • Target will be @
• Click Enable proxy (little gray cloud icon, if active its orange)
• Select SSL/TLS in your right bar
• Click “Flexible”

---

Server configuration

• SSH into the server you’ll be using, I’ll assume its running Ubuntu 22.04 (though the commands are the same for debian 10+ versions, and Ubuntu versions 20.04+)
• run

  curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - \ &&
  sudo apt-get install -y nodejs npm
  git clone https://github.com/NebulaServices/Nebula.git
  cd Nebula
  npm i
  npm ci
  sudo nohup PORT=80 node . &
  

Make sure your firewall is configured to let through port 80 traffic!
Note: Server will need to run cd Nebula && sudo nohup PORT=80 node . & on reboot

File Structure

| File | Purpose | | |———————————-|———————————————————————————————————-|—| | static/index.html | The main frontend visuals for NebulaWEB. | | | static/unv.html | The verification-required frontend/visuals. | | | static/options/ | The frontend for Nebula’s options, settings, and preferences. | | | static/resources/v.js | Client verification system for the OTP system. | | | static/resources/nebulamain.js | All of the DOM/client code for NebulaWEB. Includes options, themeSystem, cloak, stealthengine, and more. | | | app.js | The backend server for Nebula. Contains Nodestatic, Bare, HTTP, and more. | |

Tech Stack

• HTML, JS, CSS
• Partical.JS (Specifically v4, 5, 6.1 &< only)
• UV Backend Proxy
• Osana Backend Proxy
• TompHTTP Bare Server
• node HTTP (No ExpressJS!)

Support

For support, email chloe@nebula.bio or join our discord: discord.gg/unblocker

Demo

Click here to see a demo of Nebula

Acknowledgements

• UV (one of the back-end proxy we use)
• Osana (one of the back-end proxy we use)
• Bare Server
• Partical.JS (v4, 5, 6.1 &< only)

License

(Nebula’s license is now GNU AGPL V3 as of v7.10) Copyright Nebula Services 2021 - Present
This project uses the AGLP GNU V3 license.