Linux VPS'e Kasm Workspaces Kurulumu (Ubuntu)

Kasm Workspaces, konteynerlerde çalışan masaüstlerini ve tarayıcıları kendi tarayıcınıza aktarır; böylece her yerden tek kullanımlık bir Chrome veya tam bir Linux masaüstü açabilirsiniz. Bir Infrawire Linux VPS üzerinde single server sürümü, onu çalıştırmanın en kolay yoludur. Bu rehber Ubuntu 24.04'ü hedefler (Ubuntu 22.04 de aynı şekilde çalışır).

📋 Gereksinimler

Ubuntu yüklü yeni bir KVM VPS, root SSH erişimi ve 443 portunu dinleyen başka bir servis olmaması. VPS'in IP adresini ve root parolasını müşteri alanınızda bulabilirsiniz.
Kasm, temel kurulum için en az 2 CPU çekirdeği, 4 GB RAM ve 50 GB SSD önerir; çalışan her çalışma alanı ayrıca bellek tüketir. Aynı anda birkaç kullanıcı bağlanacaksa daha fazla RAM planlayın.
Güvenilir bir HTTPS sertifikası istiyorsanız VPS_IP adresine yönlenen kasm.example.com gibi bir alan adı.

🔄 1. Sunucuyu hazırlayın

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

Kasm, Docker'ı kendisi kurar; bu yüzden önceden başka bir konteyner çalışma ortamı kurmayın. Yeni bir çekirdek yüklendiyse yeniden başlatın.

⬇️ 2. En son sürümü indirin

Sürüm numarası düzenli olarak değişir, bu yüzden eski bir rehberden kopyalamayın. Resmi indirme sayfasını (https://kasmweb.com/downloads) veya single server kurulum kılavuzunu (https://kasmweb.com/docs/latest/install/single_server_install.html) açın, single server kurulumu için güncel sürüm arşivinin bağlantısını kopyalayın ve aşağıdaki RELEASE_URL yerine kullanın.

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

Arşiv, içinde install.sh bulunan kasm_release dizinine açılır.

⚙️ 3. Yeterli swap ile kurun

Çalışma alanları çok bellek tüketir ve swap, sunucuyu bellek yetersizliğinden kaynaklanan ani süreç kapanmalarına karşı korur. Kurulum betiği --swap-size seçeneğiyle (MB cinsinden) sizin için bir swap dosyası oluşturabilir:

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

443 portu doluysa web arayüzünü 8443 üzerinden sunmak için -L 8443 ekleyin. Kurulum birkaç Docker imajı indirir ve 10 ila 20 dakika sürer. Sonunda betik, admin@kasm.local ve user@kasm.local varsayılan hesapları için üretilen parolaları yazdırır. Hemen kaydedin; yalnızca bir kez gösterilirler.

🌐 4. Web konsolunu açın

https://VPS_IP adresine gidin (portu değiştirdiyseniz https://VPS_IP:8443). Şimdilik kendinden imzalı sertifika uyarısını kabul edin. Yönetim alanına ulaşmak için admin@kasm.local ile giriş yapın ve üretilen parolaları kullanıcı menüsünden değiştirin.

Bir güvenlik duvarı kullanıyorsanız web portuna izin verin:

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

Kendinizi dışarıda bırakmamak için UFW'yi etkinleştirmeden önce SSH'ye izin verin.

🔒 5. Let's Encrypt sertifikası ekleyin

Kasm kendi sertifikasını dahili bir Nginx proxy'si üzerinden sunar. Certbot ile standalone modunda sertifika isteyin; bunun için 80 portu boş olmalıdır (Kasm kullanmaz). Ardından sertifikayı Kasm'ın beklediği yere kopyalayın:

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

Sertifikalar 90 gün geçerlidir; her yenilemeden sonra kopyalama ve yeniden başlatma işlemini, örneğin /etc/letsencrypt/renewal-hooks/deploy/ içindeki bir Certbot deploy hook'uyla tekrarlayın.

🚀 6. İzole bir tarayıcı başlatın

Normal bir kullanıcıyla (user@kasm.local) giriş yapın; Workspaces sayfası kullanılabilir imajları listeler. Liste boşsa yönetici olarak giriş yapın, Workspaces > Registry bölümünü açın ve Chrome, Firefox veya bir Ubuntu masaüstü gibi istediğiniz imajları kurun. Ardından başlatmak için bir çalışma alanına tıklayın: yeni bir sekmede size aktarılan tam bir masaüstü veya tarayıcı açılır; yan panelde pano ve dosya aktarımı kontrolleri bulunur. Oturumu kapattığınızda konteyner yok edilir.

✅ 7. Doğrulama

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

Çalışan kasm_* konteynerlerini, dinlemedeki web portunu ve free -h çıktısında swap'i görmelisiniz.

🧰 Sorun giderme

Kurulum betiği bellek veya disk hatasıyla duruyor: free -h ve df -h çıktısını kontrol edin. --swap-size ile swap ekleyin, disk alanı açın ve betiği yeniden çalıştırın.
Bir çalışma alanı yükleme ekranında takılı kalıyor: sunucuda büyük olasılıkla RAM yetersiz ya da imaj tam indirilmemiş. docker ps -a çıktısına ve /opt/kasm/current/log/ içindeki günlüklere bakın, diğer oturumları kapatın.
Tarayıcı sertifika uyarısı veriyor: /opt/kasm/current/certs/ içindeki dosyalar değiştirilmemiş ya da servisler yeniden başlatılmamış. 5. adımı tekrarlayın ve adres çubuğunda IP yerine alan adını kullanın.
Yönetici parolası kayboldu: başka bir yönetici hesabıyla yönetim alanından sıfırlayın; yönetici kalmadıysa temiz bir VPS'e yeniden kurun.

🎉 Kasm Workspaces çalışıyor: tarayıcıları ve masaüstlerini isteğe bağlı olarak, kendi bilgisayarınızdan güvenle yalıtılmış biçimde başlatın.