The main Bubble source repository. Contains the Bubble API server, the web UI, documentation and utilities. https://getbubblenow.com
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
Jonathan Cobb e3dd105f43 update docs 3 年之前
bin revert 3 年之前
bubble-server bump version 3 年之前
bubble-web @ 9ca1fa0309 fix web logout behavior 3 年之前
config update docs 3 年之前
docker fix repo override 3 年之前
docs update docs 3 年之前
utils update utils 3 年之前
.gitignore feature/shadowban_fb (#44) 4 年之前
.gitmodules move messsage resources to separate repo 4 年之前
Dockerfile update docs 3 年之前
LICENSE.md update license email, add mailto link 4 年之前
README.md update docs 3 年之前
pom.xml no more hard-coding UTF-8, detect the charset from the response and use that 4 年之前

README.md

Bubble: a privacy-first VPN

Bubble helps you start and manage your own private VPN.

It also adds tools to this VPN to improve your internet experience by modifying your traffic: to remove ads, block malware, and much more.

Visit the Bubble website to learn more.

If you’re interested in developing on Bubble, see the Bubble Developer Guide.

Operating System Support

Once your Bubble is running, any device can connect to it: Windows, Linux, Mac, iOS, Android; if it supports VPN connections, it will probably work just fine.

To launch your own Bubble using this software, you will need either:

  • A system with Docker installed, to run the Bubble Docker Launcher
  • A Mac or Linux system, to run the launcher and/or build from source

The Easy Path

If you’d like to enjoy all the benefits of Bubble without going through all this hassle, try launching a Bubble using GetBubbleNow.com.

Any Bubble you launch from GetBubbleNow.com will also be “yours only” -- all Bubbles disconnect from their launcher during configuration.

Getting Started

To self-launch your own Bubble, the Bubble Docker Launcher is the easiest way to get started.

If you’re feeling more adventurous, you can also run a binary distribution, or build Bubble from source.

Deployment Modes

Bubble runs in three different modes. You’ll at least need to run a Local Launcher first, then decide if you want to use a Remote Launcher to manage multiple Bubble nodes, or just launch a single Bubble directly from the Local Launcher.

Local Launcher Mode

In this mode, Bubble runs locally on your machine. You’ll setup the various cloud services required to run Bubble, and use the Local Launcher to start a Remote Launcher or a Bubble Node.

This is the mode that the Bubble Docker Launcher runs.

Learn more about setting up Local Launcher Mode

Remote Launcher Mode

In this mode, Bubble is running in the cloud in Launcher Mode, ready to launch new Bubbles that you can use. You cannot connect devices to a Bubble in Launcher Mode, you can only use it to launch new Bubbles.

Learn more about setting up Remote Launcher Mode

Bubble Node Mode

In this mode, the Bubble has been launched by a Local Launcher or a Remote Launcher and is a proper Bubble Node. You can connect your devices to it and use it as your own private VPN and enhanced internet service.

Learn more about launching a Bubble Node