FileBrowser Nedir ve Web Tabanlı Dosya Yönetimi

Sunucunuzdaki bir dosyaya hızlıca bakmak, birkaç dosya yüklemek ya da uzaktaki bir klasörü müşterinizle paylaşmak istediğinizde her seferinde SSH açıp scp komutlarıyla uğraşmak yorucu olabilir. Özellikle terminale çok yatkın olmayan ekip arkadaşlarınız için bu iş neredeyse imkânsız hale gelir. İşte tam bu boşluğu dolduran araçlardan biri FileBrowser. Sunucunuzdaki herhangi bir dizini alıp onu şık, kullanışlı bir web arayüzüne dönüştürür; siz de dosyalarınızı tıpkı masaüstündeki bir dosya yöneticisi gibi tarayıcıdan gezip yönetirsiniz.

Bu rehberde FileBrowser'ın ne olduğunu, neden bu kadar sevilen bir araç haline geldiğini, tek binary yapısının ne anlama geldiğini ve onu sunucunuza nasıl kuracağınızı adım adım göreceğiz. Kullanıcı ve izin ayarlarından paylaşım bağlantılarına, Docker ile çalıştırmaktan ters proxy arkasında güvenli yayınlamaya kadar pratik örneklerle ilerleyeceğiz. Amacımız, yazıyı bitirdiğinizde kendi FileBrowser kurulumunuzu rahatça ayağa kaldırabilecek düzeyde donanmış olmanız.

FileBrowser nedir?#

FileBrowser, Go diliyle yazılmış açık kaynaklı bir web tabanlı dosya yöneticisidir. Görevi son derece nettir: kendisine gösterdiğiniz bir dizini (kök dizin) alır ve o dizinin içeriğini tarayıcıdan erişilebilen bir arayüzle sunar. Bu arayüzden dosya yükleyebilir, indirebilir, taşıyabilir, kopyalayabilir, yeniden adlandırabilir, silebilir, klasör oluşturabilir; hatta metin ve kod dosyalarını doğrudan tarayıcıda açıp düzenleyebilirsiniz.

Aracın en belirgin özelliği tek binary olmasıdır. Yani karmaşık bir kurulum sihirbazı, veritabanı sunucusu ya da bir yığın bağımlılık gerektirmez. Sunucunuza tek bir çalıştırılabilir dosya indirir, onu çalıştırırsınız ve işiniz biter. Tüm ayarlar, kullanıcılar ve yetkiler tek bir gömülü veritabanı dosyasında (varsayılan olarak filebrowser.db) saklanır. Bu sadelik, FileBrowser'ı hem çok hafif hem de taşınabilir kılar; küçük bir VPS'ten kişisel bir ev sunucusuna kadar her yerde rahatça çalışır.

FileBrowser'ı bir "bulut depolama platformu" ile karıştırmamak gerekir. Nextcloud gibi araçlar takvim, kişiler, çevrimiçi ofis ve senkronizasyon istemcileri sunarak kapsamlı bir ekosistem oluşturur. FileBrowser ise bilinçli olarak tek bir işe odaklanır: dosyaları web üzerinden yönetmek. Bu odak, onu öğrenmesi ve yönetmesi kolay bir çözüm yapar. Depolama alanınızı bir "Drive" alternatifine dönüştürmek istiyorsanız Nextcloud rehberimize göz atabilirsiniz; ama tek amacınız dosyalara pratik bir web erişimiyse FileBrowser çoğu zaman fazlasıyla yeterlidir.

Ne işe yarar, kimler için uygundur?#

FileBrowser'ın parladığı senaryolar genellikle "hafif ve pratik" ihtiyaçlardır. Birkaç tipik kullanım örneği şöyle sıralanabilir:

• Sunucu dosyalarına hızlı erişim: SSH açmadan log dosyalarına bakmak, bir yapılandırma dosyasını hızlıca düzenlemek ya da bir yedek dosyasını indirmek için idealdir.
• Müşteriye veya ekibe dosya teslimi: Büyük tasarım, video ya da arşiv dosyalarını e-posta eki limitine takılmadan, tarayıcıdan indirilebilir bağlantılarla paylaşabilirsiniz.
• Basit yükleme portalı: Teknik olmayan kişilerin sunucuya dosya bırakması gereken durumlarda, onlara sadece bir kullanıcı adı ve parola verip belirli bir klasöre yükleme yetkisi tanıyabilirsiniz.
• Ortak medya kütüphanesi: Bir Jellyfin veya Plex sunucusunun medya klasörünü FileBrowser ile yönetip yeni içerikleri tarayıcıdan yükleyebilirsiniz.
• Geliştirici ortamları: Bir projenin dist çıktısını ya da statik dosyalarını hızlıca gözden geçirmek için pratik bir pencere sağlar.

Kısacası, "sunucudaki dosyalara terminalsiz, düzenli bir web erişimi" isteyen herkes FileBrowser'ın hedef kitlesindedir. Bir VDS sunucu ya da sanal sunucu kiralayıp üzerinde birkaç servis çalıştırıyorsanız, FileBrowser bu servislerin dosya tarafını yönetmek için çok düşük maliyetli bir katman ekler.

FileBrowser ile alternatiflerin karşılaştırması#

Web tabanlı dosya yönetimi için birden fazla araç var. Doğru seçimi yapabilmeniz için FileBrowser'ı popüler alternatifleriyle karşılaştıralım:

Bu tablodan çıkan sonuç şu: eğer amacınız kapsamlı bir iş birliği platformuysa Nextcloud daha uygundur. Ama tek ihtiyacınız hafif, hızlı ve az kaynak tüketen bir web dosya yöneticisiyse FileBrowser rakipsiz denecek kadar pratiktir. cPanel kullanıcıları için ise dahili dosya yöneticisi genellikle yeterlidir; ancak panel dışında, örneğin bir VDS sunucu üzerinde çalışan bağımsız bir servis için FileBrowser çok daha esnektir.

Kurulum — tek binary ile#

FileBrowser'ın en sevilen yönü, kurulumunun gerçekten dakikalar sürmesidir. Linux tabanlı bir sunucuda en hızlı yol, projenin resmi kurulum betiğini kullanmaktır:

curl -fsSL https://raw.githubusercontent.com/filebrowser/filebrowser/master/get.sh | bash

Bu betik, işletim sisteminize uygun binary'yi indirir ve /usr/local/bin/filebrowser konumuna yerleştirir. Betikleri boru hattıyla çalıştırmaktan çekiniyorsanız — ki güvenlik açısından tamamen haklısınız — binary'yi projenin sürüm sayfasından elle indirip yerleştirebilirsiniz:

cd /tmp
wget https://github.com/filebrowser/filebrowser/releases/latest/download/linux-amd64-filebrowser.tar.gz
tar -xzf linux-amd64-filebrowser.tar.gz
sudo mv filebrowser /usr/local/bin/
sudo chmod +x /usr/local/bin/filebrowser

Kurulumun ardından sürümü doğrulayarak her şeyin yolunda olduğunu görebilirsiniz:

filebrowser version

Şimdi paylaşmak istediğiniz dizini belirleyip FileBrowser'ı başlatabilirsiniz. Diyelim ki /srv/dosyalar klasörünü yayınlamak istiyorsunuz:

filebrowser -r /srv/dosyalar -a 0.0.0.0 -p 8080

Buradaki -r kök dizini, -a dinlenecek adresi (tüm arayüzler için 0.0.0.0), -p ise portu belirtir. İlk çalıştırmada FileBrowser otomatik olarak admin kullanıcı adı ve admin parolası ile bir yönetici hesabı oluşturur. Tarayıcınızda http://sunucu-ip:8080 adresine gittiğinizde giriş ekranıyla karşılaşırsınız. İlk işiniz bu varsayılan parolayı değiştirmek olmalı — aksi halde sunucunuz açık bir kapı gibi durur.

Servis olarak kalıcı çalıştırma (systemd)#

Yukarıdaki komut, terminali kapattığınızda ya da sunucu yeniden başladığında FileBrowser'ı durdurur. Üretim ortamında aracı sürekli ayakta tutmak için bir systemd servisi tanımlamak en doğru yöntemdir. Önce yapılandırma için bir veritabanı yolu belirleyelim ve servis dosyasını oluşturalım:

[Unit]
Description=FileBrowser Web Dosya Yoneticisi
After=network.target

[Service]
User=www-data
Group=www-data
ExecStart=/usr/local/bin/filebrowser -c /etc/filebrowser/config.json
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target

Bu dosyayı /etc/systemd/system/filebrowser.service olarak kaydedin. Ardından /etc/filebrowser/config.json içinde temel ayarları tanımlayabilirsiniz:

{
  "port": 8080,
  "address": "127.0.0.1",
  "root": "/srv/dosyalar",
  "database": "/etc/filebrowser/filebrowser.db",
  "log": "stdout"
}

Dikkat ederseniz address değerini 127.0.0.1 yaptık; yani FileBrowser artık doğrudan dış dünyaya değil, yalnızca yerel makineye açık. Bunun nedeni, birazdan anlatacağımız gibi aracı bir ters proxy arkasına koyup HTTPS ile yayınlayacak olmamız. Servisi etkinleştirip başlatmak için:

sudo systemctl daemon-reload
sudo systemctl enable --now filebrowser
sudo systemctl status filebrowser

Artık FileBrowser sunucunuzun ayrılmaz bir parçası; her yeniden başlatmada otomatik olarak ayağa kalkar ve bir hata durumunda kendini yeniden başlatır.

Kullanıcı ve izin yönetimi#

FileBrowser'ın gücü, dosya erişimini kişi bazında sınırlayabilmesinde yatar. Her kullanıcının kendi kök dizini, kendi yetkileri ve kendi arayüz tercihleri olabilir. Kullanıcıları hem web arayüzünden hem de komut satırından yönetebilirsiniz. Örneğin komut satırından yeni bir kullanıcı eklemek isterseniz:

filebrowser users add musteri1 GucluBirParola123 \
  --database /etc/filebrowser/filebrowser.db \
  --scope /srv/dosyalar/musteri1 \
  --perm.admin=false

Buradaki en kritik parametre --scope. Bu ayar, kullanıcının yalnızca belirtilen klasörü görebileceği anlamına gelir; musteri1 kullanıcısı /srv/dosyalar/musteri1 dışına asla çıkamaz. Böylece aynı sunucuda birden fazla müşteriye, birbirinden tamamen izole klasörler tahsis edebilirsiniz.

İzinler oldukça ayrıntılı olarak ayarlanabilir. Web arayüzünde yönetici olarak "Kullanıcılar" bölümüne girdiğinizde her kullanıcı için şu yetkileri tek tek açıp kapatabilirsiniz:

Bu granülerlik sayesinde, örneğin bir müşteriye "sadece indir" yetkisi verip yükleme ve silmeyi kapatabilir; ya da bir içerik editörüne yükleme ve düzenleme izni verip silme yetkisini elinde tutabilirsiniz. Yeni kaydolan kullanıcıların hangi varsayılan yetkilerle geleceğini de global ayarlardan tek noktadan belirleyebilirsiniz.

Paylaşım bağlantıları oluşturma#

FileBrowser'ın en çok işe yarayan özelliklerinden biri paylaşım bağlantılarıdır. Bir dosyayı ya da klasörü, hesabınıza girmeyen kişilerle bile paylaşabilmenizi sağlar. Arayüzde herhangi bir dosyaya sağ tıklayıp (ya da seçip) "Paylaş" seçeneğini kullandığınızda, size benzersiz bir bağlantı üretilir.

Bu bağlantıları güvenli kılmak için iki önemli seçenek sunulur. Birincisi parola koruması: bağlantıyı açan kişiden, sizin belirlediğiniz bir parolayı girmesi istenir. İkincisi ise son kullanma süresi: bağlantının yalnızca belirli bir süre (örneğin 3 gün) geçerli olmasını sağlayabilirsiniz. Bu ikisini birlikte kullanmak, hassas dosyaları paylaşırken hayat kurtarır — bağlantı bir yerde sızsa bile süresi dolduğunda işe yaramaz hale gelir.

Paylaştığınız bir klasörse, karşı taraf içindeki dosyaları tarayıcıdan gezip tek tek ya da toplu olarak indirebilir. Bu, e-posta eki sınırlarına takılmadan ya da harici bir dosya paylaşım servisine güvenmeden büyük dosyaları teslim etmenin temiz bir yoludur. Serbest çalışan bir tasarımcı, ajans ya da yazılım ekibi için müşteriye "işte teslim dosyanız" derken bu özellik son derece pratiktir. Paylaşım bağlantısının halka açık bir kapı olduğunu unutmayın; bu yüzden özellikle hassas içerikler için mutlaka parola ve süre sınırı kullanın.

Docker ile çalıştırma#

Sunucunuzda zaten bir konteyner altyapısı kullanıyorsanız FileBrowser'ı Docker ile çalıştırmak, kurulumu daha da temiz hale getirir. Konteyner mantığına yeniyseniz önce Docker başlangıç rehberimizi okumanızı öneririm; ama temel bir docker compose dosyası şöyle görünür:

services:
  filebrowser:
    image: filebrowser/filebrowser:latest
    container_name: filebrowser
    restart: unless-stopped
    ports:
      - "8080:80"
    volumes:
      - /srv/dosyalar:/srv
      - ./config/filebrowser.db:/database/filebrowser.db
      - ./config/settings.json:/config/settings.json
    environment:
      - PUID=1000
      - PGID=1000

Burada dikkat edilmesi gereken birkaç nokta var. volumes altında /srv/dosyalar klasörünü konteynerin /srv yoluna bağlıyoruz; FileBrowser bu dizini kök olarak kullanacak. Veritabanı ve ayar dosyasını da konteyner dışında tutuyoruz ki konteyneri güncelleyip yeniden oluştursanız bile kullanıcılarınız ve ayarlarınız kaybolmasın. Konteyneri ilk kez ayağa kaldırmadan önce boş bir veritabanı dosyası oluşturmak iyi bir alışkanlıktır:

mkdir -p config
touch config/filebrowser.db
docker compose up -d

Konteyner çalışmaya başladıktan sonra logları izleyerek ilk yönetici parolasını görebilirsiniz:

docker compose logs -f filebrowser

Docker yaklaşımının en büyük avantajı, güncellemelerin sadece imaj etiketini değiştirip docker compose pull && docker compose up -d demek kadar kolay olmasıdır. Ayrıca aracı sistemin geri kalanından izole ettiği için, olası bir güvenlik açığının etkisini konteyner sınırları içinde tutar.

Ters proxy ve HTTPS ile güvenli yayınlama#

FileBrowser'ı doğrudan 0.0.0.0:8080 üzerinden internete açmak, üretim ortamı için önerilmez. Trafik şifresiz akar ve araç, TLS sertifikası yönetimi gibi işler için tasarlanmamıştır. Doğru yaklaşım, önüne Nginx gibi bir ters proxy koyup HTTPS'i orada sonlandırmaktır. Böylece FileBrowser yalnızca 127.0.0.1 üzerinde dinlerken, dış dünyaya güvenli bir alan adıyla çıkarsınız:

server {
    listen 443 ssl http2;
    server_name dosya.ornekalanadi.com;

    ssl_certificate     /etc/letsencrypt/live/dosya.ornekalanadi.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/dosya.ornekalanadi.com/privkey.pem;

    # Buyuk dosya yuklemelerine izin ver
    client_max_body_size 0;

    location / {
        proxy_pass http://127.0.0.1:8080;
        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;
    }
}

Bu yapılandırmadaki client_max_body_size 0; satırı özellikle önemlidir; Nginx varsayılan olarak yükleme boyutunu sınırlar ve bu satır olmadan büyük dosyalar "413 Request Entity Too Large" hatasıyla reddedilir. Değeri 0 yapmak sınırı kaldırır, dilerseniz 2G gibi somut bir üst sınır da verebilirsiniz. Sertifikayı ücretsiz Let's Encrypt ile alabilir ya da bir SSL sertifikası tedarik edebilirsiniz. Alan adınızın dosya.ornekalanadi.com gibi bir alt adını FileBrowser'a yönlendirmek için basit bir DNS A kaydı yeterlidir:

dosya    IN    A    203.0.113.45

Bir alan adına henüz sahip değilseniz domain kayıt sayfamızdan hızlıca alabilirsiniz. Ek bir güvenlik katmanı için önüne bir WAF veya DDoS koruma hizmeti koymak, dosya yöneticinizi hedef alan otomatik saldırıları büyük ölçüde eler.

Güvenlik ve iyi uygulamalar#

FileBrowser sunucunuzun dosya sistemine doğrudan bir pencere açtığı için, güvenliğini ciddiye almak şarttır. Yıllar içinde çok sayıda sunucu yönetiminde edindiğim tecrübeyle, aşağıdaki önlemleri asgari standart olarak kabul ediyorum:

• Varsayılan parolayı hemen değiştirin. İlk kurulumdaki admin/admin bilgisi internetteki botların ilk denediği kombinasyondur. Kuruluma başladığınız ilk beş dakikada bunu güçlü, benzersiz bir parolayla değiştirin.
• Kök dizini olabildiğince dar tutun. FileBrowser'a / gibi tüm sistemi göstermeyin; yalnızca gerçekten paylaşılması gereken klasörü (/srv/dosyalar gibi) kök olarak verin. Böyle bir "hapsetme", olası bir açıkta hasarı sınırlar.
• Her kullanıcıya ayrı scope tanımlayın. Çok kullanıcılı senaryolarda herkesin kendi klasörüyle sınırlı kalması, hem gizliliği hem de düzeni korur.
• HTTPS olmadan yayınlamayın. Ters proxy ve TLS, parolaların ve dosya içeriğinin ağda açıkça dolaşmasını engeller.
• Sınırlı yetkili bir işletim sistemi kullanıcısıyla çalıştırın. Servisi root yerine www-data gibi ayrıcalıksız bir hesapla başlatmak, olası bir ele geçirmede sistemin tamamının riske girmesini önler.
• Erişimi kısıtlamayı düşünün. Panele yalnızca belirli IP'lerden ya da bir VPN üzerinden erişime izin vermek, saldırı yüzeyini ciddi biçimde daraltır.
• Düzenli yedek alın. Yalnızca dosyalarınızın değil, filebrowser.db veritabanının da yedeğini alın; kullanıcı ve ayar bilgileriniz orada durur. Otomatik bir yedekleme çözümü bu işi sizin için sürekli yapar.

Bu önlemleri birlikte uyguladığınızda FileBrowser, sunucunuza açtığınız zafiyetli bir kapı değil, kontrollü ve güvenli bir dosya penceresi olur. Kurulumu ve güvenliğiyle tek başınıza uğraşmak istemiyorsanız sunucu yönetimi hizmetimiz devreye girip bu katmanları sizin için yapılandırabilir.

Sıkça Sorulan Sorular#

FileBrowser ücretsiz mi?#

Evet, FileBrowser tamamen ücretsiz ve açık kaynaklıdır. Apache 2.0 lisansıyla dağıtılır; ne kullanıcı başına ne de depolama başına herhangi bir ücret ödersiniz. Tek maliyetiniz, aracı çalıştıracağınız sunucunun kendisidir. Kaynak kodu herkese açık olduğu için isterseniz inceleyebilir, katkıda bulunabilir ya da kendi ihtiyaçlarınıza göre uyarlayabilirsiniz.

FileBrowser ile Nextcloud arasındaki fark nedir?#

İkisi farklı ihtiyaçlara hitap eder. FileBrowser hafif ve tek işe odaklı bir dosya yöneticisidir; sunucudaki bir klasörü web arayüzüne çevirir, o kadar. Nextcloud ise takvim, kişiler, çevrimiçi ofis, masaüstü ve mobil senkron istemcileri gibi geniş bir ekosistem sunan kapsamlı bir bulut platformudur. Sadece dosyalara pratik web erişimi istiyorsanız FileBrowser yeterlidir; kapsamlı bir Drive alternatifi arıyorsanız Nextcloud daha uygun olur.

FileBrowser dosyaları kendi deposunda mı tutuyor?#

Hayır, FileBrowser dosyaları kendi ayrı bir alanında saklamaz. Doğrudan sunucunuzun dosya sistemindeki gerçek klasörlerle çalışır. Yani ona kök olarak gösterdiğiniz dizinde ne varsa arayüzde onu görürsünüz; bir dosyayı FileBrowser'dan sildiğinizde diskteki gerçek dosya da silinir. Bu şeffaflık, aracı başka servislerle (örneğin bir web sunucusunun dosyalarıyla) birlikte kullanmayı çok kolaylaştırır.

Windows sunucuda çalışır mı?#

Evet, çalışır. FileBrowser Go ile yazıldığı için Linux, Windows ve macOS için ayrı binary dosyaları sunulur. Windows sürümünü indirip bir hizmet olarak yapılandırabilir ya da doğrudan çalıştırabilirsiniz. Bununla birlikte üretim ortamlarında çoğu kullanıcı, kaynak verimliliği ve ters proxy entegrasyonunun rahatlığı nedeniyle aracı Linux tabanlı bir sunucuda çalıştırmayı tercih eder.

Aynı anda kaç kişi kullanabilir?#

FileBrowser çoklu kullanıcıyı doğal olarak destekler ve pratikte küçük-orta ölçekli ekipler için sınır oluşturmaz. Kaynak tüketimi çok düşük olduğundan mütevazı bir sunucu bile onlarca eşzamanlı kullanıcıyı rahatça taşır. Asıl belirleyici faktör kullanıcı sayısından çok, eşzamanlı yükleme ve indirmelerin oluşturduğu disk ve ağ trafiğidir. Yoğun kullanımda sunucunuzun ağ bant genişliğine ve disk hızına dikkat etmeniz yeterlidir.

Yükleme boyutu sınırı var mı?#

FileBrowser'ın kendisinde katı bir yükleme sınırı yoktur; asıl sınır genellikle önündeki ters proxy'den gelir. Nginx kullanıyorsanız client_max_body_size yönergesi varsayılan olarak yüklemeleri sınırlar; bu değeri büyütmeniz ya da 0 yaparak kaldırmanız gerekir. Bunun dışında sunucunuzun disk kapasitesi ve zaman aşımı ayarları da çok büyük dosyalarda belirleyici olabilir, bu yüzden büyük yüklemeler bekliyorsanız proxy zaman aşımı sürelerini de gözden geçirin.

Kapanış#

FileBrowser, "az yer kapla, tek işi kusursuz yap" felsefesinin güzel bir örneği. Tek binary yapısı sayesinde dakikalar içinde kurulur, gömülü veritabanıyla karmaşık bağımlılıklardan kaçınır ve sunucunuzdaki herhangi bir dizini pratik, güvenli bir web dosya yöneticisine dönüştürür. Kullanıcı bazlı izinler, kapsam sınırlaması ve süreli-parolalı paylaşım bağlantılarıyla hem kişisel kullanımda hem de müşteri ve ekip senaryolarında rahatça iş görür. Docker ile çalıştırıp bir ters proxy arkasında HTTPS ile yayınladığınızda ise üretim ortamına hazır, temiz bir çözüm elde edersiniz.

Böyle bir aracı çalıştırmak için sağlam bir zemine ihtiyacınız var. FileBrowser'ı ve yanındaki diğer self-hosted uygulamalarınızı barındırmak için Clou.TR'nin yüksek performanslı VDS sunucularına, esnek sanal sunucularına ya da tek tıkla kurulumlar sunan App Center altyapısına göz atabilirsiniz. Kuruluma başlamadan önce bir alan adı almak isterseniz domain sayfamız, güvenli yayın için ise SSL sertifikası çözümlerimiz hazır. Sunucunuzun bakımını ve güvenliğini bize bırakmak isterseniz sunucu yönetimi ekibimiz de her adımda yanınızda olur.