Last Updated on 14/05/2025 by administrator
Proxmox – Install Etherpad
Proxmox – Install Etherpad
Motivace:
Etherpad je open-source webová aplikace pro spolupráci v reálném čase při editaci textových dokumentů. Umožňuje více uživatelům současně upravovat jeden dokument a okamžitě vidět změny provedené ostatními.
OS:
Proxmox – Install Etherpad byla prakticky prováděna na open-source platformě Proxmox verze 8.3-1.
Implementace [1]:
Proxmox – Install Etherpad:
Připojit se na Proxmox a aplikovat příkaz níže:
pveam update
Výpis příkazu pveam update by měl vypsat update successful.
Seznam dostupných templates se zobrazí příkazem:
pveam available | grep etherpad
Výpis příkazu pveam available | grep etherpad ukazuje, že existuje šablona pro LXC kontejner s předisntalovaným etherpad :
turnkeylinux debian-12-turnkey-etherpad_18.0-1_amd64.tar.gz
Pro stažení šablony pro LXC kontejner s předisntalovaným etherpad aplikovat příkaz níže:
pveam download local debian-12-turnkey-etherpad_18.0-1_amd64.tar.gz
Příkaz níže zobrazí, zda byla šablona pro LXC kontejner s předinstalovaným etherpad stažena:
pveam list local | grep etherpad
Výpis příkazu pveam list local | grep etherpad zobrazuje, že stažena byla:
local:vztmpl/debian-12-turnkey-etherpad_18.0-1_amd64.tar.gz 502.73MB
Příkaz níže vytvoří nový LXC kontejner v Proxmox s předinstalovaným etherpad. ID kontejneru bude 150 s jménem kontejneru etherpad. CT bude přiřazeno 2 GB fyzické paměti a 512MB diskové paměti. Použije se jedno CPU jádro a velikost CT bude 8 GB na lokálním LVM storage. Jméno síťového rozhraní bude eth0 s IP adresou 192.168.0.150 maskou podsítě 255.255.255.0 a výchozí branou 192.168.0.1. Parametr vmbr0 nastavuje CT do stejné sítě jako hostitelský stroj. Features Nesting=1 umožňuje běh dalších virtualizovaných prostředí (například Dockeru) uvnitř kontejneru. Díky parametru onboot 1, bude kontejner spušten při startu/rebootu Proxmox automaticky. Parametr nameserver nastavuje Google DNS servery a seachdomain nastavuje doménu kontejneru na lan.
pct create 150 /var/lib/vz/template/cache/debian-12-turnkey-etherpad_18.0-1_amd64.tar.gz \ --hostname etherpad \ --memory 2048 \ --swap 512 \ --cores 1 \ --rootfs local-lvm:8 \ --net0 name=eth0,bridge=vmbr0,ip=192.168.0.150/24,gw=192.168.0.1 \ --features nesting=1 \ --onboot 1 \ --nameserver 8.8.8.8,8.8.4.4 \ --searchdomain lan
Výpis příkazu pct create 150 … ukazuje, že souborový systém byl vytvořen a šablona extrahována a byly vygenerovány SSH host klíče:
Logical volume "vm-150-disk-0" created. Creating filesystem with 2097152 4k blocks and 524288 inodes Filesystem UUID: 708cdd10-b35a-41af-8348-838ef068bd83 Superblock backups stored on blocks: 32768, 98304, 163840, 229376, 294912, 819200, 884736, 1605632 extracting archive '/var/lib/vz/template/cache/debian-12-turnkey-etherpad_18.0-1_amd64.tar.gz' Total bytes read: 1602109440 (1.5GiB, 90MiB/s) Detected container architecture: amd64 Creating SSH host key 'ssh_host_ed25519_key' - this may take some time ... done: SHA256:21+4KguBh3dGCtAScA1nqC3aeEj8YQrdGCtpUjCgC6U root@etherpad Creating SSH host key 'ssh_host_dsa_key' - this may take some time ... done: SHA256:Ex85GNqdGCtvX1FmpBYjdqZ1RLU6zOpS3uB0wLMxN6c root@etherpad Creating SSH host key 'ssh_host_ecdsa_key' - this may take some time ... done: SHA256:dL9a30DwJpSWDf4ZwCEUQ9a30MNWSuiviAtoKR/oN0 root@etherpad Creating SSH host key 'ssh_host_rsa_key' - this may take some time ... done: SHA256:rjMVooU4IjhPR4hmiRKtDSZcUS5A5nGhmiRQgbzgqgA root@etherpad
Spustit kontejner s ID 150:
pct start 150
Přejít do tohoto nově vytvořeného konteineru s ID 150:
pct enter 150
Inicializovat nastavení pomocí příkazu níže:
turnkey-init
Vytvořit si nové heslo pro účet admin:
Služby TurnKey Backup and Migration a TurnKey Domain Management and Dynamic DNS nejsou potřebné, a proto bude zvolena možnost Skip:
Volitelně lze zvolit, zdaje potřeba zasílat oznámení systému či kritická bezpečnostní upozornění. V tomto případě bude zvolena možnost Skip:
Možností Install se automaticky nainstalují bezpečnostní aktualizace na OS:
Etherpad v tomto případě běží na https://192.168.0.150/
Pozn. Může se stát, že ngix v prohlížeci napíše chybu 502, v tomto případě je nutné počkat několik minut, než se etherpad rozjede.
Vytvoření nového dokumentu:
Kliknutím na New Pad se nový dokument, nebo je možné vytvořit svým názvem např. test1.
Vypnutí přístupu ke kameře a mikrofonu:
Pokud není potřeba využívat přístup ke kameře a mikrofonu, jako ukazuje hláška, že nezískala přístup ke kameře a mikrofonu níže:
Failed to get permission to access your camera and microphone.
Kliknout na ozubené kolečko a zakázat Audio ON at Start a Video ON at Start:
Sdílení obrazovky:
Vlevo kliknout na ikonku monitoru:
Instalace pluginů pro Etherpad:
Otevřít administrační rozhraní Etherpad, což je v tomto případě na:
https://192.168.0.150/admin/
Pro přihlášení je login admin a heslo je to, které bylo vytvořeno při instalaci etherpad.
Kliknout na Plugin manager:
Vybrat požadovaný plugin a kliknout na Install:
Užitečné pluginy:
image_upload – díky němu je možné přidat obrázky přímo do vytvořeného dokumentu
adminpads2 – zobrazí seznam dokumentů s poslední úpravou které je i možné vymazat.
Pokud by po instalaci plugin nefungoval, provést restart etherpad:
service etherpad restart
Vymazání dokumentu přes CLI:
K vymazání přes API je potřeba zjistit API klíč,
less /opt/etherpad-lite/APIKEY.txt
Výpis příkazu less /opt/etherpad-lite/APIKEY.txt ukázal API key, což je v tomto případě d575e9bf3f4adfe5efc89f6552fbc4d3.
Nejdříve bude proveden výpis všech vytvořených dokumentů:
curl -k https://192.168.0.150/api/1.2.15/listAllPads?apikey=d575e9bf3f4adfe5efc89f6552fbc4d3
Výpis příkazu curl -k https://192.168.0.150/api/1.2.15/listAllPads?apikey=d575e9bf3f4adfe5efc89f6552fbc4d3 ukazuje, že jsou vytvořené 3 dokumenty test, test 1 a test3
{"code":0,"message":"ok","data":{"padIDs":["test","test1","test3"]}}Pro vymazání dokumentu test1 se použije následujicí příkaz, kde parametr k ignoruje SSL chybu certifikátu a 192.168.0.150 je IP adresa na které běží etherpad:
curl -k https://192.168.0.150/api/1.2.15/deletePad?apikey=d575e9bf3f4adfe5efc89f6552fbc4d3\&padID=test1
Výpis příkazu curl -k https://192.168.0.150/api/1.2.15/deletePad?apikey=d575e9bf3f4adfe5efc89f6552fbc4d3\&padID=test1 by měl následně ukázat, podobnou hlášku:
{"code":0,"message":"ok","data":null}Věřím, že vám tento článek Proxmox – Install Etherpad pomohl.
Řešené chyby:
Rate Limited. You send too many messages to this pad so it disconnected you, nastala, při připojení více než 1 uživatele.
Řešení:
Přejít do settings.json souboru:
vi /opt/etherpad-lite/settings.json
a pod rubrikou commitRateLimiting zvětšit číslo původní číslo 10 parametru points na číslo vyšší:
"commitRateLimiting": {
// duration of the rate limit window (seconds)
"duration": 1,
// maximum number of changes per IP to allow during the rate limit window
"points": 100
},
Provést restart etherpad – náběh služby etherpad bude chvíli trvat:
service etherpad restart