Ryfylke BBS web-admin manual
På denne siden
- Innlogging og sikkerhet
- Toppfeltet og radiostatus
- Sidene
- Innstillinger
- Tilgang og moderering
- Kommandoer over radio for staben
- E-post-gateway
- Sikkerhetskopi og oppdatering
- Daglig sjekk
- Feilsøking: radioen kobler ikke til
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:
- Lag en egen Gmail-konto for BBS-en, slå på totrinnsbekreftelse og lag et app-passord på myaccount.google.com/apppasswords.
- 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.
- 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.
