Yönetilen Uygulamalar - Nextcloud¶

Bu makalede

• Nextcloud. Temel Özellikler
• Çalıştırma Özellikleri
• Nextcloud'u Managed App Olarak Çalıştırdıktan Sonra Başlangıç
• Nextcloud'u Marketplace'ten Çalıştırdıktan Sonra Başlangıç: Cloud-init ile Kurulum Parametrelerini Yapılandırma
• Nextcloud'u Çalıştırdıktan Sonra Başlangıç
• Domain Adını Değiştirme
• API Kullanarak Nextcloud Siparişi Verme

Nextcloud. Temel Özellikler¶

Nextcloud, verileri depolamak ve işlemek için etkili bir araç olmasını sağlayan birçok özelliğe sahiptir:

• Dosya depolama. Nextcloud, dosyaları bir sunucuda depolamanıza ve bunlara bir web arayüzü veya masaüstü bilgisayarlar ile mobil cihazlar için uygulamalar aracılığıyla erişmenize olanak tanır.
• Dosya senkronizasyonu. Dosyaları farklı cihazlar arasında senkronize etme yeteneği, hizmeti çeşitli koşullarda çalışmak için kullanışlı bir araç haline getirir.
• Versiyon kontrolü. Nextcloud, aynı dosyanın birden fazla sürümünü kaydetmenize olanak tanır. Ayrıca, ihtiyaç duyulması halinde önceki sürümleri geri yüklemenizi sağlar.
• Web arayüzü üzerinden dosyalara erişim. Nextcloud, dosyalara bir tarayıcı üzerinden erişmenizi sağlayan bir web arayüzüne sahiptir, bu da onu herhangi bir cihazda çalışmak için kullanışlı bir araç yapar.
• Takvim ve görev yönetimi. Nextcloud, takvimler ve görevler oluşturmanıza ve yönetmenize olanak tanıyarak organizasyon için yararlı bir araç sağlar.
• Kişi yönetimi. Nextcloud, kişileri oluşturmanıza ve yönetmenize olanak tanıyarak iletişim yönetimi için kullanışlı bir araç sağlar.
• Uygulamalar aracılığıyla dosyalara erişim. Nextcloud, dosyalara uygulamalar aracılığıyla erişmenizi sağlayan masaüstü bilgisayarlar ve mobil cihazlar için uygulamalara sahiptir.
• Genişletilebilirlik. Nextcloud, işlevselliği genişletmek için kurulup kullanılabilecek birçok ek uygulamaya sahiptir. Bunlar çevrimiçi iş birliği, belge düzenleme, proje yönetimi vb. için uygulamalardır.

Çalıştırma Özellikleri¶

• Nextcloud çekirdeğe (kernel) dahildir ve ek bir kurulum gerektirmez. Hizmetin kurulması ve yapılandırılması için bir web arayüzü sağlıyoruz.
• Yapılandırma dosyaları şuradadır:
  • /opt/nextcloud - Nextcloud kurulumu ve yapılandırması;
  • /opt/nginx - Nginx hizmetinin kurulumu ve yapılandırması;
  • /opt/nextcloud/compose.yml - Bir dizi Nextcloud + Onlyoffice konteynerini başlatan docker compose komutu.
• SSL sertifikası oluşturma işlemi jonasal/nginx-certbot derlemesine dayanmaktadır.

• Konteyner sürümlerini güncellemek ve yapılandırma dosyasını düzenlemek için aşağıdaki komutlar gerekli olabilir:

  • Konteynerleri durdurmak için şu komutu çalıştırın:

  cd /opt/nextcloud/
  

  Ardından:

  docker compose down
  

  • Konteynerleri etkinleştirmek için şu komutu çalıştırın:

  cd /opt/nextcloud/
  

  Ardından:

  docker compose up -d
  

• Docker compose up -d komutu, compose.yml dosyasını çalıştırarak aşağıdaki konteynerleri indirir ve başlatır:

  • db - PostgreSQL'in indirildiği ve aşağıdaki ayarların yapıldığı konteyner:
    • Nextcloud veritabanı (veya tabanı) oluşturulur;
    • Nextcloud kullanıcısı oluşturulur;
    • SSH şifresi (yazılımın çalışmaya hazır hale gelmesinin ardından sunucu hazır olduğunda e-posta adresinize gönderilir);
    • Standart port 5432'dir.
  • redis - Nextcloud çağrılarını bellekte ve yalnızca PostgreSQL veritabanındaki kayıtlardan sonra saklayan konteyner.
  • app - Nextcloud hizmetinin aşağıdaki parametrelere sahip olduğu konteyner:
    • Uygulamaya erişim, https://nextcloud(server_id).hostkey.in (örneğin, https://nextcloud16094.hostkey.in) bağlantısını kullanarak bir web tarayıcısı veya mobil uygulama üzerinden gerçekleştirilir;
    • login: admin;
    • password: ssh üzerinden gelen şifre;
  • onlyoffice-document-server - 80 portunda çalışan OnlyOffice hizmeti konteyneri.

  Dikkat

  Bu konteyner 6 dakika içinde başlar. Bu süre zarfında Nextcloud web arayüzüne gidebilir, dosya yükleyebilir ve indirebilirsiniz; ancak belge düzenleme özelliği ancak docker compose up -d çalıştırıldıktan 6 dakika sonra (bazı bileşenlerin başlatılması zaman alır) görünür olacaktır.

  • nginx - 80 ve 443 portlarından gelen istekleri kabul eden ve istekleri Nextcloud konteynerine yönlendiren Nginx hizmeti konteyneri.

Nextcloud'u Managed App Olarak Çalıştırdıktan Sonra Başlangıç¶

Nextcloud'u bir managed app olarak çalıştırdıktan sonra, sunucu kontrol panelindeki My Apps sekmesinde şunları bulabilirsiniz:

• bir uygulama bağlantısı;
• erişim için kullanıcı adı ve şifre;
• hizmet kullanımı ve yönetimi ile ilgili bilgiler.

Managed app'ler ile çalışma hakkında daha fazla ayrıntı için talimatlara bakın.

Nextcloud'u Marketplace'ten Çalıştırdıktan Sonra Başlangıç: Cloud-init ile Kurulum Parametrelerini Yapılandırma¶

Nextcloud içeren bir sunucu sipariş ederken, sipariş sürecindeki Automatization aşamasında cloud-init yapılandırmasını kullanarak ana kurulum parametrelerini önceden yapılandırabilirsiniz. Bu, yönetici kimlik bilgilerini, e-postayı ve veri depolama yolunu otomatik olarak ayarlamanıza olanak tanır:

Yapılandırma Parametreleri¶

Cloud-init aracılığıyla Nextcloud'u yapılandırmak için aşağıdaki formatı kullanın:

write_files:
  - path: "/opt/main.yml"
    permissions: "0644"
    content: |
      nextcloud_admin_name: "root"
      nextcloud_admin_pwd: "YOUR_PASSWORD"
      nextcloud_admin_email: "admin@localhost"
      nextcloud_data_path: "/opt/nextcloud-data"

Parametre Açıklaması

• nextcloud_admin_name - yönetici hesap adı (varsayılan: admin);
• nextcloud_admin_pwd - yönetici şifresi (güçlü bir şifre belirtin);
• nextcloud_admin_email - bildirimler için yönetici e-postası;
• nextcloud_data_path - Nextcloud verilerinin saklanacağı yol (varsayılan: /opt/nextcloud-data).

Nextcloud'u Çalıştırdıktan Sonra Başlangıç¶

Sipariş ödemesi yapıldıktan sonra sunucunun çalışmaya hazır olduğuna dair kayıt sırasında belirtilen e-postaya bir bildirim gönderilecektir. Bu bildirim, VPS'in IP adresinin yanı sıra bağlantı için kullanıcı adı ve şifreyi içerecektir. Şirketimizin müşterileri, sunuculardaki donanımı ve API kontrol panelini — Invapi — yönetmektedir.

Yetkilendirme verilerini sunucu kontrol panelindeki Configuration >> Tags sekmesinde veya gönderilen e-postada bulabilirsiniz.

• Nextcloud web arayüzü paneline erişim bağlantısı: webpanel etiketinde;
• Login: admin;
• Password: Yazılım kurulumu tamamlanıp sunucu kullanıma hazır hale geldikten sonra e-posta adresinize gönderilir.

Nextcloud kontrol paneline giriş yaptıktan sonra kullanıcı adınızı ve şifrenizi girmeniz gerekmektedir:

Başarılı bir şekilde giriş yaptıktan sonra hizmeti kullanmaya başlayabilirsiniz.

Domain Adını Değiştirme¶

Domain adını değiştirme işlemine başlamadan önce, talimatlarda belirtilen tüm dosyaların yedeğini almanız önerilir. Ana dosyaların yedeklerini oluşturmak için aşağıdaki komutları çalıştırın:

1. Yedekler için bir dizin oluşturun

   mkdir -p /root/nextcloud_backup
   

2. Nginx yapılandırma dosyasını kopyalayın

   cp /opt/nginx/user_conf.d/nextcloud<server ID>.hostkey.in.conf /root/nextcloud_backup/
   

3. Docker Compose dosyasını kopyalayın

   cp /opt/nextcloud/compose.yml /root/nextcloud_backup/
   

4. Yapılandırma betiğini kopyalayın

   cp /opt/nextcloud/set_configuration.sh /root/nextcloud_backup/
   

5. Nextcloud yapılandırma dosyasını kopyalayın

   cp /var/lib/docker/volumes/app_data/_data/config/config.php /root/nextcloud_backup/
   

Bu komutlar, domain adı değiştirme işlemi sırasında değiştirilecek olan tüm kritik dosyaların yedeklerini oluşturacaktır. Sorun yaşanması durumunda, orijinal yapılandırmayı bu yedeklerden geri yükleyebilirsiniz.

Yedeklerden Geri Yükleme ve Başarılı Göç Sonrası Silme¶

Domain adı değiştirme işlemi başarısız olursa ve orijinal yapılandırmayı geri yüklemeniz gerekirse, aşağıdaki komutları çalıştırın:

1. Nginx yapılandırma dosyasını geri yükleyin

   cp /root/nextcloud_backup/nextcloud<server ID>.hostkey.in.conf /opt/nginx/user_conf.d/
   

2. Docker Compose dosyasını geri yükleyin

   cp /root/nextcloud_backup/compose.yml /opt/nextcloud/
   

3. Yapılandırma betiğini geri yükleyin

   cp /root/nextcloud_backup/set_configuration.sh /opt/nextcloud/
   

4. Nextcloud yapılandırma dosyasını geri yükleyin

   cp /root/nextcloud_backup/config.php /var/lib/docker/volumes/app_data/_data/config/
   

5. Konteynerleri yeniden başlatın

   cd /opt/nextcloud
   docker compose down
   docker compose up -d
   

6. Nginx'i yeniden başlatın

   docker restart nginx-certbot
   

Bu komutlar tüm yapılandırma dosyalarını orijinal durumuna döndürecek ve gerekli hizmetleri yeniden başlatacaktır.

Domain adı değişikliğinin başarılı olduğundan ve her şeyin doğru çalıştığından emin olduktan sonra (tam test için en az 24-48 saat beklenmesi önerilir), yedekleri güvenle silebilirsiniz:

1. Yedek dizininin içeriğini kontrol edin

   ls -la /root/nextcloud_backup/
   

2. Tüm yedek dizinini silin

   rm -rf /root/nextcloud_backup/
   

Silme işleminden önce, yalnızca gerekli dosyaları sildiğinizden emin olmak için dizin içeriğini kontrol etmeniz önerilir.

Dosyaları Yapılandırma¶

1. Sunucuya SSH ile bağlanın:

   ssh root@IP_ADDRESS
   

2. Hostname'i değiştirin (isteğe bağlı):

   hostnamectl set-hostname nextcloud_server
   

3. /etc/hosts dosyasını düzenleyin:

   nano /etc/hosts
   

   Yeni domaini sunucunun IP adresine bağlayan bir satır ekleyin:

   IP_ADDRESS YOUR_DOMAIN_NAME
   

   (IP adresini ve domain adını kendi değerlerinizle değiştirin)

Nginx Yapılandırması¶

1. Nginx yapılandırma dosyasını bulun ve düzenleyin:

   nano /opt/nginx/user_conf.d/nextcloud<server ID>.hostkey.in.conf
   

   Eski domain adının (nextcloud<server ID>.hostkey.in) tüm örneklerini yenisiyle (YOUR_DOMAIN_NAME) değiştirin:

   • Satır 4: server_name nextcloud<server ID>.hostkey.in; > server_name YOUR_DOMAIN_NAME;
   • Satır 15: server_name nextcloud<server ID>.hostkey.in; > server_name YOUR_DOMAIN_NAME;
   • Satır 17: ssl_certificate /etc/letsencrypt/live/nextcloud<server ID>.hostkey.in/fullchain.pem; > ssl_certificate /etc/letsencrypt/live/YOUR_DOMAIN_NAME/fullchain.pem;
   • Satır 18: ssl_certificate_key /etc/letsencrypt/live/nextcloud<server ID>.hostkey.in/privkey.pem; > ssl_certificate_key /etc/letsencrypt/live/YOUR_DOMAIN_NAME/privkey.pem;
   • Satır 19: ssl_trusted_certificate /etc/letsencrypt/live/nextcloud<server ID>.hostkey.in/chain.pem; > ssl_trusted_certificate /etc/letsencrypt/live/YOUR_DOMAIN_NAME/chain.pem;

2. Yapılandırma dosyasının adını değiştirin:

   mv /opt/nginx/user_conf.d/nextcloud<server ID>.hostkey.in.conf /opt/nginx/user_conf.d/YOUR_DOMAIN_NAME.conf
   

3. Nginx konteynerini yeniden başlatın:

   docker restart nginx-certbot
   

Nextcloud Yapılandırması¶

1. Docker Compose dosyasını düzenleyin:

   nano /opt/nextcloud/compose.yml
   

   Eski domain adının tüm örneklerini yenisiyle (YOUR_DOMAIN_NAME) değiştirin. Özellikle şu satırlara dikkat edin:

   • Satır 40: - OVERWRITECLIURL=https://nextcloud<server ID>.hostkey.in/
   • Satır 41: - OVERWRITEHOST=nextcloud<server ID>.hostkey.in

2. Nextcloud yapılandırma betiğini düzenleyin:

   nano /opt/nextcloud/set_configuration.sh
   

   Eski domain adının tüm örneklerini yenisiyle değiştirin. Özellikle şu satırlara dikkat edin:

   • Satır 11: if ! grep -q "nextcloud<server ID>.hostkey.in" trusted_domain.tmp; then
   • Satır 13: docker exec -u www-data app-server php occ --no-warnings config:system:set trusted_domains $TRUSTED_INDEX --value="nextcloud<server ID>.hostkey.in"
   • Satır 23: docker exec -u www-data app-server php occ --no-warnings config:system:set onlyoffice StorageUrl --value="https://nextcloud<server ID>.hostkey.in/

Değişiklikleri Uygulama¶

1. Nextcloud dizinine gidin:

   cd /opt/nextcloud
   

2. Mevcut konteynerleri durdurun ve kaldırın:

   docker compose down
   

   Bu komut, compose.yml dosyasında tanımlı tüm konteynerleri durdurup kaldıracaktır ancak volume içindeki tüm verileri koruyacaktır.

3. Nextcloud konteynerlerini başlatın:

   docker compose up -d
   

4. Yapılandırma betiğini çalıştırın:

   bash /opt/nextcloud/set_configuration.sh
   

   Eğer betik, "maintenance:install" komutunun tanımlı olmadığına dair bir hata verirse, bu normaldir; Nextcloud zaten kurulmuştur.

Kontrol Etme ve Hata Ayıklama¶

1. Nextcloud'un yeni domain adı üzerinden erişilebilir olduğunu doğrulayın:

   Tarayıcınızda https://YOUR_DOMAIN_NAME adresini açın

   

2. Sorun varsa günlükleri (logs) kontrol edin:

   docker logs nginx-certbot
   docker logs app-server
   

3. Gerekirse trusted_domains ayarını manuel olarak yapılandırın:

   docker exec -u www-data app-server php occ --no-warnings config:system:set trusted_domains 1 --value="YOUR_DOMAIN_NAME"
   docker exec -u www-data app-server php occ --no-warnings config:system:set overwrite.cli.url --value="https://YOUR_DOMAIN_NAME/"
   

4. OnlyOffice kullanılıyorsa, ayarlarını doğrulayın:

   docker exec -u www-data app-server php occ --no-warnings config:system:set onlyoffice StorageUrl --value="https://YOUR_DOMAIN_NAME/"
   

Önemli Notlar¶

• Değişiklikleri yaptıktan sonra tarayıcı önbelleğini temizlemeniz çok önemlidir;
• Tüm kullanıcı kimlik bilgileri, domain adı değiştirilmeden öncekiyle aynı kalır;
• DNS sağlayıcınızın kayıt güncellemeleri için süreye ihtiyacı varsa, yeni domain adı çalışmaya başlamadan önce bir gecikme yaşanabilir;
• DNS'deki A kaydının sunucunuzun doğru IP adresini gösterdiğinden emin olun;
• PTR kaydı (reverse DNS) Nextcloud'un çalışması için kritik değildir ancak tam tutarlılık için kontrol paneli üzerinden güncellenebilir.

API Kullanarak Nextcloud Siparişi Verme¶

Bu yazılımı API kullanarak kurmak için bu talimatları izleyin.