SSS

Sorular & cevaplar

Chatstead’i kurmadan önce ve sonra merak edebileceğiniz her şey. Bulamadınız mı? Bize ulaşın.

Genel

Chatstead nedir?

Tamamen kendi sunucunuzda çalıştırdığınız özel, gerçek zamanlı bir ekip sohbeti — mesajlaşma, arama, dosyalar ve yönetim paneli; üçüncü taraf servislere hiçbir şey gönderilmeden.

Herhangi bir veri üçüncü taraflara gönderilir mi?

Hayır. Mesajlar, dosyalar ve hesaplar yalnızca sizin sunucunuzda durur. Tek opsiyonel dış bağlantılar: kendi SMTP sunucunuz, Let’s Encrypt (domain sertifikası kullanırsanız) ve tarayıcı push servisleri (yalnızca kullanıcılar bildirim açarsa).

İnternetsiz çalışır mı?

Evet, kurulumdan sonra. Kurulum Node.js indirmek için internet ister; sonrasında izole bir yerel ağda çalışır.

Kaç kullanıcıyı kaldırır?

Küçük bir VPS tipik bir ekibe rahatça hizmet verir. Node.js’in yerleşik SQLite motorunu kullanır — çalıştırılacak ayrı veritabanı sunucusu yoktur.

Durum (status) sayfanız var mı? Chatstead kapanırsa ne olur?

Mesajlarınızın yolunda bizim tarafımızda hiçbir şey yok; yani bizim çalışma sürekliliğimizi izlemenize gerek kalmıyor. Chatstead tamamen sizin sunucunuzda çalışır: bulut aktarıcı yok, üçüncü taraf push servisi yok ve lisanslar çevrimdışı doğrulanan imzalı anahtarlardır — arayacak bir etkinleştirme sunucusu yoktur. Sitemiz yarın ortadan kalksa bile kurulumunuz çalışmaya devam eder, satın aldığınız kaynak kodu da sizde kalır. İzlenmeye değer olan kendi sunucunuzdur; aşağıdaki sağlık ucu tam bunun içindir.

Mobil uygulama

Mobil uygulama var mı?

Evet — native Android uygulaması, kurmaya hazır imzalı bir APK olarak indirmenin içinde geliyor. Tek ve jenerik bir uygulamadır: her kullanıcı girişte sizin sunucunuzun adresini yazar, yani her kurulum için ayrı derleme yapmanız gerekmez. iPhone ve masaüstünde Chatstead tarayıcıdan PWA olarak kurulur (Ana Ekrana Ekle).

Uygulama kapalıyken bildirim gelir mi?

Evet. Self-hosted bir üründe push servisi yoktur — Firebase yok, aktarıcı yok — bu yüzden uygulama sizin sunucunuza olan bağlantıyı bir arka plan servisiyle açık tutar. Android’in bildirim çekmecesinde kalıcı, düşük öncelikli bir “Bağlantı açık” satırı görmenizin sebebi budur; mesajlarınızı başkasının üzerinden geçirmemenin bedeli. Uygulamanın istediği pil optimizasyonu muafiyetini verin; Xiaomi/Huawei telefonlarda ayrıca Otomatik Başlat’ı açın, yoksa üreticinin pil yöneticisi servisi öldürebilir.

Uygulamayı kendi adım ve ikonumla dağıtabilir miyim?

Evet. Android projesinin tamamı pakete dahildir; ad, ikon, paket kimliği ve imzalama anahtarını değiştirme adımlarıyla birlikte (bkz. docs/ANDROID.md ve lisans koşullarınız). Uygulamanın içinde bize bağlanan hiçbir şey yoktur.

Hangi Android sürümleri destekleniyor?

Android 7.0 ve üzeri. Uygulama doğrudan kurduğunuz bir APK olarak dağıtılır; uygulama mağazası hesabı gerekmez. Not: Android kendinden imzalı sertifikayı reddeder; ya güvenilir sertifikalı gerçek bir alan adı kullanın ya da yerel ağınızda düz HTTP ile bağlanın.

Kurulum

Teknik biri olmam gerekir mi?

Hayır. Temiz bir Ubuntu sunucuya tek komut kopyalarsınız, sonra tarayıcıda kolay bir sihirbazla kurulumu bitirirsiniz.

Anlatım videosunu izle ↗
root olarak giriş yapmam gerekir mi?

Hayır — sudo yetkili bir kullanıcı yeterli. Sistem servisi kurmak yükseltilmiş yetki gerektirir, o yüzden komutlardaki sudo’yu koruyun.

Güvenilir HTTPS nasıl alırım?

Bir domaini sunucunuza yönlendirin; kurucu, Caddy üzerinden ücretsiz, otomatik yenilenen Let’s Encrypt sertifikası alır. Domaini ayarlamanın iki yolu için Dokümanlar’a bakın.

Anlatım videosunu izle ↗
Docker kullanabilir miyim?

Evet — paket bir Dockerfile ve iki compose dosyası içerir: biri Chatstead’i Caddy arkasında çalıştırıp otomatik Let’s Encrypt sertifikası alır (domaininizi yazıp başlatmanız yeter), diğeri domaininiz yokken kendinden imzalı sertifikayla çalışır.

Anlatım videosunu izle ↗

HTTPS & sertifikalar

HTTPS gerçekten gerekli mi?

Evet. Şifreleri ve mesajları şifrelemenin ötesinde: tarayıcılar HTTPS üzerinden sunulmayan bir sayfaya mikrofon, kamera, uygulama kurma ve bildirim izni vermez. HTTPS olmadan sesli mesaj, arama, “Ana ekrana ekle” ve push bildirimleri hata vermez — hiç görünmez, ürün bozukmuş gibi durur. Chatstead TLS’i her zaman açar; siz yalnızca hangi sertifika olacağını seçersiniz.

Güvenilir ve kendinden imzalı sertifika arasındaki fark ne?

İkisi de bağlantıyı birebir aynı şekilde şifreler. Güvenilir sertifika (Let’s Encrypt, ücretsiz) tarayıcıların zaten tanıdığı bir otorite tarafından onaylanır, dolayısıyla uyarı çıkmaz — ama domain adı gerektirir. Kendinden imzalı sertifikayı sunucu kendisi üretir: domainsiz, düz IP ile çalışır ama dışarıdan kimse sunucunun kimliğini doğrulamadığı için her tarayıcı cihaz başına bir kez uyarı verir.

Hangisi bana lazım?

Tek soru: insanlar ofis dışından da kullanacak mı? Evetse domain alıp güvenilir sertifikaya geçin — mobil veriyle bağlanan telefonlar, uzaktan çalışanlar, uygulama kurma ve push bildirimlerinin sorunsuz çalıştığı tek kurulum budur. Yalnızca ofis ağında kalacaksa kendinden imzalı makul bir tercihtir: trafik binanızdan hiç çıkmaz.

Anlatım videosunu izle ↗
Kendinden imzalı güvensiz mi?

Şifreleme birebir aynı güçte. Uyarı “sunucunun kimliğini dışarıdan bir otorite doğrulamadı” demektir — bu, neye bağlandığınızdan emin olamayacağınız açık internette önemlidir; kendi kontrolünüzdeki bir ağda ve tanıdığınız bir makinede çok daha az önemlidir.

Domainsiz başlayıp sonra ekleyebilir miyim?

Evet, istediğiniz zaman ve yeniden kurulum gerekmeden. Kurucuyu domaininizle tekrar çalıştırırsınız, güvenilir sertifikaya geçer; verileriniz ve hesaplarınız aynen kalır.

Hangi portlar açık olmalı?

Domain varsa: 80 ve 443 — 80, Let’s Encrypt’in domainin size ait olduğunu doğruladığı porttur ve ziyaretçileri HTTPS’e yönlendirir. Domain yoksa: 3443. Sağlayıcınızın dış güvenlik duvarını unutmayın (Hetzner Cloud Firewall, AWS security group vb.) — sunucunun kendi güvenlik duvarından ayrıdır.

3080 portu ne işe yarar, açmalı mıyım?

Şifrelenmemiş düz HTTP’dir ve yalnızca native mobil uygulamalar kendinden imzalı sertifikayı reddettiği için vardır. İnternete asla açmayın — üzerinden geçen her şey, şifreler dahil, yol boyunca okunabilir. Yerel ağınızda tutun; Docker’da tam bu nedenle varsayılan olarak yalnızca localhost’a bağlıdır.

Zaten nginx veya Traefik kullanıyorum. Chatstead arkasında çalışır mı?

Evet. Sertifikaları proxy’niz yönetmeye devam etsin; Chatstead’i NO_HTTPS=1 ve PORT=8080 ile çalıştırın, ardından TRUST_PROXY değerini proxy’nin adresi ya da ağı olarak verin — böylece audit kayıtları ve hız sınırları proxy’yi değil gerçek ziyaretçiyi görür. Proxy’nin WebSocket yükseltmelerini iletmesi gerekir.

Hesaplar & yönetim

Giriş ekranında “Kayıt” linki yok — neden?

Kendi kendine kayıt güvenlik için varsayılan olarak kapalıdır. Admin olarak girin → Kayıt & Güvenlik → “Kullanıcılar kendileri kayıt olabilsin” seçeneğini açın; giriş ekranında Kayıt linki belirir. Ya da kullanıcıları panelden elle ekleyin.

Kullanıcılar hesabı nasıl alır?

Ya admin oluşturur ya da kendi kendine kaydı açarsınız ve insanlar kendileri kaydolur (captcha ile, opsiyonel e-posta doğrulama / admin onayı).

Kendi markama benzetebilir miyim?

Evet — adınızı, logonuzu ve ikonunuzu panelden ayarlayın. Değişiklikler anında uygulanır, kod gerekmez.

Admin şifresini unuttum.

Başka bir adminden sıfırlamasını isteyin. Her zaman kurtarabilmek için yedek tutun.

İşletim

Verilerim nerede?

Sunucunuzdaki bir veri klasöründe (veritabanı, anahtarlar, sertifika, marka) ve dosyalar için bir yüklemeler klasöründe. İkisini de yedekleyin.

Veri kaybetmeden nasıl güncellerim?

Yeni sürümü yükleyip kurucuyu tekrar çalıştırın — veri korunur ve şema otomatik göç eder. Önce yedek alın.

Yedekleme betiği var mı?

Evet, günlük bir yedekleme betiği dahildir ve cron ile zamanlanabilir.

Kurulumumu nasıl izlerim?

Her kurulum GET /api/health ucunu sunar: durum, sürüm, çalışma süresi, kurulumun tamamlanıp tamamlanmadığı ve lisans durumu döner. Veritabanı yanıt vermiyorsa “degraded” bildirir; yani port yoklamasından öte gerçek bir sağlık kontrolüdür. İstediğiniz izleme aracını buraya yöneltin — UptimeRobot, Uptime Kuma, Zabbix, Datadog ya da kendi betiğiniz.

Cevabını bulamadınız mı? hello@chatstead.com

Denemeye hazır mısınız?