70 lines
No EOL
3.4 KiB
Markdown
70 lines
No EOL
3.4 KiB
Markdown
|
|
<h1 align="center">
|
|
<img src="https://gitlab.com/guardianproject/public-content/guardianprojectpublic/-/raw/master/Graphics/GuardianProject/pngs/logo-color-w512.png?ref_type=heads" alt="Guardian Project">
|
|
</h1>
|
|
|
|
<h2 align="center">bootbridge</h2>
|
|
<p align="center">
|
|
A command line tool to bootstrap a Tor bridge
|
|
<i>(not to be confused with <a href="https://gitlab.torproject.org/tpo/anti-censorship/bridgestrap">bridgestrap</a>).
|
|
</i>
|
|
</p>
|
|
<p align="center">
|
|
<img
|
|
alt="Language: Python"
|
|
src="https://img.shields.io/badge/lanuage-python-3178c6?style=flat-square">
|
|
<a href="https://opensource.org/licenses/BSD-2-Clause">
|
|
<img alt="Licence: BSD 2-Clause" src="https://img.shields.io/badge/license-bsd%202--clause-orange?style=flat-square">
|
|
</a>
|
|
<img alt="Lifecycle: Experimental" src="https://img.shields.io/badge/lifecycle-experimental-339999?style=flat-square">
|
|
<br>
|
|
<a href="https://guardianproject.dev/ops/bootbridge/issues">
|
|
<img alt="Issues" src="https://img.shields.io/gitea/issues/open/ops/bootbridge?gitea_url=https%3A%2F%2Fguardianproject.dev&style=flat-square">
|
|
</a>
|
|
<a href="https://opencollective.com/guardianproject">
|
|
<img alt="Open Collective backers and sponsors" src="https://img.shields.io/opencollective/all/guardianproject?style=flat-square">
|
|
</a>
|
|
</p>
|
|
|
|
---
|
|
|
|
### Purpose
|
|
|
|
You want to run many Tor bridges and would like to quickly bootstrap them from a fresh Debian installation.
|
|
|
|
### Requirements
|
|
|
|
* Debian stable VM fresh out of the box that won't be used for any other purpose
|
|
* Either:
|
|
* SSH access to that box
|
|
* Ability to give it cloud-init user data
|
|
|
|
### Caveats
|
|
|
|
* Many cloud providers now implement network firewalls outside the control of the operating system.
|
|
This is good for security in that if the virtual machine is compromised, it's not possible to change the firewall
|
|
rules, but it also means that you can't deliberately change the firewall rules from inside the virtual machine.
|
|
If your cloud has such a feature, it'll be up to you to configure that separately, perhaps with
|
|
[OpenTofu](https://opentofu.org/).
|
|
|
|
### Concept
|
|
|
|
|
|
|
|
### Copyright
|
|
|
|
Copyright © 2022-2025 SR2 Communications Limited.
|
|
|
|
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the
|
|
following conditions are met:
|
|
|
|
1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
|
|
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
|
|
|
|
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS “AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES,
|
|
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
|
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
|
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
|
|
WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
|
|
THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |