Skip to content

Kurulum

Relay'i kendi sunucunuza Docker Compose ile kurma ve ilk kurulumu tamamlama kılavuzu.

Genel bakış

Relay, bir Docker Compose yığını olarak gelir — app konteyneri (Node.js sunucusu ve her numara için sürümü sabitlenmiş bir Chrome) ve HTTPS'i sonlandıran bir nginx konteyneri. Kontrol ettiğiniz bir Linux sunucusunda çalıştırırsınız. Bu kılavuz, boş bir sunucudan ilk çalışma alanını oluşturmaya hazır, giriş yapmış bir sistem yöneticisine kadar götürür.

Not: Bu ayrıntılı anlatımdır. Depo README dosyası aynı adımları özet biçimde içerir.

Başlamadan önce

Şunlara ihtiyacınız olacak:

  • Bir Linux sunucusu (Ubuntu 22.04 / Debian 12), 2 GB RAM artı bağlayacağınız her WhatsApp numarası için ~0,8 GB ve ~20 GB disk.
  • Docker 24+ ve Compose v2.
  • Sunucuya yönlendirilen bir alan adı ve açık 80 ile 443 portları.
  • O alan adı için bir TLS sertifikası (ücretsiz bir Let's Encrypt sertifikası uygundur).

Adımlar

  1. Kodu alın ve klasöre girin. bash git clone <relay-depo-adresiniz> relay cd relay

  2. Ortam dosyanızı oluşturun. Örneği kopyalayın ve güçlü bir oturum gizli anahtarı belirleyin. bash cp .env.example .env .env dosyasını düzenleyin ve SESSION_SECRET değerini uzun, rastgele bir değere ayarlayın: bash openssl rand -hex 32

  3. TLS sertifikanızı ekleyin. Sertifikayı ve anahtarı ./ssl/ içine yerleştirin: ssl/ fullchain.pem privkey.pem Certbot ile ücretsiz sertifika almak için: bash certbot certonly --standalone -d alan-adiniz.com cp /etc/letsencrypt/live/alan-adiniz.com/fullchain.pem ssl/ cp /etc/letsencrypt/live/alan-adiniz.com/privkey.pem ssl/

  4. Yığını başlatın. bash docker compose up -d İlk derleme, sabitlenmiş tarayıcıyı indirdiği için birkaç dakika sürer. docker compose ps ile her iki servisin de çalıştığını kontrol edin.

  5. İlk kurulumu tamamlayın. Tarayıcıda https://alan-adiniz.com/admin adresini açın. Yeni bir kurulumda ilk kurulum ekranına yönlendirilirsiniz — sistem yöneticisi kullanıcı adı ve parolasını oluşturun, ardından bir kimlik doğrulayıcı uygulamayla (Google Authenticator, Authy, 1Password, …) TOTP QR kodunu tarayın. İlk kurulum: yönetici hesabını oluşturun İlk kurulumda gösterilen TOTP QR kodu

Not: Kimlik doğrulayıcıyı güvende tutun — Yönetim paneline her giriş yaptığınızda yeni bir 6 haneli kod gerekir. Kaybederseniz bkz. Sorun giderme → Yönetim panelinden kilitlenme.

  1. Sağlıklı olduğunu doğrulayın. bash curl -sf https://alan-adiniz.com/healthz # → relay-ok

Sonraki adımlar

Sistem yöneticisi olarak giriş yaptınız. Sırada, bir çalışma alanı oluşturun ve Yönetici hesabını oluşturun. Yedekleme ve güncellemeler için bkz. Operations.