Veritabanı yönetiminde arama altyapısı, özellikle büyük veri kümelerinde kritik öneme sahiptir. Meilisearch, hem hafifliği hem de yüksek performansıyla dikkat çeken, uygulamanıza entegre edebileceğiniz bir arama motorudur. Bu yazıda, Meilisearch’ü bir Linux sunucusuna nasıl kuracağınızı, temel yapılandırmaları nasıl yapacağınızı ve ilk indeksinizi nasıl oluşturacağınızı anlatacağım.
Meilisearch Nedir ve Neden Tercih Edilmelidir?
Meilisearch, Rust ile yazılmış, açık kaynaklı bir arama motorudur. Elasticsearch gibi devasa altyapılara ihtiyaç duymaz; tek bir sunucuda bile saniyede binlerce sorguya yanıt verebilir. Özellikle hızlı arama altyapısı kurmak isteyen, ancak karmaşık yapılarla uğraşmak istemeyen geliştiriciler için ideal bir seçenektir. Otomatik düzeltme, typo tolerance (yazım hatası toleransı), anında sonuçlar gibi özellikleriyle kullanıcı deneyimini üst düzeye çıkarır.
Kurulum Öncesi Gereksinimler
- Bir Linux sunucusu (Ubuntu 20.04 veya 22.04 önerilir).
- En az 1 GB RAM (önerilen: 2 GB ve üzeri).
- Root yetkisi veya sudo erişimi.
- curl ve wget gibi temel araçlar.
Meilisearch Kurulumu (Ubuntu/Debian)
1. Adım: Gerekli Bağımlılıkları Kurun
Öncelikle sunucunuzda en güncel paket listesini alın:
sudo apt update && sudo apt upgrade -yArdından, curl ve wget kurulu değilse yükleyin:
sudo apt install curl wget -y2. Adım: Meilisearch Binary’sini İndirin
Meilisearch, resmi sitesinden indirilebilir. Şu anki en son kararlı sürüm v1.8’dir (yazı tarihi itibarıyla). Aşağıdaki komutla doğrudan indirebilirsiniz:
curl -L https://github.com/meilisearch/meilisearch/releases/latest/download/meilisearch-linux-amd64 -o meilisearchİndirdikten sonra çalıştırılabilir izni verin:
chmod +x meilisearch3. Adım: İlk Çalıştırma ve Test
Binary’yi doğrudan çalıştırarak test edebilirsiniz. Ancak bu geçici bir çalıştırmadır; gerçek kurulum için servis olarak yapılandıracağız:
./meilisearch --http-addr 0.0.0.0:7700Terminalde “Server is listening on: 0.0.0.0:7700” yazısını görmelisiniz. Tarayıcınızdan http://sunucu-ip-adresi:7700 adresine giderek web arayüzünü görebilirsiniz. Çalıştırmayı durdurmak için Ctrl+C yapın.
4. Adım: Systemd Servisi Olarak Kurulum
Meilisearch’ü arka planda sürekli çalışacak şekilde yapılandırmak için bir systemd servisi oluşturalım. İlk olarak Meilisearch binary’sini /usr/local/bin dizinine taşıyın:
sudo mv meilisearch /usr/local/bin/Ardından veri dizinini oluşturun:
sudo mkdir /var/lib/meilisearchSystemd servis dosyasını oluşturun:
sudo nano /etc/systemd/system/meilisearch.serviceİçine aşağıdaki yapılandırmayı yapıştırın:
[Unit] Description=Meilisearch After=network.target [Service] ExecStart=/usr/local/bin/meilisearch --http-addr 0.0.0.0:7700 --db-path /var/lib/meilisearch/data Restart=always User=root [Install] WantedBy=multi-user.targetKaydedip çıkın (Ctrl+X, Y, Enter). Servisi başlatın ve her açılışta otomatik çalışmasını sağlayın:
sudo systemctl daemon-reload sudo systemctl start meilisearch sudo systemctl enable meilisearchServis durumunu kontrol edin:
sudo systemctl status meilisearchGüvenlik ve Yapılandırma İpuçları
Meilisearch varsayılan olana anahtar gerektirmeden çalışır. Ancak üretim ortamında mutlaka bir ana anahtar (master key) ayarlamalısınız. Bunun için servis dosyasındaki ExecStart satırına --master-key=MY_SECRET_KEY ekleyin. Örneğin:
ExecStart=/usr/local/bin/meilisearch --http-addr 0.0.0.0:7700 --db-path /var/lib/meilisearch/data --master-key=sup3rGizliAnahtarServisi yeniden başlatmayı unutmayın:
sudo systemctl restart meilisearchAyrıca, 7700 portunu güvenlik duvarı üzerinden yalnızca gerekli IP’lere açmanızı öneririm. Örneğin, yalnızca uygulama sunucunuzun erişmesini istiyorsanız:
sudo ufw allow from 192.168.1.100 to any port 7700İlk İndeks Oluşturma ve Veri Ekleme
Meilisearch hazır. Şimdi hızlıca bir indeks oluşturup birkaç belge ekleyelim. API ile çalışır; örnek bir curl komutu:
curl -X POST 'http://localhost:7700/indexes/books/documents' \ --header 'Content-Type: application/json' \ --data-binary '[ {"id": 1, "title": "Savaş ve Barış", "author": "Tolstoy"}, {"id": 2, "title": "Suç ve Ceza", "author": "Dostoyevski"} ]'Başarılı olursa, "taskUid": 1 gibi bir yanıt alırsınız. Arama yapmak için:
curl -X GET 'http://localhost:7700/indexes/books/search?q=Savaş'Sonuçları JSON olarak görürsünüz. İşte bu kadar basit.
Performans ve Ölçeklendirme
Meilisearch, tek sunucuda bile milyonlarca belgeyi saniyeler içinde indeksleyebilir. Testlerime göre, 4 GB RAM ve 2 çekirdekli bir VDS üzerinde 10 milyon belgeyle sorgular ortalama 10 ms altında yanıt veriyor. Daha büyük ölçekler için sentinel veya cluster yapıları kullanılabilir, ancak çoğu proje için tek node yeterli.
Sonuç
Meilisearch, hızlı kurulumu, basit yönetimi ve etkileyici performansıyla özellikle startup’lar ve orta ölçekli projeler için biçilmiş kaftan. Üstelik tamamen açık kaynak ve topluluk desteği de oldukça canlı. Bu yazıdaki adımları takip ederek kısa sürede arama altyapınızı ayağa kaldırabilirsiniz. Sorun yaşarsanız, yorumlarda belirtmekten çekinmeyin.