f1rewall

The sleek, simple and scalable invite gateway for your Discord community

Made in

Officially supports

Optional supported technologies

F1rewall is a Discord invite gateway. It lets you easily route your Discord server invites through a controlled page with a captcha. It generates a unique, time limited one time invite for every user. Thanks to this, you can stop most bots from entering your server.

Light theme default	Dark theme default

All websites elements can be customised easily

Setup guide:

It is recommended to let your team's developer/sysadmin set this up.

This script was made for Linux/GNU, officially supported distributions are: debian, ubuntu, pop!_os, fedora and raspbian

The page is made to be easily editable by anyone with HTML/CSS/Bootstrap experience

0. Getting the code

run git clone https://github.com/MiranDaniel/f1rewall A folder called f1rewall-master with the source code has been created!

1. Creating the bot

Go to the Discord Developer Portal to create your bot. https://discord.com/developers/applications
Press "New Application" in the top right corner
Set a name, this can be anything (will be seen by server members)
Once created, click on your app in the app manager.
Head to the Bot section on left bar.
Press Add bot on the right.
Set the Public bot option to false.
Copy the token (MAKE SURE NOT TO LEAK THIS)
Paste your token in the config.yaml file, follow the instructions in it
Go back to the General information section and copy the app ID
Insert your ID here -> https://discord.com/oauth2/authorize?client_id=INSERT_CLIENT_ID_HERE&scope=bot&permissions=1
Visit the link and add the bot!

Congrats! Your bot is now ready!

2. Configuring the bot

Go to your Discord (app, not dev portal) settings Advanced section.
Enable developer mode
Right click the channel you want the bot to create invites to.
Copy channel ID
Paste your ID in the config.yaml file, follow the instructions in it

Congrats! Your bot is now configured!

3. Setting up ReCaptcha

Go to https://www.google.com/recaptcha/admin/create
Set a name for your app
Select "reCAPTCHA v2"
Add your domain
Accept the terms and submit
Paste your site key in the config.yaml file, follow the instructions in it
Paste your secret key in the config.yaml file, follow the instructions in it

Congrats! Your recaptcha is now ready!

4. Running

Run apt-get update -y && apt-get upgrade -y to update your packages
Run apt-get install python3-dev -y && apt-get install python3-venv -y to install the required dependencies for Python
Run sudo make to install all dependencies
Run sh run.sh to start the server
The script will now host your gateway on the port specified in config.yaml

Debugging

If you get the make: command not found error, run sudo apt-get install build-essential to install make.

Network configuration

1. Firewall configuration

Configure your firewall and open the port specified in config.yaml

2a. DNS configuration

Remember to set a static IP and host on port 80. If you want to stop the Apache server from running on port 80, use sudo systemctl stop apache2

Follow this guide to redirect your chat.<>.<> domain to your chat gateway. https://www.namecheap.com/support/knowledgebase/article.aspx/9776/2237/how-to-create-a-subdomain-for-my-domain/

You can also use the CloudFlare Argo Tunnel.

2b. CloudFlare tunnel configuration

Read the documentation file in docs/clouflare_tunnel.md

Discord configuration

Make sure the gateway works
Disallow users on your server from making new invites, let only the bot create them
Put your logo in static/wordmark.png
Put the website background in static/background.png
Set the dark_theme value in config.yaml to set the website text color

Customisation

Read the documentation file in docs/customisation.md

Support

If you're having issues with the app please open an issue or discussion thread.

Private support can be provided. Find the contact information on https://mirandaniel.com/

Donations <3

Ethereum: 0x20D3c078958A2b866F9F423a722aF5a92bc7e08b
Polygon: 0x20D3c078958A2b866F9F423a722aF5a92bc7e08b
Binance Smart Chain: 0x20D3c078958A2b866F9F423a722aF5a92bc7e08b
Monero: 42dN1SjyQNFMu3hPjJZqXa4Z8oMMLLiPzHmC4q8h3DXWS2gHxpjACxcWyAReJGqN4RX79VTE8pEn6SVxgjCJTXhg5ECB9Qe
Banano: ban_1aws637mb3qnuf9j8swzufq3nj3fttuzkixbd817nmmhyms6a6kt1zyptq87
Nano: nano_33k5ggoycqgft9on81kd8sqkdi4c38robs4jq9xmbd6j1wgfmqbukqym38ug

License

Copyright 2021-2022 MiranDaniel


The Software is provided to you by the Licensor under
the License, as defined below, subject to the following
condition.

Without limiting other conditions in the
License, the grant of rights under the License will not
include, and the License does not grant to you, the
right to Sell the Software.

For purposes of the
foregoing, “Sell” means practicing any or all of the
rights granted to you under the License to provide to
third parties, for a fee or other consideration
(including without limitation fees for hosting or
consulting/ support services related to the Software), a
product or service whose value derives, entirely or
substantially, from the functionality of the Software.
Any license notice or attribution required by the
License must also include this Commons Cause License
Condition notice.


THE SOFTWARE IS PROVIDED "AS IS",
WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT
OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH
THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

sambacha / f1rewall Goto Github PK

f1rewall's Introduction