Alkalmazások

1. Bepasty (fájlok és kódrészletek megosztása )

bepasty icon

Elérhető ettől a verziótól kezdve: 20.14

1.1. Mi a bepasty?

A bepasty egy webalkalmazás, amely lehetővé teszi, hogy nagyméretű fájlokat tölts fel és ossz meg. A bepasty-vel ezen kívül szöveget és kódrészleteket is meg lehet osztani. A szöveges, kép-, audió-, videó- és PDF-dokumentumok előnézettel megtekinthetők a böngészőben. Be lehet állítani, hogy a megosztott fájlok lejárjanak egy bizonyos idő elteltével.

1.2. Képernyőképek

Screenshot of bepasty

1.3. Jelszavak és jogosultságok

A bepasty csak jelszavakat használ (felhasználónevek nélkül) a hozzáférés ellenőrzésére. A felhasználó attól függően, hogy milyen jelszóval jelentkezik be a bepastybe, különböző jogosultságokkal rendelkezik. A következő jogosultságok bármely kombinációjával rendelkezhet:

  • olvas: Fájl olvasása, ha rendelkezik a linkkel.

  • listáz: Az összes fájl listázása.

  • létrehoz: Új fájl beillesztése vagy feltöltése.

  • töröl: Fájl törlése.

  • adminisztrál: Lezárhat és feloldhat fájlokat.

Telepítés után a bepasty a következő szerepköri beállításokkal rendelkezik:

  • Látogató: megtekinthet és listázhat fájlokat
  • Szerkesztő: megtekinthet, listázhat, létrehozhat és törölhet fájlokat
  • adminisztrátor: minden engedéllyel rendelkezik

Ezek a szerepkörök az ismert, engedélyezett felhasználók közötti fájlmegosztást támogatják. Szükség esetén a bepasty-t átkonfigurálhatja, hogy más szerepköröket és felhasználási eseteket is támogasson.

1.4. Jelszavak szétosztása

Alapértelmezés szerint a nyilvános hozzáférés beállítása Nincs, így a bepasty használatához jelszóra van szükség. Ez azt jelenti, hogy a jelszavakat szét kell osztanod a megfelelő felhasználók között, a rendelkezésére álló kommunikációs csatornákon keresztül.

Vedd figyelembe, hogy több jelszót is létrehozhatsz ugyanazokkal a jogosultságokkal. Ez lehetővé teszi, hogy minden felhasználónak (vagy felhasználócsoportnak) egyedi jelszót ossz ki. Ezután, ha vissza akarod vonni egy felhasználó hozzáférését, egyszerűen törölheted a jelszavát. A többi, saját jelszóval rendelkező felhasználót ez nem érinti.

1.5. A bepasty használata

Miután bejelentkeztél a bepasty-be, ha rendelkezel a Létrehozás jogosultsággal, akkor egy nagy szövegdoboz jelenik meg, ahová bármilyen szöveget beilleszthetsz. Opcionálisan megadhatsz egy fájlnevet vagy Content-Type-ot az adatokhoz. A Submit gombra kattintás után a fájl létrejön.

Az alján található területen fájlokat is behúzhatsz a bepasty-be. A feltöltésük azonnal megtörténik, miután e területre helyezted őket. A feltöltött fájlok gyűjteményének nyomon követéséhez lista is létrehozható.

Mindkét esetben beállíthatsz egy maximális élettartam-értéket. Ezen idő lejárta után a fájl törlődik.

Ha rendelkezel a Listázás jogosultsággal, akkor az oldal tetején megjelenik az Összes elem listázása link. Ez megmutatja az összes létrehozott vagy feltöltött fájlt.

Ha rendelkezel a Törlés vagy a Rendszergazda jogosultsággal, akkor a listaoldalon minden egyes fájl mellett extra műveletek jelennek meg.

Ha csak az Olvasás jogosultsággal rendelkezel, akkor a fájlok olvasásához egy jelszóra és egy vagy több URL-címre van szükséged a meglévő fájlokhoz.

1.6. Jelszavak kezelése

A FreedomBox felületén található bepasty konfigurációs oldal lehetővé teszi új jelszavak létrehozását, vagy egy jelszó eltávolítását. Jelszó létrehozásakor a fent leírt jogosultságok bármely kombinációját kiválaszthatod. Vedd figyelembe, hogy egy tipikus rendszergazdának az összes jogosultsággal rendelkeznie kell (nem csak az "Admin" jogosultsággal).

Lehetőség van egy megjegyzés beállítására is. Ez ajánlott, hiszen segít emlékezni a jelszó céljára, vagy arra, hogy ki fogja használni a jelszót.

A nyilvános hozzáférés is beállítható, amely meghatározza azokat az alapértelmezett jogosultságokat, amelyek jelszóval történő bejelentkezés nélkül is elérhetők. Beállíthatod, hogy a fájlok URL-címük alapján történő olvasását, vagy az összes fájl olvasását és listázását engedélyezd.

1.7. Külső hivatkozások

2. Calibre (e-könyvtár)

calibre app tile in FreedomBox web interface

Elérhető ettől a verziótól kezdve: 20.15

A calibre egy e-könyv-kezelési megoldás. Az e-könyveket a calibre-ben "könyvtárak" néven ismert gyűjteményekbe rendezheted. A calibre képes a legismertebb e-könyv fájltípus között konvertálni. Az e-könyvek metaadatait is képes kezelni, például a könyvborítókat, leírásokat, szerzői és kiadói információkat stb.

Ha a már meglévő calibre-könyvtáradat átköltözteted a FreedomBoxra, akkor e-könyveidhez a helyi hálózaton vagy az interneten keresztül bármely eszközről hozzáférhetsz.

Csak azok a felhasználók férnek hozzá a könyvtárakhoz, akik tagjai a calibre csoportnak. A rendszer alkalmazásban, a ?felhasználók és csoportok résznél hozzáadhatod a felhasználóidat ehhez a csoporthoz

2.1. Könyvtárak kezelése

A calibre telepítése után az alapértelmezett "Library" nevezetű könyvtár lesz elérhető. A FreedomBox rendszergazda a FreedomBox webes kezelőfelületen hozzáadhat és eltávolíthat bármilyen könyvtárat, beleértve az alapértelmezettet is.

2.2. Hozzáférés

A calibre-t a telepítést követően a webes kliensen át tudod elérni a https://<az_en_freedombox_cimem>/calibre címen.

2.3. Külső hivatkozások

3. Coturn (VoIP-segéd)

Coturn icon

Elérhető ettől a verziótól kezdve: 20.8

A Coturn egy szerver, amely a TURN és STUN protokollok implementációjával megkönnyíti az audió-/videóhívásokat és konferenciákat. A WebRTC, a SIP és más kommunikációs szerverek használhatják arra, hogy hívást hozzanak létre olyan felek között, akik egyébként nem tudnának kapcsolódni egymáshoz.

A Coturn a FreedomBoxban haladó alkalmazásként konfigurálható. Ez azt jelenti, hogy be kell jelölnöd a "Haladó szintű alkalmazások és funkciók mutatása" opciót a Beállítások részben ahhoz, hogy a Coturn ikon látható legyen az "Alkalmazások" között.

3.1. Hogyan működik

Audio/videohívás esetén a legjobb, ha a médiafolyamokat közvetlenül a két peer között irányítjuk. Ez biztosítja a lehető legkisebb késleltetést (jobb jelminőség), továbbá így elkerülhető a központi szervertől való függés (adatvédelem). Jól méretez magát, mivel egy egyszerű csevegőszerver több ezer hívást tud fogadni anélkül, hogy a szerver a hívás beállításán kívül más módon is részt venne. Ez a megközelítés azonban a hálózatok konfigurációja miatt legtöbbször nem működik. A hálózaton lévő legtöbb peer nem rendelkezik egyedi IP-címmel. Egy olyan hálózati eszköz mögött rejtve dolgoznak, amely elvégzi számukra a "hálózati címfordítást" (NAT). Ez azt jelenti, hogy a két peer nem tudja elérni egymást.

E probléma megoldására a STUN nevű egyszerű technikát vezették be. Egy harmadik féltől származó STUN-kiszolgáló segítségével a peerek át tudják verni a NAT-eszközöket, hogy a két peer közötti forgalmat továbbítsák. Sajnos ez a trükk csak az esetek 80%-ában működik. Így ha a STUN nem működik, a peereknek nincs más választásuk, mint a TURN-szervernek nevezett közvetítőn keresztül irányítani a forgalmat. A STUN első kipróbálásának, majd a TURN-hoz való visszatérésnek az összes mechanizmusát az ICE néven ismert protokoll írja le.

A FreedomBoxon a Coturn STUN- és TURN-szervereket is biztosít. Mindkét szolgáltatás TCP-n és UDP-n keresztül is elérhető. Mindkettő titkosítatlan és titkosított csatornákon is elérhető (amelyek nagyobb eséllyel járnak sikerrel). Mivel a STUN-szerverek nagyon olcsók és nem fogyasztanak sok szerver erőforrást, használatukhoz nincs szükség hitelesítésre. A TURN-szerverekhez viszont hitelesítésre van szükség. Ez a hitelesítés erősen leegyszerűsített, és nem igényel felhasználói adatbázis fenntartását. Egy olyan szerver, mint a matrix-synapse, amelyik két peer közötti audio/video hívást készül létrehozni, egy megosztott titok segítségével generál egy felhasználónevet és jelszót. Amikor a peerek a TURN-kiszolgálót használják, a rendszer ezeket a hitelesítő adatokat használja, mivel a TURN-szerver is ismeri ugyanazt a titkot.

Összefoglalva, a kommunikációs kiszolgálónak ismernie kell a STUN/TURN-szerverek URL-címeit, valamint a TURN közös hitelesítési titkát. Ezt követően az audio/videohívás beállítása során helyesen irányítja a peereket a STUN/TURN-szerverek használatára. A FreedomBoxban található Coturn alkalmazás pontosan ezt az információt nyújtja. Ez az információ felhasználható egy kommunikációs szerver konfigurálásához, függetlenül attól, hogy az ugyanazon a FreedomBoxon vagy egy másik szerveren fut.

3.2. Matrix Synapse konfigurálása

Ha a Coturn TURN/STUN szervert a Matrix Synapse-szel szeretnéd használni, akkor a Matrix Synapse beállításaiban jelöld be az "Automatikusan kezelje az audió/videóhívás beállítását" opciót, majd kattints a "Beállítások frissítése" gombra.

Matrix with Coturn

Ha a FreedomBoxod router mögött van, a routeren a következő portokat kell továbbítanod a Coturn számára:

  • UDP 3478
  • TCP 3478
  • UDP 3479
  • TCP 3479
  • UDP 5349
  • TCP 5349
  • UDP 5350
  • TCP 5350
  • UDP 49152-50175
  • TCP 49152-50175

3.3. Külső linkek

4. Deluge (Elosztott fájlmegosztás BitTorrenttel)

Deluge icon

Elérhető ettől a verziótól kezdve: 0.5

4.1. Mi a Deluge

A Deluge egy BitTorrent-csomópont (egyszerre kliens és szerver). A BitTorrent egy fájlmegosztásra használt peer-to-peer (P2P) kommunikációs protokoll.

  • A BitTorrent nem bizosít névtelenséget, így feltételezhető, hogy mások (pl. az internetszolgáltatód) számára láthatók a fájlmegosztásaid.

  • Ez a technológia legjobban a nagy, népszerű fájlokkal működik legjobban.

A FreedomBoxban két webes BitTorrent csomópont érhető el: az egyik a ?Transmission, a másik pedig a Deluge. Hasonló funkciókkal rendelkeznek, bár meglehet, az egyiket jobban kedveled majd a másiknál.

A Deluge egy könnyű BitTorrent-kliens, amely nagymértékben konfigurálható, kiegészítők telepítésével további funkciók érhetők el.

4.2. Képernyőkép

Deluge Web UI

4.3. Kezdeti beállítás

A Deluge a telepítés után elérhető, ha a böngésződdel meglátogatod a https://<te_freedomboxod>/deluge címet. A belépéshez szükséged lesz egy jelszóra:

Deluge Login

A kezdeti jelszó "deluge". Az első bejelentkezés alkalmáva a program meg fogja kérdezni, hogy meg akarod-e változtatni a jelszót. Érdemes megváltoztatni, valami olyanra, amit nehezebb kitalálni.

Következőnek a kapcsolatkezelőt fogod látni. Kattints az első bejegyzésre (Offline - 127.0.0.1:58846), aztán kattints a "Start Daemon" gombra, ami elindítja a Deluge-szolgáltatást a háttérben.

Deluge Connection Manager (Offline)

Ekkor a szerver "Online" státuszra vált, ami után kattints a "Connect" gombra a beállítás befejezéséhez.

Deluge Connection Manager (Online)

Ezen a ponton használatba veheted a Deluge-t. A program beállításaiban további módosításokat végezhetsz, vagy rögtön hozzáadhatsz egy torrentfájlt vagy URL-t.

4.4. Külső linkek

Include: Nothing found for "## END_INCLUDE"!

5. Ejabberd (Chat szerver)

ejabberd icon

Elérhető ettől a verziótól kezdve: 0.3

5.1. Mi az ejabberd?

Az ejabberd egy chat szerver, amely a bővíthető üzenetküldő és jelenléti protokollt (XMPP) használja

5.2. Mi az XMPP?

Az XMPP egy csevegéshez használt föderált szerver-kliens protokoll. Ez azt jelenti, hogy azok a felhasználók, akiknek van fiókjuk egy szerveren képeseke kommunikálni azokkal a felhasználókkal, akiknek más szerveren vannak.

Az XMPP hang- és videóhívásokra is használható, ha a használt kliensek támogatják.

Jelenleg a FreedomBox egy szervert (ejabberd) és egy webes klienst (?JSXC) is biztosít a webes kezelőfelületéből.

5.3. Adatvédelem

Az XMPP-t két módon lehet biztonságossá tenni:

  1. TLS: Ez titkosítja a kliens és a szerver, vagy szerver és szerver közti kapcsolatot. Ezt a funkciót minden kliens támogatja, így beállítása erősen ajánlott.
  2. Végpontól végpontig tartó titkosítás: ez oly módon titkosítja az üzeneteidet, hogy még a közvetítő szerver sem képes semmilyen módon elolvasni őket. A legnagyobb és egyben legkényelmes protokollt OMEMO-nak hívják, ezt ugyanakkor csak néhány kliens támogatja. Létezik még az OTR-protokoll, amely jó eséllyel használható az OMEMO-t nem támogató kliensekkel. A végponti kliensek mindegyikének támogatnia kell a kiválasztott protokollt.

5.4. A domainnév beállítása

Az XMPP működéséhez a FreedomBoxodnak szüksége van egy a hálózatról elérhető domainnévre.

Ha csak a helyi hálózatról (LAN) szeretnél csevegni, akkor egyszerűen kitalálhatsz egy tetszőleges domainnevet, ha viszont az interneten is szeretnéd elérhetővé tenni a szolgáltatást, akkor egy nyilvános somainnévre lesz szükséged. Tudja meg többet a domainnevekről a kézikönyv ?Dinamikus DNS részében.

6. GitWeb (Simple Git Hosting)

Gitweb icon

Elérhető ettől a verzótól kezdve: 19.19

6.1. Mi a Git?

A Git egy elosztott verziókezelő rendszer a szoftverfejlesztés során a forráskódban bekövetkező változások nyomon követésére. A Git egy elosztott verziókezelő rendszer a szoftverfejlesztés során a forráskódban történt változások követésére. A Gitweb webes felületet biztosít a Git tárolóihoz. Böngészheted az előzményeket és a forráskódok tartalmát, a keresés használatával megtalálhatod a releváns commitot és kódot. Továbbá klónozhatsz tárolókat és feltöltheted a kódmódosításokat egy parancssoros Git klienssel vagy a különféle grafikus kliensek valamelyikével. Ezek mellett megoszthatod a kódodat az emberekkel szerte a világon.

Ha szeretnél többet megtudni a Git használatáról, akkor tekintsd meg a Git gyorstalpalót (angolul).

6.2. Git-tárolók kezelése

A GitWeb telepítése után új tárolók hozhatók létre, amelyeket a hozzáférés korlátozása érdekében beállíthatsz privátként.

6.3. Hozzáférés

A GitWebhez a telepítés után a a webes klienssel férhetsz hozzá az https://<az_en_freedomboxom>/gitweb címen.

6.4. HTTP basic auth

A FreedomBoxon futó GitWeb jelenleg csak a távoli HTTP-azonosítást támogatja. Ha nem szeretnéd minden alkalommal megadni a jelszavad, amikor egy tárolón a dolgozol (pull/push), akkor írd át a GitWeb URL-jét a következőképpen: https://felhasznalonev:jelszo@az_en_freedomboxom>/gitweb/myrepo

A felhasználónév és a jelszó titkosítva lesz. Ha valaki figyeli a hálózati forgalmat, csak a domainnevet fogja észrevenni.

Megjegyzés: Ha ezt a módszert használva a jelszavad a helyi tárolód .git/config fájljában egyszerű szövegként el lesz tárolva. Ebből kifolyólag ajánlott, egy olyan felhasználó létrehozása, amelyet egyedül a GitWebhez használsz. Adminisztrátori fiókkal ne használd a GitWebet.

GNOME felhasználóknak (Haladó)

A GNOME "Passwords and Keys" eszközt használva tárolhatók a felhasznlónevek és jelszavak. Részletekért lásd: StackOverflow.

6.5. Tükrözés

Bár a GitWebes tárolóid a FreedomBoxon találhatók, beállíthatsz pl. egy távoli GitLab tárolót tükörszerverként.

6.6. Külső linkek

7. Ikiwiki (wiki és blog)

Ikiwiki icon

Elérhető ettől a verziótól kezdve: 0.5

7.1. Mi az Ikiwiki

Az Ikiwiki egy olyan webes alkalmazás, amellyel különféle wikiket és blogokat hozhatsz létre.

7.2. Wiki vagy blog létrehozása

Új wiki vagy blog létrehozásához nyisd meg az "ikiwiki" alkalmazást a FreedomBoxodon, majd az alkalmazás telepítése után kattints a "Wiki vagy blog létrehozása" lehetőségre.

ikiwiki: Manage

Ezután kiválaszthatod a létrehozandó oldalad wiki vagy blog legyen-e, továbbá az oldalhoz tartozó adminisztrátori fiók felhasználónevét és jelszavát.

ikiwiki: Manage

7.3. Hozzáférés az oldaladhoz

A létrehozott wiki és blog oldalaidat a FreedomBox Ikiwiki alkalmazásása listázza számodra. Az oldal nevére kattintva, annak kezdőoldalára fogsz jutni.

ikiwiki: Manage

Ezek után az "Edit" vagy a "Preferences" gombokra kattintva egy bejelentkezési felületre fogsz jutni. Az előzőkben létrehozott bejelentkezési adatok használatához itt válaszd az "Other" lehetőséget és jlentkezz be a felhasználóneveddel éj jelszavaddal.

7.4. Egyszeri bejelentkezés (SSO) használata

A wiki/blog admin mellett más FreedomBox felhasználók is képesek bejelntkezni és lapokat szerkeszteni, ugyanakkor ők nem rendelkeznek minden olyan engedéllyel, mint maga az admin. A FreedomBox más felhasználói létrehozhatnak és szerkeszthetnek bejegyzéseket, ugyanakkor nem módosíthatnak az oldal beállításain.

Felhasználók hozzáadásához látogass el a FreedomBoxod "Rendszer" >> "Felhasználók és csoportok" oldalára. Itt lehetőséged van új felhasználók létrehozására, vagy a már meglévő felhasználóid módosítására, hozzáadva őket a "wiki" csoporthoz. (Az admin csoportban lévő felhasználók is rendelkeznek a "wiki" csoport engedélyeivel.)

FreedomBox felhasználóval úgy tudsz bejelentkezni, hogy a wiki/blog bejelentkezési lapján válaszd az "Other" lapot, majd kattints a "Login with HTTP auth" gombra. Ezután a böngésződ feldob egy párbeszédablakot, ahová a FreedomBoxon használt felhasználónév és jelszó használatával be tudsz jelentkezni.

7.5. FreedomBox felhasználók ikiwiki adminokként

  1. Jelentkezz be az ikiwikibe a korábban létrehozott adminisztrátori fiókoddal
  2. Kattints a "Preferences", majd a "Setup" lehetőségekre.
  3. A "main" alatt, a "users who are wiki admins" résznél add meg a hozzáadni kívánt FreedomBox felhasználó nevét.

  4. (Opcionális) A "auth plugin: passwordauth" rész alatt kapcsold ki az "enable passwordauth?" lehetőséget.
  5. Kattints a "Save Setup"-ra.
  6. Kattinst a "Preferences"-re, majd a "Logout" lehetőséggel jelentkezz ki.
  7. Jelentkezz be az új admin fiókkal a "Login with HTTP auth"-ra kattintva.

7.6. Külső linkek

Include: Nothing found for "## END_INCLUDE"!

8. Matrix Synapse (Chat szerver)

[ATTACH]

Elérhető ettől a verziótól kezdve: version 0.14.0

8.1. Mi a Matrix

A Matrix egy átjárható, decentralizált valós idejű kommunikációt biztosító nyílt protokoll. A Synapse a Matrix kiszolgáló egyik kiemelt implementációja. A FreedomBoxon eresztül végponttól végpontig titkosított azonnali üzenetküldésre és audio/video hívásokra használható. A Matrix Synapse egy föderált alkalmazás, ahol a csevegőszobák A Matrix Synapse egy ún. föderált alkalmazás, ahol a csevegőszobák bármelyik szerveren létezhetnek, és a föderált hálózat bármelyik szerveréről csatlakozhatnak hozzájuk felhasználók.Tudj meg többet Matrixról.

8.2. Hogyan férhetek hozzá a Matrix Synapse szerverhez?