Ryfylke BBS web-admin manual

← Tjenester

På denne siden

Denne siden er for deg som driver en BBS. Det meste av driften gjøres i web-admin, uten å logge inn på maskinen BBS-en kjører på. Hvordan BBS-en brukes over radio står i brukermanualen.

Web-admin er på engelsk. Navnene på sider, knapper og felt står derfor på engelsk her, slik de vises i grensesnittet.

Innlogging og sikkerhet

Åpne http://<bbs-maskin>:8080 i nettleseren og logg inn som admin. Passordet vises på slutten av installasjonen. Bytt det med en gang under Settings → Admin password. Når du bytter passord, logges alle andre økter ut.

Viktig: Web-admin bruker vanlig HTTP, og den kan oppdatere og starte maskinen på nytt. Den skal derfor bare være tilgjengelig på et lukket nett eller via VPN, aldri åpent mot internett.

Glemt passordet? Legg linjen ADMIN_PASSWORD=<nytt passord> i /var/lib/meshbbs/config.env på BBS-maskinen og start BBS-en på nytt:

sudo systemctl restart meshbbs

Linjen i config.env går foran passordet i web-admin. Neste oppdatering flytter det inn i web-admin igjen, lagret som en hash.

Toppfeltet og radiostatus

Øverst står navnet på BBS-en og status for radioen:

Status Betyr
Radio online (grønn) BBS-en er koblet til companion-radioen
Radio connecting (gul) Kobler til eller prøver på nytt
Radio offline (rød) Ikke koblet til. BBS-en prøver igjen av seg selv

Sider merket LIVE oppdateres hvert 15. sekund. Oppdateringen venter mens en meny er åpen eller du skriver i et felt. Klokkeslett vises i serverens lokale tid.

Sidene

Side Innhold
Dashboard Nøkkeltall: brukere, meldinger og private meldinger i dag, oppetid. Aktivitet siste 24 timer og siste hendelser. Rødt varsel med feilmelding når radioen er nede, og varsel om repeatere som ikke er hørt på en stund. Status for e-post-gatewayen. Sending til den offentlige kanalen.
Messages Alle offentlige innlegg. Slett med bekreftelse.
Users Alle brukere. Send privat melding, eller bruk ⋯-menyen for å gjøre til moderator eller admin, ta bort rolle, gjøre stum, kaste ut eller utestenge. Øverst: tilgangsforespørsler når godkjenning er slått på.
Areas Opprett områder, endre beskrivelse, gjør dem skrivebeskyttet eller skjult, slett.
Network Noder radioen hører, kart og telemetri fra repeatere.
Log Aktivitetslogg. Filtrer på hendelser, kommandoer eller alt.
Backups Sikkerhetskopier: liste, Back up now og nedlasting.
Settings Alle innstillinger, se under.
System Versjon, minne, disk, last og CPU-temperatur, logg fra BBS-prosessen, og knappene for omstart og oppdatering.

Sending til den offentlige kanalen på Dashboard når alle innen rekkevidde. Den er maks 140 tegn og bør brukes sparsomt.

Sletting av områder sletter også alle innleggene i området. Du må skrive navnet på området for å bekrefte. Standardområdet kan ikke slettes.

Farlige handlinger som utestenging og sletting er røde og må bekreftes.

Innstillinger

Alle innstillinger gjøres på Settings. Bare felt du har endret blir lagret, og ugyldige verdier vises ved feltet det gjelder. De fleste endringer gjelder med en gang. Endringer i radiotilkobling og sikkerhetskopi krever omstart, og da vises et banner med Restart BBS now. Omstarten tar omtrent 15 sekunder.

Del Hva du stiller inn
BBS Navn, standardspråk for svar over radio, prefiks foran svarene (f.eks. [BBS]), standardområde for !post, lenke til brukerdokumentasjonen (sendes etter !help og vises av !info), velkomstmelding til nye brukere, valgfri første linje i !help
Access Nye brukere: åpent for alle, eller godkjenning av moderator. Se Tilgang og moderering under.
Position Breddegrad og lengdegrad i desimalgrader. Brukes av !weather og kartet.
Sending Pause mellom delene i lange svar (sekunder), og hvor ofte BBS-en sender advert (minutter, 0 = aldri)
Beacon Intervall og tekst for melding i den offentlige kanalen. 0 = av.
Retention Hvor mange dager private meldinger og aktivitetslogg lagres. 0 = for alltid.
Radio connection TCP (adresse og port til en WiFi-companion, vanligvis port 5000) eller USB/seriell (port og baudrate, vanligvis 115200)
E-mail gateway Se E-post-gateway under
Backups Av/på, hvor ofte, antall kopier, komprimering
Map and news Kartfliser for kartet på Network, og nyhetskilder for !news

Under innstillingene ligger også:

  • Admin password: bytte passord til web-admin
  • Companion clock: viser klokka i companion-radioen og på serveren, og forskjellen mellom dem. Sync with server stiller radioen etter serveren. Feil klokke kan gjøre at meldinger ikke kommer fram.

Noen få innstillinger ligger fast i /var/lib/meshbbs/config.env og vises nederst uten mulighet for endring: adresse og port for web-admin, datamapper, admin-brukernavn og tidsavbrudd for innlogging. Står en innstilling både i config.env og i web-admin, vises Locked by … in config.env, og verdien i filen gjelder.

Tilgang og moderering

Åpent eller godkjenning. Under Settings → Access → New users:

  • Open (standard): Alle som skriver til BBS-en får full tilgang.
  • Approval: Nye brukere kan lese, men ikke skrive innlegg, sende private meldinger eller e-post før de er godkjent. De ber om tilgang med !join <tekst>. Alle moderatorer og admin får beskjed over radio og svarer med !approve <bruker> eller !deny <bruker>. Det kan også gjøres med Approve og Deny øverst på Users.

Brukere som fantes før godkjenning ble slått på, beholder tilgangen. En bruker som er avvist, kan ikke spørre på nytt, men kan godkjennes senere fra ⋯-menyen på Users.

Moderering. Velg det mildeste som virker:

Handling Virkning
Mute Brukeren kan lese, men ikke skrive
Kick Utestengt en periode (standard 30 minutter, maks ett døgn)
Ban Utestengt permanent

Admin kan ikke gjøres stum, kastes ut eller utestenges. Bare admin kan gjøre det samme mot en moderator, og ingen kan gjøre det mot seg selv. Alle handlinger logges på Log.

Moderatorer og admin har også kommandoer over radio, se under.

Kommandoer over radio for staben

Disse vises med !help mod, og bare for moderatorer og admin. <bruker> er kallenavn eller de første 8 tegnene av nøkkelen.

Kommando Hvem Funksjon
!kick <bruker> [minutter] [grunn] / !unkick <bruker> mod, admin Kast ut en periode (standard 30 minutter, maks 1440)
!mute <bruker> [grunn] / !unmute <bruker> mod, admin Brukeren kan lese, men ikke skrive
!delete <id> mod, admin Slett hvilket som helst innlegg
!board del <id> mod, admin Slett hvilken som helst kunngjøring
!approve [bruker] / !deny <bruker> mod, admin Godkjenn eller avslå en søknad om tilgang. !approve alene lister åpne søknader.
!ban <bruker> [grunn] / !unban <bruker> admin Utesteng permanent
!promote <bruker> [admin] / !demote <bruker> admin Gjør til moderator (eller admin), eller ta bort rollen
!newarea <navn> [beskrivelse] admin Opprett område
!editarea <navn> desc|readonly|public <verdi> admin Endre område
!delarea <navn> admin Slett område og alle innleggene i det
!listareas admin Alle områder, også skjulte
!advert admin Send advert nå
!nodes admin Noder og repeatere BBS-en hører
!cleanup [--dry-run] admin Slett data som er eldre enn lagringstiden

Eksempel:

!kick Per 60 Spam i forumet
[BBS] Per kastet ut i 60 minutter - Grunn: Spam i forumet

E-post-gateway

Gatewayen kobler BBS-en til én vanlig e-postkonto over IMAP og SMTP. Med Gmail:

  1. Lag en egen Gmail-konto for BBS-en, slå på totrinnsbekreftelse og lag et app-passord på myaccount.google.com/apppasswords.
  2. Gå til Settings → E-mail gateway. Fyll inn adressen og app-passordet, trykk Test connection, sett E-mail gateway til på og lagre. Gatewayen starter med en gang.
  3. Dashboard viser status, siste sjekk og utgående e-post.

Andre e-postleverandører: endre IMAP- og SMTP-server og porter i samme del.

Innstilling Valg
Who may send Alle med kallenavn, eller bare admin og moderatorer
Who may write in Alle, eller bare adresser brukeren selv har sendt til
E-mails per user per 24 h Grense per bruker. 0 = ingen kan sende.
Max characters Lengde på teksten begge veier
Radio notice on new e-mail Kort direktemelding til brukeren når det kommer e-post

Greit å vite:

  • E-post som lå i kontoen før gatewayen ble startet første gang, blir hoppet over.
  • Automatiske svar, e-postlister, returmeldinger og e-post til ukjente brukere leveres ikke.
  • E-post som ikke kommer fram, prøves på nytt etter 2, 4, 8 og 16 minutter. Brukeren får beskjed hvis den til slutt feiler.

Sikkerhetskopi og oppdatering

Sikkerhetskopi tas automatisk 5 minutter etter oppstart og deretter hvert døgn. Sju kopier beholdes. På Backups kan du ta en kopi med Back up now og laste ned kopier. En sikkerhetskopi inneholder alle meldinger, også private, så den må oppbevares trygt. Gjenoppretting gjøres på BBS-maskinen.

Oppdatering gjøres på System:

Knapp Virkning
Check for updates Viser nye versjoner på GitHub
Update from GitHub Tar sikkerhetskopi, installerer og starter BBS-en på nytt. Tar omtrent ett minutt.
Restart BBS Starter BBS-programmet på nytt
Reboot host Starter hele maskinen på nytt

Resultatet vises på én linje under knappene, for eksempel 1 update available: … eller Updated to ….

Daglig sjekk

  • Dashboard: Radioen er online, aktivitetsgrafen viser trafikk, og det er ingen repeatere under Repeaters not heard.
  • System: Ingen varsler om radio, e-post eller disk. Det varsles når under 10 % av disken er ledig.

Feilsøking: radioen kobler ikke til

Varselet på Dashboard viser hvor BBS-en prøver å koble seg til, og siste feilmelding.

Feilmelding Årsak og løsning
No route to host (Errno 113) TCP: feil IP-adresse, eller companion-radioen er av eller ikke på nettet. Sjekk adressen under Radio connection, strøm og WiFi.
Connection refused (Errno 111) TCP: riktig adresse, men feil port, eller radioen har ikke WiFi-firmware. Sjekk porten og at radioen har companion-firmware med WiFi.
could not open port USB: feil enhetsnavn eller kabel. Sjekk porten under Radio connection.
Permission denied på serieporten Brukeren meshbbs må være med i gruppen dialout. Kjør deploy/install.sh på nytt.

Radioen BBS-en bruker må ha companion-firmware, ikke repeater eller room server. Navnet og nøklene BBS-en har i meshet, ligger i denne radioen.

Loggene kan også leses på BBS-maskinen:

systemctl status meshbbs
sudo journalctl -u meshbbs -n 50
sudo journalctl -u meshbbs -f

Den første viser om BBS-en kjører, den andre de siste 50 linjene, og den tredje følger loggen fortløpende.


« Ryfylke BBS brukermanual · Tjenester