Instalacja Kasm Workspaces na VPS z Linuksem (Ubuntu)

Kasm Workspaces przesyła strumieniowo skonteneryzowane pulpity i przeglądarki do Twojej własnej przeglądarki, dzięki czemu z dowolnego miejsca otworzysz jednorazowego Chrome'a lub pełny pulpit Linuksa. Na VPS Linux Infrawire edycja single server to najprostszy sposób uruchomienia. Poradnik dotyczy Ubuntu 24.04 (Ubuntu 22.04 działa tak samo).

📋 Wymagania

Nowy VPS KVM z Ubuntu, dostęp SSH jako root i brak innej usługi nasłuchującej na porcie 443. W panelu klienta znajdziesz adres IP i hasło roota VPS.
Kasm zaleca do instalacji podstawowej co najmniej 2 rdzenie CPU, 4 GB RAM i 50 GB dysku SSD, a każda uruchomiona przestrzeń robocza zużywa dodatkową pamięć. Zaplanuj więcej RAM, jeśli łączy się kilku użytkowników naraz.
Domena, np. kasm.example.com, wskazująca na VPS_IP, jeśli chcesz mieć zaufany certyfikat HTTPS.

🔄 1. Przygotowanie serwera

Bash
1ssh root@VPS_IP
2apt update && apt -y upgrade && apt -y install curl

Kasm instaluje Dockera samodzielnie, więc nie konfiguruj wcześniej innego środowiska kontenerów. Uruchom ponownie system, jeśli zainstalowano nowe jądro.

⬇️ 2. Pobranie najnowszej wersji

Numer wersji zmienia się regularnie, więc nie kopiuj go ze starego poradnika. Otwórz oficjalną stronę pobierania (https://kasmweb.com/downloads) lub przewodnik instalacji single server (https://kasmweb.com/docs/latest/install/single_server_install.html), skopiuj link do archiwum aktualnego wydania dla instalatora single server i wstaw go poniżej zamiast RELEASE_URL.

Bash
1cd /tmp
2curl -O RELEASE_URL
3tar -xf kasm_release_*.tar.gz

Archiwum rozpakowuje się do katalogu kasm_release, w którym jest install.sh.

⚙️ 3. Instalacja z wystarczającym swapem

Przestrzenie robocze zużywają dużo pamięci, a swap chroni serwer przed nagłym zabijaniem procesów z powodu braku pamięci. Instalator może utworzyć plik swap opcją --swap-size (w MB):

Bash
1sudo bash /tmp/kasm_release/install.sh --swap-size 4096

Jeśli port 443 jest zajęty, dodaj -L 8443, aby interfejs WWW działał na 8443. Instalacja pobiera kilka obrazów Dockera i trwa 10 do 20 minut. Na końcu skrypt wypisuje wygenerowane hasła do domyślnych kont admin@kasm.local i user@kasm.local. Zapisz je od razu: pojawiają się tylko raz.

🌐 4. Otwarcie konsoli WWW

Wejdź na https://VPS_IP (lub https://VPS_IP:8443, jeśli zmieniłeś port). Na razie zaakceptuj ostrzeżenie o certyfikacie samopodpisanym. Zaloguj się jako admin@kasm.local, aby wejść do panelu administracyjnego, i zmień wygenerowane hasła z menu użytkownika.

Jeśli używasz zapory, zezwól na port WWW:

Bash
1ufw allow 22/tcp
2ufw allow 443/tcp
3ufw enable

Zezwól na SSH przed włączeniem UFW, aby się nie zablokować.

🔒 5. Dodanie certyfikatu Let's Encrypt

Kasm udostępnia własny certyfikat przez wewnętrzne proxy Nginx. Poproś o certyfikat za pomocą Certbota w trybie standalone, który wymaga wolnego portu 80 (Kasm go nie używa), a następnie skopiuj go tam, gdzie Kasm go oczekuje:

Bash
1apt -y install certbot
2certbot certonly --standalone -d kasm.example.com
3cp /etc/letsencrypt/live/kasm.example.com/fullchain.pem /opt/kasm/current/certs/kasm_nginx.crt
4cp /etc/letsencrypt/live/kasm.example.com/privkey.pem /opt/kasm/current/certs/kasm_nginx.key
5/opt/kasm/bin/stop
6/opt/kasm/bin/start

Certyfikaty ważne są 90 dni, więc po każdym odnowieniu powtarzaj kopiowanie i restart, na przykład z hakiem wdrożeniowym Certbota w /etc/letsencrypt/renewal-hooks/deploy/.

🚀 6. Uruchomienie izolowanej przeglądarki

Zaloguj się jako zwykły użytkownik (user@kasm.local), a strona Workspaces pokaże dostępne obrazy. Jeśli lista jest pusta, zaloguj się jako admin, otwórz Workspaces > Registry i zainstaluj potrzebne obrazy, takie jak Chrome, Firefox lub pulpit Ubuntu. Następnie kliknij przestrzeń roboczą, aby ją uruchomić: nowa karta wyświetli pełny pulpit lub przeglądarkę przesyłaną do Ciebie, ze schowkiem i transferem plików w panelu bocznym. Po zamknięciu sesji kontener jest niszczony.

✅ 7. Weryfikacja

Bash
1docker ps --format '{{.Names}}: {{.Status}}'
2ss -tlnp | grep -E ':(443|8443)\b'
3free -h

Powinieneś zobaczyć działające kontenery kasm_*, nasłuchujący port WWW i swap w wyniku free -h.

🧰 Rozwiązywanie problemów

Instalator zatrzymuje się z błędem pamięci lub dysku: sprawdź free -h i df -h. Dodaj swap opcją --swap-size, zwolnij miejsce na dysku i uruchom instalator ponownie.
Przestrzeń robocza utknęła na ekranie ładowania: serwerowi prawdopodobnie brakuje RAM albo obraz nie został w pełni pobrany. Sprawdź docker ps -a i logi w /opt/kasm/current/log/ oraz zamknij inne sesje.
Przeglądarka ostrzega o certyfikacie: pliki w /opt/kasm/current/certs/ nie zostały podmienione albo usługi nie zostały zrestartowane. Powtórz krok 5 i wpisuj w pasku adresu nazwę domeny, a nie IP.
Utracone hasło admina: zresetuj je w panelu administracyjnym z innego konta administratora albo zainstaluj ponownie na czystym VPS, jeśli nie został żaden administrator.

🎉 Kasm Workspaces działa: uruchamiaj przeglądarki i pulpity na żądanie, bezpiecznie odizolowane od własnego komputera.