Mastodon¶

In dit artikel

• Mastodon. Belangrijkste functies
• Implementatiefuncties
• Aan de slag na het implementeren van Mastodon
• Configuratiewijziging
• Het wijzigen van de Mastodon Server Domain Name
• Initiële instellingen van het beheerderspaneel
• Het beheren van serverregels
• Gebruikers uitnodigen
• Een server met Mastodon bestellen via de API

Mastodon. Belangrijkste functies¶

• Mastodon stelt gebruikers in staat om zich te abonneren op en te communiceren met andere gebruikers van elke verbonden server;
• Het platform biedt openbare postfeeds om gebruikers te helpen interessante inhoud te ontdekken. De lokale feed toont berichten van jouw server, terwijl de federated feed alle openbare berichten van geabonneerde gebruikers van jouw server toont die bekend zijn bij jouw server;
• Gebruikers kunnen direct in de feed of in de geavanceerde postweergave reageren op berichten door te antwoorden, te delen, toe te voegen aan favorieten, te bladwijzeren of een aanvullend menu te gebruiken;
• Mastodon stuurt meldingen voor verschillende interactie-events gerelateerd aan jouw profiel en berichten. Deze meldingen kunnen worden gefilterd op type;
• Om je op een gebruiker te abonneren, klik je simpelweg op de Follow knop op hun profiel. Je kunt ook meldingen inschakelen voor nieuwe berichten van je abonnementen; De zoekfunctie in Mastodon stelt je in staat om gebruikers, hashtags en berichten via een link te vinden. Met geïnstalleerde volledige tekstzoekopdracht kun je je eigen berichten en favorieten doorzoeken;
• Privéberichten in Mastodon zijn alleen zichtbaar voor abonnees. Ze worden weergegeven in een aparte dialoogkolom;
• De abonnementslijsten kunnen worden gebruikt om uitsluitend de postfeed te bekijken.

Implementatiefuncties¶

Aan de slag na het implementeren van Mastodon¶

Nadat u heeft betaald voor de bestelling, wordt er een melding naar het e-mailadres gestuurd dat tijdens de registratie is opgegeven, waarin staat dat de server klaar is voor gebruik. Deze bevat het IP-adres van de VPS, evenals de login en het wachtwoord voor de verbinding. Klanten van ons bedrijf beheren de hardware in de server en het API-beheerderspaneel — Invapi.

U kunt de autorisatiedata vinden in het tabblad Configuration >> Tags van het serverbeheerderspaneel of in de verzonden e-mail.

• Link om toegang te krijgen tot het Mastodon dashboard met een webinterface: in de webpanel tag;
• Login en Password voor het verbinden met de server: verzonden via e-mail naar uw adres zodra de server klaar is na de software-implementatie;
• Login and Password voor authenticatie in de Mastodon webinterface worden handmatig ingesteld tijdens de accountcreatie via de console van de beheerder.

De link om toegang te krijgen tot de webinterface zal zijn: https://mastodon{Server_ID_from_Invapi}.hostkey.in

Configuratiewijziging¶

Om de Mastodon-configuratie via de opdrachtregel te wijzigen, gebruikt u de utility's tootctl en rails:

• Accountinstellingen: maken, wijzigen, permissies toewijzen, enz.;
• SMTP-serverinstellingen;
• Gebruikersregistratie-instellingen.

Voorbeeldgebruik¶

1. Verbind met de server via SSH:

   ssh root@<server_ip>
   

2. Log in bij de Mastodon webapplicatie-container. Zoek en maak verbinding met de mastodon_web_1 container:

   docker exec -it mastodon_web_1 bash
   

3. Om een nieuwe gebruiker te maken, gebruikt u het commando tootctl accounts create. Specificeer de gebruikersnaam, e-mail en de --confirmed flag voor accountbevestiging.

   RAILS_ENV=production bin/tootctl accounts create new_username --email [email protected] --confirmed
   

   Vervang new_username door uw gewenste gebruikersnaam en [email protected] door het werkelijke e-mailadres van de gebruiker. Na het uitvoeren van dit commando wordt de gebruiker aangemaakt. Zorg ervoor dat u het wachtwoord dat op het scherm wordt weergegeven opslaat:

   

Administratieve rechten verlenen en gebruikers goedkeuren¶

Nadat u een gebruiker heeft aangemaakt, moet u deze in de database vinden om hun permissies en status te wijzigen.

1. Start de Rails-console:

   RAILS_ENV=production bin/rails console
   

2. Zoek de gebruiker via e-mail of gebruikersnaam:

   user = User.find_by(email: '[email protected]')  # of: User.find_by(username: 'new_username')
   

3. Update hun status:

   user.update(approved: true)
   

   Deze actie verwijdert de melding Your application is pending review by our staff... uit het admin-paneel.

4. Wijs hen een administratieve rol toe:

   user.update(role: UserRole.find_by(name: 'Admin'))
   

5. Verifiëren:

   user.reload
   

   user.role           # => "Admin"
   

   user.approved       # => true
   

6. De console afsluiten:

   exit
   

Configureren van de Mailserver¶

Als u de mailserver moet configureren of wijzigen, voer dan het volgende uit:

1. Open het configuratiebestand:

   nano /opt/mastodon/.env.production
   

   2. Configureer SMTP-parameters (bijv. voor MailHog):

   # Sending mail
   # ------------
   SMTP_SERVER=mailhog
   SMTP_PORT=1025
   SMTP_LOGIN=
   SMTP_PASSWORD=
   SMTP_FROM_ADDRESS=notifications@your_domain
   SMTP_AUTH_METHOD=none
   SMTP_OPENSSL_VERIFY_MODE=none
   SMTP_ENABLE_STARTTLS=false
   

   3. Mastodon containers herstarten: Om nieuwe instellingen toe te passen, herstart u de Mastodon containers:

   cd /opt/mastodon
   

   docker-compose restart
   

   4. E-mailfunctionaliteit controleren: - Voor MailHog: open de webinterface http://your_server:8025 - Logs controleren:

   docker-compose -f /opt/mastodon/docker-compose.yml logs sidekiq | grep -i mail
   

   - Testen: registreer een nieuwe gebruiker en controleer of de e-mail is ontvangen

 docker ps

Het wijzigen van de Mastodon Server Domain Name¶

Belangrijke bestanden en mappen¶

Volg deze stappen om de domeinnaam te wijzigen:

1. Registreer uw eigen domein, bijv. mastodon.mydomain.com.

2. Configureer DNS-records voor dit domein:

   • Stel een A-record in dat naar het IP-adres van de Mastodon-server verwijst;
   • Configureer een MX-record dat naar de mailserver verwijst.

   Informatie

   DNS Management

3. Voeg een PTR-record toe in de IP-adresinstellingen op Invapi; !!! info "Informatie" Lees meer over het instellen van PTR-records in Invapi hier.

4. Update de Mastodon Omgevingsvariabelen: Bewerk het bestand /opt/mastodon/.env.production en vervang de huidige waarde (bijv. mastodon<server_ID>.hostkey.in) door uw nieuwe domein:

   # Previous:
   # LOCAL_DOMAIN=mastodon<server_ID>.hostkey.in
   
   # Updated:
   LOCAL_DOMAIN=skaz.online
   WEB_DOMAIN=skaz.online
   

   5. Stel Nginx in met HTTPS-ondersteuning

   5.1 Maak een Nginx-configuratie aan Belangrijk: Maak een nieuw configuratiebestand aan en vervang het oude. Oude configuraties kunnen verschillende proxy_pass directives bevatten, wat tot storingen kan leiden. Maak een Nginx-configuratiebestand /data/nginx/user_conf.d/skaz.online.conf aan met de volgende inhoud:

   server {
       listen 80;
       server_name skaz.online;
       return 301 https://$host$request_uri;
   }
   server {
       listen 443 ssl;
       listen [::]:443 ssl;
       server_name skaz.online;
   
       # SSL certificates
       ssl_certificate         /etc/letsencrypt/live/skaz.online/fullchain.pem;
       ssl_certificate_key     /etc/letsencrypt/live/skaz.online/privkey.pem;
       ssl_trusted_certificate /etc/letsencrypt/live/skaz.online/chain.pem;
       ssl_dhparam /etc/letsencrypt/dhparams/dhparam.pem;
   
       # Main Mastodon application (port 3000)
       location / {
           proxy_set_header X-Forwarded-Proto https;
           proxy_set_header X-Forwarded-Ssl on;
           proxy_set_header Host $host;
           proxy_set_header X-Forwarded-Host $host;
           proxy_set_header X-Forwarded-Server $host;
           proxy_set_header X-Real-IP $remote_addr;
           proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
           proxy_pass http://127.0.0.1:3000;
           real_ip_header X-Forwarded-For;
           # WebSocket support
           proxy_http_version 1.1;
           proxy_set_header X-Scheme $scheme;
           proxy_buffering off;
       }
   
       # Mastodon Streaming API (port 4000)
       location ^~ /api/v1/streaming {
           proxy_set_header X-Forwarded-Proto https;
           proxy_set_header X-Forwarded-Ssl on;
           proxy_set_header Host $host;
           proxy_set_header X-Forwarded-Host $host;
           proxy_set_header X-Forwarded-Server $host;
           proxy_set_header X-Real-IP $remote_addr;
           proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
           proxy_pass http://127.0.0.1:4000;
           real_ip_header X-Forwarded-For;
           # WebSocket support
           proxy_http_version 1.1;
           proxy_set_header X-Scheme $scheme;
           proxy_buffering off;
       }
   }
   

   5.2 Verkrijg een SSL-certificaat Controleer of het certificaat aanwezig is:

   docker exec -it mastodon-nginx-1 ls /etc/letsencrypt/live/
   

   Als het certificaat ontbreekt, vraag het dan aan:

   docker compose stop nginx
   

   docker compose run --rm nginx certbot certonly --standalone -d skaz.online
   

   docker compose start nginx
   

5. Ruim conflicterende configuraties op

Belangrijk! Verwijder oude Nginx-configuraties, aangezien meerdere .conf bestanden conflicten kunnen veroorzaken: Verwijder de oude configuratie (bijv. voor mastodon<server_ID>.hostkey.in)

rm /data/nginx/user_conf.d/mastodon<server_ID>*.conf

mv /data/nginx/user_conf.d/mastodon<server_ID>.hostkey.in.conf /data/nginx/user_conf.d/mastodon<server_ID>.hostkey.in.conf.backup

Redenen voor conflicten:

• Dubbele listen 443 ssl directives veroorzaken de fout duplicate listen options
• Oude configuraties kunnen andere proxy_pass adressen of poorten hebben

• Nginx kan verzoeken met meerdere server blocks verkeerd interpreteren

• Diensten herstarten Voer in de map waar docker-compose.yml staat het volgende uit:

  docker compose down
  

  docker compose up -d
  

• Functionaliteit verifiëren Testen via de opdrachtregel

  curl -Ik https://skaz.online
  

  Verwachte reactie: HTTP/1.1 200 OK Controleren in een browser Open het domein in een browser — de Mastodon-startpagina moet laden.

Initiële instellingen van het beheerderspaneel¶

Om toegang te krijgen tot het beheerderspaneel, volgt u de link uit de webpanel tag, klikt u op de Log In knop en voert u de eerder ingestelde inloggegevens in.

Het beheren van serverregels¶

Administrateurs en moderators van elke individuele server in dit gedecentraliseerde sociale netwerk bepalen de regels voor Mastodon. Om regels te beheren, gaat u naar Administration >> Server Rules.

Basisprincipes voor het instellen van regels:

• Zorg ervoor dat regels redelijk zijn en voldoen aan algemeen aanvaarde normen van fatsoen om te voorkomen dat gebruikers worden afgeschrikt;
• Geef duidelijk de verboden soorten inhoud aan, zoals wreedheid, geweld en illegale activiteiten, en verduidelijk de acceptabele niveaus van NSFW-inhoud;
• Specificeer procedures voor het waarschuwen, blokkeren of beperken van regelovertreters, evenals disciplinaire maatregelen en tijdslimieten;
• De serverregels moeten gemakkelijk toegankelijk zijn voor alle gebruikers en publiekelijk worden weergegeven tijdens de registratie;
• Het is belangrijk om de regels periodiek te beoordelen en bij te werken naarmate de server groeit, en het betrekken van de community bij het modereren en verbeteren ervan.

Gebruikers uitnodigen¶

Mastodon heeft meerdere tabbladen in de feed voor het beheren van abonnementen en het uitnodigen van nieuwe gebruikers:

• Follows and Followers - dit tabblad toont de accounts waarop de huidige gebruiker is geabonneerd, en de feed zal berichten van deze gebruikers tonen. Daarnaast bevat dit tabblad de lijst met gebruikers die op dit account zijn geabonneerd, wat het publiek in Mastodon vormt.
• Invite people - deze functie stelt gebruikers in staat om vrienden en kennissen uit te nodigen voor hun sociale netwerk. Deze tekst beschrijft de creatie van een unieke link die gedeeld kan worden zodat andere gebruikers zich kunnen aansluiten bij de Mastodon-server.

.

Een server met Mastodon bestellen via de API¶

Volg deze instructies om deze software via de API te installeren.