Codiad: Ubuntu VPS Üzerine Kurulum ve Yapılandırma Rehberi

Codiad: Ubuntu VPS Üzerine Kurulum ve Yapılandırma Rehberi

Giriş

Günümüz yazılım geliştirme dünyasında, esneklik ve erişilebilirlik, geliştiriciler için kritik öneme sahiptir. Bulut tabanlı çözümlerin yükselişiyle birlikte, geliştirme ortamlarının herhangi bir yerden, herhangi bir cihazdan erişilebilir olması beklentisi artmıştır. Bu noktada, Codiad gibi web tabanlı Entegre Geliştirme Ortamları (IDE’ler) devreye girer. Codiad, özellikle küçük ve orta ölçekli projeler için tasarlanmış, hafif, açık kaynaklı ve kullanımı kolay bir web tabanlı IDE’dir. PHP ile yazılmıştır ve bir web tarayıcısı üzerinden dosya yönetimi, kod düzenleme, terminal erişimi ve hatta temel Git entegrasyonu gibi birçok temel geliştirme işlevini sunar.

Codiad’ın en büyük avantajlarından biri, bir sunucuya kurulduktan sonra, geliştiricilerin yerel makinelere herhangi bir yazılım kurma ihtiyacını ortadan kaldırmasıdır. Bu, özellikle ekip içinde standart bir geliştirme ortamı sağlamak, farklı cihazlar arasında geçiş yapmak veya hızlıca bir projeye başlamak isteyenler için idealdir. Bir Ubuntu Sanal Özel Sunucu (VPS) üzerine Codiad kurarak, kendi kişisel veya ekip tabanlı bulut IDE’nizi oluşturabilir, projelerinizi doğrudan sunucu üzerinde geliştirebilir ve test edebilirsiniz. Bu sayede, yerel makinenizin kaynaklarını boş yere harcamadan, sunucunuzun gücünden faydalanarak daha verimli bir geliştirme süreci yaşayabilirsiniz.

Bu kapsamlı rehberde, bir Ubuntu VPS üzerine Codiad’ı adım adım nasıl kuracağınızı ve yapılandıracağınızı detaylı bir şekilde ele alacağız. Sunucu hazırlığından başlayarak, gerekli web sunucusu ve PHP bileşenlerinin kurulumuna, Codiad dosyalarının yerleştirilmesine, web arayüzü üzerinden ilk yapılandırmaya ve son olarak güvenlik önlemlerine kadar tüm süreçleri kapsayacağız. Amacımız, bu rehberi takip ederek, kendi Codiad ortamınızı başarıyla kurup kullanmaya başlayabilmenizi sağlamaktır.

Codiad Kurulumu İçin Ön Gereksinimler

Codiad’ı Ubuntu VPS üzerine kurmaya başlamadan önce, bazı temel gereksinimleri karşılamanız ve sunucunuzu hazırlamanız gerekmektedir. Bu bölüm, kurulum sürecinin sorunsuz ilerlemesi için gereken altyapıyı ve yazılımları detaylandırmaktadır.

Ubuntu VPS ve SSH Erişimi

Öncelikle, aktif bir Ubuntu VPS’e ihtiyacınız olacak. Çoğu VPS sağlayıcısı, Ubuntu’nun son LTS (Uzun Süreli Destek) sürümlerini (örneğin Ubuntu 20.04 LTS veya 22.04 LTS) sunar. Bu rehber, bu sürümlerle uyumlu olacaktır. Sunucuya SSH (Secure Shell) üzerinden erişiminiz olmalı ve sudo yetkilerine sahip bir kullanıcı hesabınız bulunmalıdır. SSH, sunucunuza güvenli bir şekilde komut göndermenizi sağlar.

ssh kullanici_adiniz@vps_ip_adresiniz

Alan Adı ve DNS Yapılandırması (Opsiyonel ama Önerilir)

Codiad’a bir alan adı (örneğin ide.alanadiniz.com) üzerinden erişmek, IP adresi kullanmaktan çok daha profesyonel ve kolaydır. Ayrıca, HTTPS (SSL/TLS) kurulumu için de bir alan adına ihtiyacınız olacaktır. Eğer bir alan adınız varsa, DNS kayıtlarınızda (genellikle A kaydı) alan adınızı veya alt alan adınızı VPS’inizin IP adresine yönlendirdiğinizden emin olun. Bu, Codiad’a web tarayıcısı üzerinden erişmenizi sağlayacaktır.

Temel Web Sunucusu ve PHP Ortamı

Codiad, PHP ile yazılmış bir uygulamadır ve çalışması için bir web sunucusu (Apache veya Nginx) ile PHP yorumlayıcısına ihtiyaç duyar.

Apache veya Nginx

Bu rehberde Apache web sunucusunu kullanacağız, çünkü Ubuntu üzerinde yaygın olarak kullanılır ve yapılandırması nispeten kolaydır. Ancak, Nginx’i tercih ediyorsanız, yapılandırma adımları benzer olacaktır. Apache, mod_php veya php-fpm ile PHP’yi çalıştırabilirken, Nginx genellikle php-fpm ile birlikte kullanılır.

PHP ve Gerekli Modüller

Codiad’ın düzgün çalışması için belirli PHP modüllerine ihtiyacı vardır. Genellikle PHP’nin 7.4 veya daha yeni bir sürümü önerilir. Kurulması gereken temel PHP modülleri şunlardır:
* php-cli: Komut satırı PHP yorumlayıcısı.
* php-common: PHP için ortak dosyalar.
* php-fpm (Nginx için) veya libapache2-mod-php (Apache için): Web sunucusu ile PHP arasındaki arayüz.
* php-json: JSON veri işleme desteği.
* php-zip: ZIP arşivlerini işleme desteği (Codiad güncellemeleri ve eklentileri için).
* php-gd: Görüntü işleme desteği (bazı eklentiler veya arayüz öğeleri için).
* php-mbstring: Çok baytlı dizeler için destek (karakter kodlaması).
* php-xml: XML işleme desteği.
* php-curl: URL’ler üzerinden veri transferi (bazı eklentiler için).
* php-mysql (isteğe bağlı): Eğer Codiad üzerinden veritabanı bağlantısı gerektiren projeler geliştirecekseniz. Codiad’ın kendisi bir veritabanı gerektirmez.

Bu ön gereksinimleri anladıktan ve sunucunuzun bunlara hazır olduğundan emin olduktan sonra, kurulumun bir sonraki aşamasına geçebiliriz.

Ubuntu VPS Üzerinde Sunucu Ortamının Hazırlanması

Bu bölümde, Codiad için gerekli temel yazılımları kuracak ve sunucunuzu web tabanlı IDE’yi barındırmaya hazır hale getireceğiz. Bu adımlar, Apache web sunucusu ve PHP’nin en uygun şekilde yapılandırılmasını içerir.

Sistem Güncellemesi ve Temel Paketlerin Kurulumu

Kuruluma başlamadan önce, sunucunuzdaki paket listesini güncellemek ve mevcut paketleri en son sürümlerine yükseltmek her zaman iyi bir uygulamadır. Bu, güvenlik açıklarını kapatmaya ve uyumluluk sorunlarını önlemeye yardımcı olur.

sudo apt update
sudo apt upgrade -y

Ardından, bazı temel araçları kurmak faydalı olabilir, örneğin unzip (Codiad arşivini açmak için) ve git (Codiad’ı doğrudan GitHub’dan çekmek veya projelerde versiyon kontrolü kullanmak için).

sudo apt install -y unzip git

Web Sunucusu Kurulumu ve Yapılandırması (Apache Örneği)

Bu rehberde Apache’yi tercih ediyoruz. Apache’yi kurmak ve Codiad için bir sanal host yapılandırmak oldukça basittir.

Apache Kurulumu

Apache web sunucusunu aşağıdaki komutla kurun:

sudo apt install -y apache2

Kurulum tamamlandıktan sonra, Apache servisinin çalıştığından emin olun ve sistem başlangıcında otomatik olarak başlaması için etkinleştirin:

sudo systemctl start apache2
sudo systemctl enable apache2
sudo systemctl status apache2

Web tarayıcınızda VPS’inizin IP adresini ziyaret ederek Apache’nin varsayılan karşılama sayfasını görmelisiniz.

Apache Sanal Host (Virtual Host) Yapılandırması

Codiad’ı kendi alan adınız veya alt alan adınız üzerinden erişilebilir kılmak için özel bir sanal host dosyası oluşturacağız. Bu, Apache’nin belirli bir alan adına gelen istekleri Codiad’ın yüklü olduğu dizine yönlendirmesini sağlar.

Yeni bir sanal host yapılandırma dosyası oluşturalım. Örneğin, Codiad’ı ide.alanadiniz.com adresinden çalıştırmak istiyorsanız:

sudo nano /etc/apache2/sites-available/codiad.conf

Dosyanın içine aşağıdaki içeriği yapıştırın. ServerName ve DocumentRoot kısımlarını kendi alan adınıza ve Codiad’ı kuracağınız dizine göre ayarlayın. Genellikle /var/www/html altına bir klasör oluşturmak iyi bir yaklaşımdır.

    ServerAdmin webmaster@localhost
    ServerName ide.alanadiniz.com
    DocumentRoot /var/www/html/codiad

    
        Options Indexes FollowSymLinks MultiViews
        AllowOverride All
        Require all granted
    

    ErrorLog ${APACHE_LOG_DIR}/codiad_error.log
    CustomLog ${APACHE_LOG_DIR}/codiad_access.log combined

Dosyayı kaydedin (Ctrl+O, Enter) ve kapatın (Ctrl+X).

Şimdi bu sanal host’u etkinleştirin ve Apache’nin varsayılan yapılandırmasını devre dışı bırakın (eğer kullanmıyorsanız):

sudo a2ensite codiad.conf
sudo a2dissite 000-default.conf # Eğer varsayılanı kullanmıyorsanız
sudo apache2ctl configtest

Syntax OK çıktısını alırsanız, Apache yapılandırmasını yeniden yükleyin:

sudo systemctl reload apache2

PHP ve Gerekli Modüllerin Kurulumu

Codiad için gerekli PHP sürümünü ve modüllerini kuralım. Ubuntu 20.04/22.04 genellikle PHP 7.4 veya 8.x sürümlerini destekler. Bu rehberde PHP 8.1’i kullanacağız.

sudo apt install -y php8.1 libapache2-mod-php8.1 php8.1-cli php8.1-common php8.1-json php8.1-zip php8.1-gd php8.1-mbstring php8.1-xml php8.1-curl

Kurulumdan sonra, Apache’nin PHP modülünü doğru bir şekilde yüklediğinden emin olmak için Apache’yi yeniden başlatın:

sudo systemctl restart apache2

PHP’nin doğru çalıştığını test etmek için, Codiad’ı kuracağınız dizinde geçici bir info.php dosyası oluşturabilirsiniz:

sudo nano /var/www/html/codiad/info.php

Dosyanın içine aşağıdaki içeriği ekleyin:

Kaydedin ve kapatın. Ardından tarayıcınızdan http://ide.alanadiniz.com/info.php adresine giderek PHP bilgilerini görmelisiniz. İşiniz bittiğinde güvenlik için bu dosyayı silmeyi unutmayın:

sudo rm /var/www/html/codiad/info.php

Güvenlik Duvarı Yapılandırması (UFW)

Güvenlik duvarı, sunucunuza yetkisiz erişimi engellemek için kritik öneme sahiptir. Ubuntu’da varsayılan olarak UFW (Uncomplicated Firewall) bulunur. SSH, HTTP ve HTTPS trafiğine izin vermek için UFW’yi yapılandıralım:

sudo ufw allow OpenSSH
sudo ufw allow 'Apache Full' # Hem HTTP (80) hem de HTTPS (443) için
sudo ufw enable
sudo ufw status

ufw status komutu, etkin kuralları listelemeli ve güvenlik duvarının etkin olduğunu göstermelidir.

Git Kurulumu (Opsiyonel ama Önerilir)

Codiad içerisinde Git versiyon kontrol sistemini kullanmak isterseniz, sunucunuza Git’i kurmanız gerekmektedir. Daha önce kurmadıysanız:

sudo apt install -y git

Bu adımları tamamladığınızda, Ubuntu VPS’iniz Codiad kurulumuna hazırdır.

Codiad Dosyalarının İndirilmesi ve Yerleştirilmesi

Sunucu ortamımızı hazırladıktan sonra, Codiad’ın çekirdek dosyalarını indirip web sunucumuzun erişebileceği bir konuma yerleştirme zamanı geldi.

Codiad Dosyalarını İndirme

Codiad’ın en güncel sürümünü genellikle GitHub deposundan indirebilirsiniz. wget komutu ile en son kararlı sürümün ZIP arşivini doğrudan sunucuya çekebiliriz. Codiad’ın GitHub sayfasını kontrol ederek en son sürümün ZIP indirme bağlantısını bulabilirsiniz. Bu rehber için varsayımsal bir sürüm kullanacağız, ancak siz güncel olanı kullanmalısınız.

Öncelikle, Codiad dosyalarını geçici olarak indireceğimiz bir dizine gidelim, örneğin /tmp:

cd /tmp

Şimdi Codiad’ın ZIP arşivini indirelim. Güncel sürüm için GitHub Releases sayfasını kontrol etmeyi unutmayın.

wget https://github.com/Codiad/Codiad/archive/refs/heads/master.zip -O codiad.zip

Bu komut, master dalının en güncel halini codiad.zip olarak indirecektir. Eğer belirli bir sürümü (örneğin v2.8.x) indirmek isterseniz, ilgili sürümün ZIP bağlantısını kullanmalısınız.

Dosyaları Web Kök Dizinine Taşıma

İndirdiğimiz ZIP dosyasını açıp, daha önce Apache sanal host yapılandırmamızda belirttiğimiz web kök dizinine taşıyacağız. Sanal host dosyamızda /var/www/html/codiad olarak belirtmiştik.

Öncelikle ZIP dosyasını açalım:

sudo unzip codiad.zip -d /var/www/html/

Bu komut, Codiad-master (veya indirdiğiniz sürüme göre farklı bir isim) adında bir klasör oluşturacaktır. Bizim sanal host yapılandırmamız /var/www/html/codiad dizinini beklediği için, bu klasörü yeniden adlandırmamız veya içeriğini taşımamız gerekecek. En kolayı, açılan klasörü istediğimiz isme taşımaktır:

sudo mv /var/www/html/Codiad-master /var/www/html/codiad

Artık Codiad dosyaları /var/www/html/codiad dizininde bulunuyor. İndirilen ZIP dosyasını ve geçici klasörleri temizleyebilirsiniz:

rm /tmp/codiad.zip

Dosya İzinlerinin Ayarlanması

Codiad’ın düzgün çalışabilmesi için, web sunucusunun (Apache’nin çalıştığı kullanıcı olan www-data) Codiad dizinine ve alt dizinlerine yazma ve okuma izinlerine sahip olması gerekir. Özellikle data ve workspace gibi dizinler Codiad’ın proje dosyalarını ve kullanıcı ayarlarını depolaması için yazılabilir olmalıdır.

Öncelikle, Codiad dizininin sahipliğini www-data kullanıcısına ve grubuna verelim:

sudo chown -R www-data:www-data /var/www/html/codiad

Şimdi de dizinler için yazma izinlerini, dosyalar için okuma izinlerini ayarlayalım. Codiad’ın bazı dizinlerinin www-data tarafından yazılabilir olması gerekir. Genellikle data ve workspace dizinleri için 775 veya 777 izinleri önerilir. Ancak güvenlik açısından 775 daha iyidir.

sudo find /var/www/html/codiad -type d -exec chmod 755 {} \;
sudo find /var/www/html/codiad -type f -exec chmod 644 {} \;
sudo chmod -R 775 /var/www/html/codiad/data
sudo chmod -R 775 /var/www/html/codiad/workspace
sudo chmod -R 775 /var/www/html/codiad/plugins
sudo chmod -R 775 /var/www/html/codiad/themes

Bu komutlar:
* Tüm dizinlere 755 (sahip: okuma/yazma/çalıştırma, grup: okuma/çalıştırma, diğerleri: okuma/çalıştırma) izni verir.
* Tüm dosyalara 644 (sahip: okuma/yazma, grup: okuma, diğerleri: okuma) izni verir.
* data, workspace, plugins ve themes dizinlerine ve içeriklerine 775 izni verir. Bu, web sunucusu kullanıcısının bu dizinlere yazabilmesini sağlar.

Dosya izinleri kritik öneme sahiptir. Yanlış izinler, Codiad’ın çalışmamasına veya güvenlik açıkları oluşturmasına neden olabilir. Bu adımları dikkatlice uyguladığınızdan emin olun.

Codiad Web Arayüzü Üzerinden İlk Yapılandırma

Codiad dosyalarını sunucuya yerleştirip izinleri ayarladıktan sonra, web tarayıcınız üzerinden Codiad’ın kurulum sihirbazını çalıştırarak ilk yapılandırmayı tamamlayabiliriz.

Codiad Kurulum Sihirbazına Erişim

Web tarayıcınızı açın ve Codiad için yapılandırdığınız alan adını veya alt alan adını ziyaret edin (örneğin, http://ide.alanadiniz.com). Eğer her şey doğru yapılandırıldıysa, Codiad’ın karşılama veya kurulum ekranını görmelisiniz.

İlk ekranda Codiad, sunucunuzun sistem gereksinimlerini kontrol edecektir. PHP sürümü, gerekli modüller ve dosya/dizin izinleri gibi maddelerin yeşil tik ile işaretlendiğinden emin olun. Eğer herhangi bir kırmızı çarpı işareti görürseniz, bir önceki bölümlere dönerek eksik modülleri kurmalı veya dosya izinlerini düzeltmelisiniz. Genellikle bu ekran size hangi PHP modülünün eksik olduğunu veya hangi dizinin yazılabilir olmadığını açıkça belirtir.

Tüm gereksinimler karşılandığında, “Continue” veya “Devam Et” butonuna tıklayarak bir sonraki adıma geçebilirsiniz.

Yönetici Hesabı Oluşturma

Bu adımda, Codiad için bir yönetici hesabı oluşturmanız istenecektir. Bu hesap, Codiad’a ilk giriş yapacağınız ve tüm yönetici işlevlerini gerçekleştireceğiniz hesaptır.

Aşağıdaki bilgileri girmeniz gerekecektir:
* Username (Kullanıcı Adı): Codiad’a giriş yapmak için kullanacağınız bir kullanıcı adı belirleyin. Güvenlik için kolay tahmin edilemeyen bir kullanıcı adı seçmek iyi bir fikirdir.
* Password (Şifre): Güçlü bir şifre belirleyin. Büyük ve küçük harfler, rakamlar ve özel karakterler içeren, en az 12-16 karakter uzunluğunda bir şifre kullanmanız şiddetle tavsiye edilir.
* Email (E-posta): Yönetici hesabınızla ilişkilendirmek istediğiniz bir e-posta adresi girin. Bu, ileride şifre sıfırlama veya bildirimler için kullanılabilir.
* Project Name (Proje Adı): Codiad’ın ilk olarak oluşturacağı varsayılan projenin adını girin. Örneğin, “MyFirstProject” veya “DefaultWorkspace”.
* Project Path (Proje Yolu): Bu proje dosyalarının sunucuda nerede saklanacağını belirtir. Genellikle /var/www/html/codiad/workspace/proje_adiniz gibi bir yol olacaktır. Varsayılanı bırakmak genellikle sorun olmaz.

Tüm bilgileri girdikten sonra, “Install Codiad” veya “Codiad’ı Kur” butonuna tıklayın.

Sistem Gereksinimleri Kontrolü ve Sonlandırma

Kurulum butona tıkladıktan sonra Codiad, gerekli dizinleri oluşturacak, yönetici hesabını yapılandıracak ve ilk projenizi oluşturacaktır. Bu işlem genellikle birkaç saniye sürer.

Kurulum başarıyla tamamlandığında, genellikle sizi yönetici giriş ekranına yönlendiren bir mesaj veya bağlantı göreceksiniz. Oluşturduğunuz kullanıcı adı ve şifre ile giriş yapabilirsiniz.

Giriş yaptıktan sonra, Codiad’ın ana arayüzü ile karşılaşacaksınız. Sol tarafta dosya yöneticisi, ortada kod düzenleyici ve altta terminal veya çıktı pencereleri gibi temel IDE bileşenlerini göreceksiniz. Artık Codiad’ınız kullanıma hazır!

Önemli Güvenlik Notu: Kurulum tamamlandıktan sonra, Codiad otomatik olarak install.php dosyasını silmeye çalışır. Eğer bu dosyayı silemezse, güvenlik nedeniyle sizin manuel olarak silmeniz gerekir. Tarayıcınızdan http://ide.alanadiniz.com/install.php adresine gitmeye çalışın. Eğer “404 Not Found” veya benzeri bir hata alırsanız, dosya silinmiş demektir. Eğer kurulum ekranı tekrar gelirse, SSH üzerinden sunucunuza bağlanıp sudo rm /var/www/html/codiad/install.php komutuyla dosyayı manuel olarak silin. Bu, yetkisiz kişilerin sunucunuzda tekrar kurulum yapmasını engeller.

Codiad Kullanımı ve Temel Özellikleri

Codiad’ın kurulumunu tamamladıktan sonra, bu bölümde web tabanlı IDE’nizin temel özelliklerini ve nasıl kullanacağınızı keşfedeceğiz. Codiad, geliştirme süreçlerinizi kolaylaştırmak için tasarlanmış birçok kullanışlı araç sunar.

Proje Oluşturma ve Yönetimi

Codiad, projeler etrafında organize olur. Her proje, kendi dosya sistemi ve ayarlarıyla ayrı bir çalışma alanıdır.
* Yeni Proje Oluşturma: Sol üst köşedeki “Projects” menüsünden “New Project” seçeneğini seçerek yeni bir proje oluşturabilirsiniz. Proje adı, yolu (varsayılan /workspace/ dizini altındadır) ve isteğe bağlı olarak bir Git deposundan klonlama seçeneklerini belirleyebilirsiniz.
* Mevcut Projeyi Açma: Aynı menüden mevcut projeleriniz arasında geçiş yapabilirsiniz.
* Proje Ayarları: Her projenin kendine ait ayarları bulunur. Örneğin, proje adı, yolu, varsayılan dil, otomatik kaydetme aralığı gibi ayarları buradan düzenleyebilirsiniz.

Dosya Yöneticisi ve FTP/SFTP Entegrasyonu

Codiad’ın sol panelinde entegre bir dosya yöneticisi bulunur. Bu yönetici, sunucunuzdaki proje dosyaları ve dizinleri arasında gezinmenizi, yeni dosyalar/dizinler oluşturmanızı, dosyaları düzenlemenizi, silmenizi, kopyalamanızı veya taşımanızı sağlar.
* Dosya İşlemleri: Sağ tıklama menüsü ile dosya ve dizinler üzerinde birçok işlem yapabilirsiniz.
* Yükleme/İndirme: Codiad, yerel makinenizden sunucuya dosya yüklemenize veya sunucudan yerel makinenize dosya indirmenize olanak tanır. Bu, genellikle sürükle-bırak veya dosya yükleme arayüzü aracılığıyla yapılır.
* FTP/SFTP Erişimi: Codiad’ın kendisi doğrudan FTP/SFTP istemcisi olarak çalışmaz, ancak sunucunuzda FTP/SFTP sunucusu kuruluysa, Codiad içinden terminale erişerek veya sunucunuzun dosya sistemine doğrudan erişerek bu protokolleri kullanabilirsiniz. Codiad’ın bazı eklentileri (varsa) bu tür entegrasyonlar sağlayabilir.

Gelişmiş Kod Düzenleyici Özellikleri

Codiad’ın merkezi, güçlü bir kod düzenleyicidir. Bu düzenleyici, modern IDE’lerden beklenen birçok özelliği sunar:
* Syntax Highlighting (Sözdizimi Vurgulama): PHP, HTML, CSS, JavaScript, Python ve daha birçok dil için sözdizimi vurgulama desteği.
* Otomatik Tamamlama: Kod yazarken size öneriler sunarak hızınızı artırır.
* Çoklu İmleç (Multi-Cursor): Aynı anda birden fazla yerde düzenleme yapabilme özelliği.
* Kod Katlama (Code Folding): Kod bloklarını daraltarak daha temiz bir görünüm elde etme.
* Bul ve Değiştir: Proje genelinde veya açık dosya içinde gelişmiş arama ve değiştirme işlevleri.
* Sekmeler ve Bölünmüş Görünüm: Birden fazla dosyayı aynı anda açık tutabilir ve düzenleyiciyi dikey veya yatay olarak bölebilirsiniz.
* Temalar: Arayüz ve kod düzenleyici için farklı temalar seçerek kişiselleştirme yapabilirsiniz.

Terminal Entegrasyonu

Codiad, entegre bir terminal penceresi sunar. Bu, sunucunuza SSH ile bağlanmadan doğrudan web arayüzü üzerinden komutlar çalıştırmanıza olanak tanır.
* Komut Çalıştırma: npm install, composer update, git status gibi komutları doğrudan Codiad içinden çalıştırabilirsiniz.
* Sunucu Yönetimi: Temel sunucu yönetim görevlerini (örneğin, dosya izinlerini kontrol etme, servisleri yeniden başlatma) terminal üzerinden gerçekleştirebilirsiniz.
* Önemli Not: Terminal, web sunucusu kullanıcısı (www-data) yetkileriyle çalışır. sudo komutlarını kullanmak için sudo şifrenizi girmeniz gerekebilir. Ancak güvenlik için www-data kullanıcısına sudo yetkisi vermek yerine, sadece belirli komutlara izin veren daha kısıtlı bir sudoers yapılandırması tercih edilebilir.

Eklentiler ve Temalar

Codiad’ın işlevselliği eklentilerle genişletilebilir. Codiad topluluğu tarafından geliştirilen veya sizin kendi geliştireceğiniz eklentilerle, IDE’nize yeni özellikler ekleyebilirsiniz.
* Eklenti Yönetimi: “Plugins” menüsünden mevcut eklentileri etkinleştirebilir, devre dışı bırakabilir veya yeni eklentiler yükleyebilirsiniz.
* Tema Yönetimi: “Themes” menüsünden Codiad’ın görsel temasını değiştirebilirsiniz.

Versiyon Kontrolü (Git)

Codiad, Git ile temel entegrasyona sahiptir.
* Git İşlemleri: Projelerinizde git init, git add, git commit, git push, git pull gibi temel Git komutlarını doğrudan Codiad’ın terminalinden veya bazı eklentiler aracılığıyla arayüzden çalıştırabilirsiniz.
* Depo Klonlama: Yeni bir proje oluştururken doğrudan bir Git deposundan klonlama yapabilirsiniz.

Codiad, hafif yapısına rağmen oldukça yetenekli bir IDE’dir. Bu özellikler, web projeleri geliştirmek, dosyaları yönetmek ve sunucu üzerinde kod çalıştırmak için size güçlü bir platform sağlar.

Codiad İçin Güvenlik Önlemleri

Herhangi bir web uygulamasını bir sunucuya kurduğunuzda, güvenlik en önemli hususlardan biridir. Codiad da dahil olmak üzere, web tabanlı bir IDE’yi güvenli bir şekilde çalıştırmak için almanız gereken bazı önemli önlemler vardır.

HTTPS Kurulumu (Let’s Encrypt ile)

Codiad’a tarayıcınız üzerinden erişirken tüm iletişimin şifreli olmasını sağlamak için HTTPS kullanmak zorunludur. Bu, şifrelerinizin, kodlarınızın ve diğer hassas verilerinizin ağ üzerinde okunmasını engeller. Let’s Encrypt, ücretsiz SSL/TLS sertifikaları sağlayarak HTTPS’i kolayca etkinleştirmenize olanak tanır.

1. Certbot Kurulumu: Let’s Encrypt sertifikalarını yönetmek için Certbot aracını kurun:

sudo apt install -y certbot python3-certbot-apache

2. Sertifika Alma: Certbot’u çalıştırarak alan adınız için sertifika alın. ide.alanadiniz.com kısmını kendi Codiad alan adınızla değiştirin:

sudo certbot --apache -d ide.alanadiniz.com

Certbot size e-posta adresi soracak, hizmet koşullarını kabul etmenizi isteyecek ve sertifikayı otomatik olarak yapılandıracaktır. Genellikle HTTP trafiğini HTTPS’ye yönlendirme seçeneğini de sunar; bunu kabul etmeniz önerilir.
3. Otomatik Yenileme Kontrolü: Certbot, sertifikaları otomatik olarak yenilemek için bir cron job veya systemd zamanlayıcısı ayarlar. Yenilemenin çalıştığını test edebilirsiniz:

sudo certbot renew --dry-run

Eğer test başarılı olursa, sertifikalarınız otomatik olarak yenilenecektir. Artık Codiad’ınıza https://ide.alanadiniz.com adresinden güvenli bir şekilde erişebilirsiniz.

Yönetici Paneli Koruması

Codiad’ın yönetici paneli veya hassas dizinleri için ek bir koruma katmanı eklemek, yetkisiz erişimi daha da zorlaştırabilir. Apache ile .htaccess kullanarak parola koruması ekleyebilirsiniz.

1. Parola Dosyası Oluşturma: Apache’nin kimlik doğrulama için kullanacağı bir parola dosyası oluşturun.

sudo htpasswd -c /etc/apache2/.htpasswd codiadadmin

codiadadmin yerine istediğiniz bir kullanıcı adını kullanabilirsiniz. Bu komut sizden bir parola girmenizi isteyecektir.
2. Apache Yapılandırması: Codiad’ın kurulu olduğu dizine (veya sadece yönetici dizinine) parola koruması eklemek için sanal host dosyanızı düzenleyin:

sudo nano /etc/apache2/sites-available/codiad.conf

bloğunun içine aşağıdaki satırları ekleyin:

        # ... diğer ayarlar ...
        AuthType Basic
        AuthName "Codiad Admin Area"
        AuthUserFile /etc/apache2/.htpasswd
        Require valid-user
    

Dosyayı kaydedin ve Apache’yi yeniden başlatın:

sudo systemctl restart apache2

Artık Codiad’a her eriştiğinizde, tarayıcınız Apache’nin parola koruması için ek bir kullanıcı adı ve parola isteyecektir. Bu, Codiad’ın kendi giriş ekranından önce bir güvenlik katmanı daha ekler.

Doğru Dosya İzinleri

Daha önce de belirttiğimiz gibi, dosya izinleri kritik öneme sahiptir.
* Codiad dizinleri için 755 ve dosyaları için 644 izinleri standarttır.
* data, workspace, plugins, themes gibi Codiad’ın yazması gereken dizinler için 775 izni yeterli olmalıdır. 777 izni, herkesin yazma yetkisine sahip olması anlamına geldiği için genellikle güvenlik riski taşır ve mümkün olduğunca kaçınılmalıdır.
* sudo chown -R www-data:www-data /var/www/html/codiad komutu ile tüm Codiad dosyalarının sahipliğini web sunucusu kullanıcısına vermek önemlidir.

Güçlü Şifre Politikası

Codiad yönetici hesabınız ve varsa diğer kullanıcı hesaplarınız için güçlü, benzersiz şifreler kullanın. Şifrelerinizi düzenli olarak değiştirmeyi ve asla başka hizmetlerde kullandığınız şifreleri tekrar kullanmamayı unutmayın.

Codiad’ı Güncel Tutma

Codiad’ın en son sürümünü kullanmak, bilinen güvenlik açıklarının kapatılmasını sağlar. Yeni sürümler çıktığında, Codiad’ın kendi güncelleme mekanizmasını kullanarak veya GitHub’dan en son dosyaları indirip mevcut kurulumunuzun üzerine yazarak (önce yedek almayı unutmayın) güncelleyin.

Bu güvenlik önlemlerini uygulayarak, Codiad kurulumunuzu potansiyel tehditlere karşı daha dirençli hale getirebilirsiniz. Unutmayın, güvenlik sürekli bir süreçtir ve düzenli kontroller ile güncellemeler gerektirir.

Sık Karşılaşılan Sorunlar ve Çözümleri

Codiad kurulumu veya kullanımı sırasında karşılaşabileceğiniz bazı yaygın sorunlar ve bunların çözümleri aşağıda listelenmiştir.

Boş Beyaz Sayfa (White Screen of Death – WSOD)

Codiad’a erişmeye çalıştığınızda boş beyaz bir sayfa görüyorsanız, bu genellikle bir PHP hatasından kaynaklanır.

Çözüm:
1. PHP Hata Kayıtlarını Kontrol Edin: PHP hata kayıtları genellikle php.ini dosyasında belirtilen konumda bulunur (örneğin /var/log/apache2/error.log veya /var/log/nginx/error.log Apache/Nginx için). Bu kayıtları kontrol ederek hatanın kök nedenini bulabilirsiniz.

sudo tail -f /var/log/apache2/error.log

2. PHP Hata Görüntülemeyi Etkinleştirin (Geçici): Geliştirme ortamında, php.ini dosyasında display_errors = On ayarını yaparak hataların doğrudan tarayıcıda görüntülenmesini sağlayabilirsiniz. Ancak bu, üretim ortamında asla yapılmamalıdır.

sudo nano /etc/php/8.1/apache2/php.ini # PHP sürümünüze göre yolu ayarlayın

display_errors = Off satırını display_errors = On olarak değiştirin ve Apache’yi yeniden başlatın:

sudo systemctl restart apache2

Hatayı giderdikten sonra display_errors = Off yapmayı unutmayın.
3. Dosya İzinlerini Kontrol Edin: Yanlış dosya izinleri de WSOD’a neden olabilir. data veya workspace dizinlerinin web sunucusu kullanıcısı tarafından yazılabilir olduğundan emin olun (bkz. “Dosya İzinlerinin Ayarlanması” bölümü).

İzin Hataları

“Permission denied” veya “Unable to write to directory” gibi hatalar alıyorsanız, bu büyük olasılıkla dosya ve dizin izinlerinin yanlış ayarlandığını gösterir.

Çözüm:
1. Sahiplik ve İzinleri Kontrol Edin: Codiad dizininin sahipliğinin www-data kullanıcısına ve grubuna ait olduğundan emin olun:

sudo chown -R www-data:www-data /var/www/html/codiad

Ardından, gerekli dizinlere yazma izni verin:

sudo find /var/www/html/codiad -type d -exec chmod 755 {} \;
    sudo find /var/www/html/codiad -type f -exec chmod 644 {} \;
    sudo chmod -R 775 /var/www/html/codiad/data
    sudo chmod -R 775 /var/www/html/codiad/workspace
    sudo chmod -R 775 /var/www/html/codiad/plugins
    sudo chmod -R 775 /var/www/html/codiad/themes

2. SELinux/AppArmor: Eğer sunucunuzda SELinux veya AppArmor gibi ek güvenlik modülleri etkinse, bunlar da web sunucusunun belirli dizinlere erişimini kısıtlayabilir. Bu durumda, ilgili güvenlik modülünün günlüklerini kontrol etmeniz ve Codiad için gerekli kuralları eklemeniz gerekebilir. Genellikle Ubuntu’da AppArmor varsayılan olarak gelir. sudo aa-status komutuyla kontrol edebilirsiniz.

Performans Sorunları

Codiad yavaş çalışıyor veya yanıt vermekte gecikiyorsa, bunun birkaç nedeni olabilir.

Çözüm:
1. VPS Kaynakları: VPS’inizin CPU, RAM ve disk G/Ç (IO) kaynaklarını kontrol edin. Eğer sunucunuz yetersiz kaynaklara sahipse, Codiad yavaş çalışacaktır. htop veya top gibi araçlarla kaynak kullanımını izleyebilirsiniz.
2. PHP Optimizasyonu: PHP-FPM kullanıyorsanız (Nginx ile veya Apache’de mod_proxy_fcgi ile), php.ini veya php-fpm.conf ayarlarını optimize edebilirsiniz. Örneğin, opcache etkin olduğundan emin olun.

sudo phpenmod opcache
    sudo systemctl restart apache2 # veya php8.1-fpm

3. Ağ Bağlantısı: Kendi internet bağlantınızın veya VPS’inizin ağ bağlantısının kararlılığını kontrol edin. Uzak bir IDE olduğu için ağ gecikmeleri performansı etkileyebilir.
4. Codiad Eklentileri: Çok fazla eklenti etkinse, bunlar performansı düşürebilir. Gereksiz eklentileri devre dışı bırakmayı deneyin.

Codiad Güncelleme Sorunları

Codiad’ı güncellerken sorun yaşıyorsanız (örneğin, güncelleme tamamlanmıyor veya hatalar veriyor).

Çözüm:
1. Yedekleme: Her zaman güncellemeden önce Codiad kurulumunuzun (özellikle data ve workspace dizinleri) yedeğini alın.
2. Dosya İzinleri: Güncelleme sırasında Codiad’ın yeni dosyaları yazabilmesi için yine dosya izinlerinin doğru olduğundan emin olun.
3. Manuel Güncelleme: Eğer otomatik güncelleme başarısız olursa, GitHub’dan en son sürümü manuel olarak indirip mevcut dosyaların üzerine yazarak güncellemeyi deneyebilirsiniz. Ancak bu işlemi yaparken data ve workspace dizinlerinizi ezmediğinizden emin olun veya bunları yedekleyip sonra geri yükleyin.

Bu sorun giderme ipuçları, Codiad ile karşılaşabileceğiniz çoğu yaygın sorunu çözmenize yardımcı olacaktır. Eğer sorun devam ederse, Codiad’ın resmi GitHub deposundaki “Issues” bölümünü veya topluluk forumlarını kontrol etmek faydalı olabilir.

Sonuç

Bu kapsamlı rehberde, Codiad’ı bir Ubuntu VPS üzerine nasıl kuracağınızı ve yapılandıracağınızı adım adım ele aldık. Modern yazılım geliştirme süreçlerinde esneklik ve erişilebilirliğin önemini vurgulayarak başladık ve Codiad’ın neden bu ihtiyaçlara uygun bir çözüm olduğunu açıkladık.

Kurulum sürecine, sunucunuzun temel gereksinimlerini hazırlayarak başladık. Ubuntu VPS’inize SSH erişimi, alan adı yapılandırması ve Apache web sunucusu ile PHP’nin gerekli modüllerinin kurulumunu detaylandırdık. Ardından, Codiad dosyalarını sunucuya indirip doğru dizine yerleştirdik ve güvenlik için kritik olan dosya izinlerini ayarladık. Web arayüzü üzerinden ilk yapılandırmayı tamamlayarak bir yönetici hesabı oluşturduk ve Codiad’ın kullanıma hazır hale geldiğini doğruladık.

Codiad’ın temel kullanım özelliklerini, proje yönetiminden gelişmiş kod düzenleyici işlevlerine, dosya yöneticisinden entegre terminale ve Git versiyon kontrolüne kadar geniş bir yelpazede inceledik. Bu özelliklerin, geliştiricilere herhangi bir yerden, bir web tarayıcısı aracılığıyla tam teşekküllü bir geliştirme ortamı sunduğunu gördük.

Son olarak, web tabanlı bir IDE’nin güvenliğinin ne kadar önemli olduğunu vurgulayarak, HTTPS kurulumu (Let’s Encrypt ile), yönetici paneli koruması, doğru dosya izinleri ve güçlü şifre politikaları gibi kritik güvenlik önlemlerini detaylı bir şekilde açıkladık. Ayrıca, kurulum ve kullanım sırasında karşılaşabileceğiniz yaygın sorunlara yönelik çözümler sunarak, olası engelleri aşmanıza yardımcı olmayı amaçladık.

Artık kendi Ubuntu VPS’iniz üzerinde çalışan, güvenli ve erişilebilir bir Codiad ortamına sahipsiniz. Bu ortam, ister bireysel bir geliştirici olun ister küçük bir ekibin parçası, projelerinizi daha verimli bir şekilde yönetmenize ve geliştirmenize olanak tanıyacaktır. Codiad’ın sunduğu esneklik ve basitlik ile geliştirme süreçlerinizi optimize edebilir, projelerinizi doğrudan sunucunuzda barındırmanın ve yönetmenin avantajlarından faydalanabilirsiniz. Unutmayın, herhangi bir yazılımda olduğu gibi, Codiad’ınızı da güncel tutmak ve güvenlik uygulamalarını sürekli gözden geçirmek, sorunsuz ve güvenli bir deneyim için hayati öneme sahiptir. Başarılı geliştirmeler dileriz!