VPS Üzerinde HedgeDoc'i Kendin Host Etme (Tam Kılavuz)

Giriş

HedgeDoc, çok kullanıcının gerçek zamanlı olarak belge düzenlemesine olanak tanıyan işbirlikçi bir markdown editörüdür. Genellikle ekipler arasında not alma ve dokümantasyon amacıyla kullanılır. VPS üzerinde HedgeDoc’i kendin host etmek, verileriniz üzerinde tam kontrol sağlar ve gizliliği güvence altına alır. Bu kılavuzda, Docker kullanarak VPS üzerinde HedgeDoc kurulumunu adım adım anlatacağız.

Gereksinimler

1. Bir VPS: Uygun bir VPS sağlayıcısı seçin. İşte bazı popüler seçeneklerin hızlı karşılaştırması:

Farklı VPS sağlayıcılarının detaylı karşılaştırmaları için tüm VPS karşılaştırmamıza göz atabilirsiniz.

2. SSH Erişimi: VPS’inize SSH üzerinden erişebildiğinizden emin olun.

3. Docker ve Docker Compose: VPS’inizde Docker ve Docker Compose’un yüklü olması gerekir. Aşağıdaki komutlarla kurabilirsiniz:

   sudo apt update
   sudo apt install -y docker.io docker-compose

Adım 1: HedgeDoc Ortamını Kurma

1. HedgeDoc için bir dizin oluşturun:

   mkdir ~/hedgedoc
   cd ~/hedgedoc

2. hedgedoc dizininde bir docker-compose.yml dosyası oluşturun. PostgreSQL’i veritabanı olarak kullanacak şekilde aşağıdaki yapılandırmayı ekleyin:

   version: '3.1'
   
   services:
     hedgedoc:
       image: hedgedoc/hedgedoc:latest
       environment:
         - CMD_URI=https://your-domain.com
         - DB_TYPE=postgres
         - DB_HOST=db
         - DB_PORT=5432
         - DB_USER=hedgedoc
         - DB_PASS=hedgedoc_password
         - DB_NAME=hedgedoc
       ports:
         - '3000:3000'
       depends_on:
         - db
   
     db:
       image: postgres:latest
       environment:
         - POSTGRES_USER=hedgedoc
         - POSTGRES_PASSWORD=hedgedoc_password
         - POSTGRES_DB=hedgedoc
       volumes:
         - db_data:/var/lib/postgresql/data
   
   volumes:
     db_data:

3. your-domain.com ifadesini, HedgeDoc’e erişmek için kullanacağınız gerçek alan adıyla değiştirin.

Adım 2: HedgeDoc’i Çalıştırma

1. Docker Compose kullanarak HedgeDoc uygulamasını başlatın:

   docker-compose up -d

2. HedgeDoc’in düzgün çalıştığını doğrulamak için günlükleri kontrol edin:

   docker-compose logs -f

3. Varsayılan olarak, HedgeDoc http://your-server-ip:3000 adresinden erişilebilir olacaktır. Üretim ortamı için ters proxy yapılandırması yapmanız gerekir.

Adım 3: Nginx ile Ters Proxy Kurulumu

1. Nginx’i yükleyin:

   sudo apt install -y nginx

2. HedgeDoc için yeni bir yapılandırma dosyası oluşturun:

   sudo nano /etc/nginx/sites-available/hedgedoc

3. Aşağıdaki yapılandırmayı ekleyin:

   server {
       listen 80;
       server_name your-domain.com;
   
       location / {
           proxy_pass http://localhost:3000;
           proxy_set_header Host $host;
           proxy_set_header X-Real-IP $remote_addr;
           proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
           proxy_set_header X-Forwarded-Proto $scheme;
       }
   }

4. Yapılandırmayı etkinleştirin:

   sudo ln -s /etc/nginx/sites-available/hedgedoc /etc/nginx/sites-enabled/
   sudo nginx -t
   sudo systemctl restart nginx

Adım 4: SSL ile HedgeDoc Güvenliği

1. HedgeDoc örneğinizi güvenli hale getirmek için Let’s Encrypt kullanabilirsiniz. Certbot’u yükleyin:

   sudo apt install -y certbot python3-certbot-nginx

2. Certbot’u çalıştırarak alan adınız için SSL alın:

   sudo certbot --nginx -d your-domain.com

Sıkça Sorulan Sorular

1. HedgeDoc’i kendin host etmenin avantajları nelerdir?

HedgeDoc’i kendin host etmek, verileriniz ve gizliliğiniz üzerinde benzersiz kontrol sağlar. Bulut tabanlı seçeneklerin aksine, kendiniz host ederken güvenlik güncellemelerini ve özelleştirmeleri ihtiyaçlarınıza göre yönetirsiniz. Bu yapı, belirli veri işleme süreçlerine uyum sağlaması gereken geliştiriciler ve ev laboratuvar meraklıları için çok önemlidir veya HedgeDoc’i daha büyük sistemlere entegre etmek isteyenler için idealdir.

2. Düşük özelliklere sahip VPS üzerinde HedgeDoc çalıştırabilir miyim?

Evet, HedgeDoc, sistem gereksinimlerini karşıladığı sürece düşük özellikli VPS üzerinde verimli şekilde çalışabilir. Temel operasyonlar için 2 GB RAM ve minimum disk alanı yeterlidir. Ancak, daha büyük örnekler veya birden fazla kullanıcıyla işbirliği yapmayı planlıyorsanız, en az 4 GB RAM ve 50 GB disk alanı olan bir VPS tercih etmek performansı artırır. Contabo ve Hetzner gibi sağlayıcıların fiyatlandırma yapıları bu ihtiyacı uygun seviyelerde karşılayabilir.

3. HedgeDoc kurulumumu nasıl güncellerim?

HedgeDoc’in Docker tabanlı olması sayesinde güncellemek oldukça basittir. En son imajı çekip konteynerleri yeniden başlatmanız yeterlidir. İşte yapmanız gerekenler:

docker-compose pull
docker-compose up -d

Bu komutları çalıştırdıktan sonra, düzenli olarak HedgeDoc sürüm notlarını kontrol etmeli ve herhangi bir değişiklik veya geçiş adımları olup olmadığını takip etmelisiniz. Versiyon güncellemeleriyle ilgili detaylar için HedgeDoc dokümantasyonuna bakabilirsiniz.

Sonuç

VPS üzerinde HedgeDoc’i kendin host etmek, güçlü bir markdown editörünün avantajlarından yararlanırken ortamınız üzerinde tam kontrol sağlar. Yukarıda anlatılan adımlarla HedgeDoc’i kurabilir, yapılandırabilir ve güvenlik altına alabilirsiniz. Gizlilik ve veri bütünlüğünden ödün vermeden gerçek zamanlı işbirliğinin keyfini çıkarın. --- END ---