İçeriğe geç
Oleaflyv0.4.12

Sunucu çalıştırma

Depolama, yedekler ve limitler

Tüm Oleafly Server ayarları, dosyaları diskte veya S3 kovasında depolama, derlenmiş PDF'ler, vekil sunucu arkasında çalıştırma, tek bir ağdaki sınıflar ve her hesap için limitler, günlükler, yedekler, geri yükleme ve güncellemeler.

Bu sayfa Oleafly Server’ı gündelik olarak çalıştırmayı ele alır. Kurmak için İş birliği sunucusu çalıştırma ile başlayın.

Sunucu ayarlarını ortam değişkenlerinden okur. Ayarlanmış ama boş olan bir değişken, ayarlanmamış sayılır. Bir ayar eksik veya bozuksa sunucu başlamaz ve günlüğü hangisi olduğunu söyler.

DeğişkenNe yaparVarsayılan
OLEAFLY_PUBLIC_URLKişilerin Oleafly’de girdiği HTTPS adresi. https://www.cs.example.edu/oleafly gibi bir yol içerebilir. Zorunlu. Compose ve Coolify dosyaları bunu sizin için ayarlar.Yok
OLEAFLY_BINDSunucunun dinlediği adres ve port.0.0.0.0:8080
OLEAFLY_DATA_DIRVeritabanının ve depolanan dosyaların bulunduğu klasör./data
OLEAFLY_SERVER_NAMEKişilerin Oleafly’de gördüğü ad, örneğin Smith Lab.Oleafly Server
OLEAFLY_SERVER_ICON_URLAdın yanında gösterilen kare bir görselin HTTPS adresi.Yok
OLEAFLY_SETUP_CODEKendi tek kullanımlık kurulum kodunuz: en az 12 harf veya rakam; isterseniz tire veya boşlukla. Sağlanmazsa sunucu bir tane üretir.Üretilir
OLEAFLY_GITHUB_CLIENT_ID, OLEAFLY_GITHUB_CLIENT_SECRETGitHub ile oturum açmayı açar.Kapalı
OLEAFLY_GITHUB_URLBir GitHub Enterprise Server’ın adresi.https://github.com
OLEAFLY_GITHUB_API_URLGitHub API adresi, sizinki alışılmadıksa.https://api.github.com ya da OLEAFLY_GITHUB_URL altında /api/v3
OLEAFLY_GITHUB_LABELGitHub oturum açma düğmesindeki metin.GitHub
OLEAFLY_OIDC_<NAME>_ISSUER, OLEAFLY_OIDC_<NAME>_CLIENT_ID, OLEAFLY_OIDC_<NAME>_CLIENT_SECRET<NAME> adlı bir OpenID Connect sağlayıcısını açar.Kapalı
OLEAFLY_OIDC_<NAME>_LABELOturum açma düğmesindeki metin, örneğin University login.<NAME>
OLEAFLY_OIDC_<NAME>_TRUST_EMAILBu sağlayıcıdan gelen her e-posta adresini doğrulanmış sayar. Önce Doğrulanmış e-posta adresleri bölümünü okuyun.false
OLEAFLY_SMTP_URL, OLEAFLY_MAIL_FROME-posta. E-posta bölümünü okuyun.Kapalı
OLEAFLY_OPEN_SIGNUPSağlayıcılarınızdan biriyle oturum açan herkese üye olarak bir hesap verir. Açık kayıt bölümünü okuyun.false
OLEAFLY_WEBTarayıcı erişimini açar. Tarayıcı erişimi bölümünü okuyun.false
OLEAFLY_BLOB_STOREŞekiller ve PDF’ler gibi dosyaların nerede saklandığı. fs bunları OLEAFLY_DATA_DIR içinde tutar. s3://lab-bucket veya s3://lab-bucket/oleafly gibi bir adres, bunları bir kovada tutar.fs
OLEAFLY_S3_ENDPOINTAmazon S3 dışında bir S3 uyumlu deponun adresi, örneğin MinIO veya Cloudflare R2. Amazon S3 için boş bırakın.Amazon S3
OLEAFLY_S3_REGIONKovanın bölgesi.us-east-1
OLEAFLY_S3_ACCESS_KEY_ID, OLEAFLY_S3_SECRET_ACCESS_KEYSunucunun kova için kullandığı anahtar. s3:// adresiyle zorunludur.Yok
OLEAFLY_MAX_PROJECT_MBSunucunun kabul ettiği en büyük proje, megabayt cinsinden.200
OLEAFLY_MAX_FILE_MBEn büyük tek dosya, megabayt cinsinden.50
OLEAFLY_MAX_MEMBERS_PER_PROJECTBir projedeki en fazla kişi sayısı.20
OLEAFLY_ACCOUNT_STORAGE_MBBir hesabın sahip olduğu projelerin en fazla ne kadar yer kaplayabileceği, megabayt cinsinden. Hesap başına limitler bölümünü okuyun.Limit yok; açık kayıtla 100
OLEAFLY_MAX_PROJECTS_PER_ACCOUNTBir hesabın sahip olabileceği en fazla paylaşılan proje sayısı.Limit yok; açık kayıtla 50
OLEAFLY_UPLOADS_PER_HOURBir hesabın bir saatte yapabileceği dosya ve anlık görüntü yükleme sayısı.Limit yok; açık kayıtla 300
OLEAFLY_SIGN_IN_BURSTBir ağ adresinin art arda gelen bir istek dizisinde kaç oturum açma isteği gönderebileceği. Tek bir oturum açma yaklaşık altı istek harcar; bu yüzden varsayılan, aynı adresten 50 kişinin aynı anda oturum açmasını karşılar.300
OLEAFLY_SIGN_IN_PER_MINUTEİstek dizisinden sonra bir ağ adresinin her dakika geri aldığı oturum açma isteği sayısı.120
OLEAFLY_EMAIL_LINKS_PER_IPSunucunun 15 dakikada tek bir ağ adresindeki kişilere kaç oturum açma e-postası göndereceği.100
OLEAFLY_EMAIL_LINKS_PER_ADDRESSBir e-posta adresinin 15 dakikada alabileceği oturum açma e-postası sayısı. OLEAFLY_EMAIL_LINKS_PER_IP değerinden fazla olamaz.3
OLEAFLY_DEVICE_CODES_PER_IPTek bir ağ adresindeki kişilerin 10 dakikada isteyebileceği oturum açma kodu sayısı.100
OLEAFLY_SNAPSHOT_MEMORY_MBSunucunun proje anlık görüntüleri oluştururken kullanabileceği bellek miktarı, megabayt cinsinden.Kapsayıcının bellek sınırının yarısı; sınır yoksa 1024
OLEAFLY_BEHIND_PROXYHer kişinin adresini, vekil sunucunuzun eklediği X-Forwarded-For üstbilgisinden alır. Compose, Coolify ve Render dosyaları bunu açar.false
OLEAFLY_PROXY_HOPSHer isteğin sunucuya ulaşmadan önce üzerinden geçtiği vekil sunucu sayısı. OLEAFLY_BEHIND_PROXY=true gerektirir.1
OLEAFLY_LOG_LEVELSunucunun günlüğe ne kadar ayrıntı yazdığı: error, warn, info, debug veya trace. Sunucunun kullandığı kitaplıklar, debug veya trace seçmedikçe yalnızca uyarıları günlüğe yazar.info
OLEAFLY_SECURITY_LOG_DAYSGüvenlik günlüğü girdilerinin, proje erişim günlüğü girdilerinin ve yanıtlanmış ya da süresi geçmiş konuk davetlerinin kaç gün saklanacağı.365
OLEAFLY_ARCHIVE_DAYSSahibi paylaşmayı bıraktıktan sonra bir projenin kaç gün saklanacağı.30
OLEAFLY_POLL_HOLD_SECONDSBekleyen düzenleme olmadığında sunucunun bir uzun yoklama isteğini kaç saniye açık tutacağı; 1 ile 40 saniye arası. Sunucunun önündeki vekil sunucuların boşta kalma zaman aşımının birkaç saniye altında tutun.25

Compose .env dosyasında, $ veya # içeren bir değeri tek tırnak içine yazın. Gizli bilgi tutan ayarlar dosyalardan da okunabilir. Gizli bilgileri .env dışında tutma bölümünü okuyun.

Varsayılan olarak sunucu her şeyi OLEAFLY_DATA_DIR içinde tutar: veritabanı, kişilerin paylaştığı dosyalar ve proje anlık görüntüleri. Anlık görüntüler, kişilerin hızlıca katılmasını ve son durumu yakalamasını sağlayan, her projenin kaydedilmiş kopyalarıdır.

Sunucu, dosyaları ve anlık görüntüleri bunun yerine Amazon S3’te ya da MinIO veya Cloudflare R2 gibi S3 uyumlu API’ye sahip başka bir depoda tutabilir. Veritabanı her iki durumda da OLEAFLY_DATA_DIR içinde kalır; bu yüzden sunucunun veri klasörüne yine ihtiyacı vardır.

  1. Bir kova oluşturun ve ona genel erişimi engelleyin.

  2. Yalnızca o kovadaki nesneleri okuyabilen, yazabilen ve silebilen, başka hiçbir şey yapamayan bir anahtar oluşturun. Amazon S3’te bu, arn:aws:s3:::lab-bucket/* üzerinde (klasör kullanıyorsanız arn:aws:s3:::lab-bucket/oleafly/* üzerinde) s3:GetObject, s3:PutObject ve s3:DeleteObject anlamına gelir.

  3. Değişkenleri ayarlayın, örneğin .env içinde:

    Terminal penceresi
    OLEAFLY_BLOB_STORE=s3://lab-bucket/oleafly
    OLEAFLY_S3_REGION=eu-west-1
    OLEAFLY_S3_ACCESS_KEY_ID=your-access-key-id
    OLEAFLY_S3_SECRET_ACCESS_KEY=your-secret-access-key

Amazon S3 dışındaki bir depo için ayrıca OLEAFLY_S3_ENDPOINT değerini adresine ayarlayın, örneğin https://minio.example.org:9000 veya https://<account-id>.r2.cloudflarestorage.com, ve OLEAFLY_S3_REGION değerini beklediği bölgeye ayarlayın (R2 için auto). Düz http:// da çalışır, ancak yalnızca depo sunucuyla aynı özel ağda bulunuyorsa kullanın.

Kova adından sonraki bölüm isteğe bağlı bir klasördür. Her dosya, SHA-256 karmasının adını taşır ve o karmanın ilk iki karakterinin altında yer alır; bu yüzden karması 3f9a ile başlayan bir dosya oleafly/3f/3f9a... olarak saklanır. Anlık görüntülerin, her proje için bir klasör içeren kendi snapshots klasörü vardır. Sunucu bir dosyayı veya anlık görüntüyü geri okuduğunda baytları karmayla karşılaştırır ve uymayanı reddeder. Kova olmadığında aynı düzen OLEAFLY_DATA_DIR içindeki blobs klasöründedir.

Kova bir isteği reddederse o yükleme veya indirme başarısız olur ve sunucu günlüğü kovanın ne dediğini gösterir, örneğin 403 Forbidden (AccessDenied). Sunucu hatası, zaman aşımı veya kopan bağlantı farklıdır: sunucu en fazla üç kez dener ve denemeler arasında kısa rastgele bir duraklama yapar. Bir nesneyi silemezse bunu not eder ve 6 saatte bir yapılan her bakım turunda yeniden dener; böylece bir kesinti arkada nesne bırakmaz.

Bir proje paylaşıldığında, sahibinin uygulaması ilk anlık görüntüyü yükler ve o cihazın anahtarıyla imzalar. O andan itibaren her anlık görüntüyü sunucu kendisi, önceki anlık görüntüden ve o günden bu yana kişilerin gönderdiği değişikliklerden oluşturur. Bir projede son anlık görüntüden sonra 1.000 değişiklik birikince yeni bir anlık görüntü oluşturulur. Sunucu her zaman en az son 2.000 değişikliği tutar; böylece kısa süre uzak kalmış bir cihaz bunlardan güncel hale gelir ve tüm projeyi yeniden indirmez.

Bir anlık görüntü oluşturmak, önceki anlık görüntünün boyutunun yaklaşık on katı artı ondan sonraki değişiklikler kadar yer ister. Sunucu yalnızca OLEAFLY_SNAPSHOT_MEMORY_MB içine sığan bir oluşturmaya başlar ve aynı anda çalışan oluşturmalar bu miktarı paylaşır. Bir oluşturma sığmazsa sunucu onu atlar, ne kadar belleğe ihtiyacı olduğunu günlüğe yazar ve projenin tüm değişikliklerini tutar. Cihazlar sonra bu değişikliklerden, her seferinde birkaç megabayt alarak güncel hale gelir. Ayarı yükseltirseniz bir sonraki anlık görüntü oluşturulur. Sunucu, OLEAFLY_MAX_PROJECT_MB değerinden büyük bir anlık görüntüyü depolamaz.

Bir sahip ya da düzenleyen paylaşılan bir projeyi başarıyla derlediğinde uygulaması PDF’i, varsa SyncTeX dosyasıyla birlikte sunucuya gönderir. Her proje için dakikada en fazla bir PDF gönderir. Sunucu her proje için bir PDF ve bir SyncTeX dosyası tutar; ana dosyanın adı, kimin derlediği ve ne zaman derlendiğiyle birlikte. Tarayıcı erişimi bu PDF’i projedeki kişilere gösterir.

Her yükleme bir öncekinin yerini alır ve eski dosya, artık hiçbir şey onu kullanmadığında silinir. Derlenmiş dosyalar diğer dosyalarla birlikte, diskte ya da kovada saklanır ve projeleriyle birlikte silinir. Derlenmiş bir dosya OLEAFLY_MAX_FILE_MB kadar büyük olabilir. Sahibin hesap depolama alanından düşer ama saatlik yüklemelere sayılmaz.

Bir projenin her üyesi derlenmiş dosyalarını okuyabilir. Bunları yalnızca sahipler ve düzenleyenler yenileriyle değiştirebilir.

Sunucu düz HTTP konuşur; bu yüzden HTTPS’yi önündeki bir şey halleder: Compose kurulumunda Caddy, Coolify’nın vekil sunucusu veya üniversitenizinki gibi halihazırda çalıştırdığınız bir web sunucusu. Önünde ne varsa şunları yapmalıdır:

  • OLEAFLY_MAX_PROJECT_MB kadar büyük istekleri kabul etmek
  • İstemcinin adresini X-Forwarded-For üstbilgisine eklemek

Ayrıca WebSocket yükseltmelerini /ws adresine geçirmeli ve bu bağlantıları en az bir saat açık tutmalıdır. Canlı düzenleme, mümkün olduğunda bunları kullanır. Tarayıcı erişimi açıkken bunları /web/ws adresine de geçirmelidir, çünkü tarayıcı uygulamasının daha yavaş bir yedek yolu yoktur.

Sunucuyu yalnızca vekil sunucunun erişebileceği bir yerde çalıştırın. Aynı makinede OLEAFLY_BIND=127.0.0.1:8080 ayarlayın. Ardından OLEAFLY_BEHIND_PROXY=true ayarlayın.

Bazı ağlar WebSocket bağlantılarını engeller; genellikle filtreleyen bir vekil sunucu kullanan üniversite veya şirket ağları. Canlı düzenleme orada yine çalışır, daha yavaş. Sunucu HTTPS üzerinden hâlâ yanıt verirken art arda iki WebSocket denemesi başarısız olursa Oleafly, HTTP uzun yoklamasına geçer. Düzenlemeleri /api/v1/projects/<project>/frames adresine gönderir ve diğer kişilerin düzenlemelerini /api/v1/projects/<project>/poll üzerinde bekler; her isteği en fazla OLEAFLY_POLL_HOLD_SECONDS süresince açık tutar. Her düzenleme yine ulaşır. Oleafly her dakika WebSocket’i yeniden dener ve biri bağlanır bağlanmaz ona geri döner.

Oleafly’deki Bağlantıyı test et ve yönetici konsolundaki Bağlantı denetimleri, bunun olduğunu şöyle söyler: “Bu ağ olağan yolu engellediği için canlı düzenlemeler daha yavaş bir yoldan gidiyor. Yine de ulaşıyorlar.”

Vekil sunucuyu sunucunun önünde siz çalıştırıyorsanız, WebSocket yükseltmelerini yine de geçirin. Uzun yoklama çalışır, ancak her düzenleme grubu ek bir isteğe ve biraz daha gecikmeye mal olur.

Bazı vekil sunucular, 30 saniyeden az sessiz kalan bir isteği kapatır; kısa bir proxy_read_timeout ile nginx bunlardan biridir. Bunlar uzun yoklama isteklerine 502 veya 504 hatasıyla yanıt verir ve düzenlemeler geç ulaşır. OLEAFLY_POLL_HOLD_SECONDS değerini bu zaman aşımının birkaç saniye altına ayarlayın, örneğin 10 saniyelik bir zaman aşımı için 8.

Sunucu istemci adresini iki yerde not eder: güvenlik günlüğünde ve bir adresin ne sıklıkla oturum açma başlatabileceğini ya da canlı bağlantı açabileceğini belirleyen limitlerde.

Ayar olmadan sunucu, kendisine bağlanan neyse onun adresini kullanır. Bir vekil sunucunun arkasında bu her zaman vekil sunucudur; bu yüzden herkes tek bir limit paylaşır ve güvenlik günlüğünde yalnızca vekil sunucunun adresi görünür.

OLEAFLY_BEHIND_PROXY=true ile sunucu X-Forwarded-For üstbilgisini okur ve içindeki son adresi, yani vekil sunucunuzun eklediği adresi kullanır. Üstbilgi yoksa veya geçerli bir adres içermiyorsa sunucu, bağlanan tarafın adresine geri döner. Başka hiçbir şey değişmez. Sunucu X-Forwarded-Proto, X-Forwarded-Host ve Forwarded üstbilgilerini yok sayar ve dağıttığı her adresi OLEAFLY_PUBLIC_URL üzerinden oluşturur.

Bunu yalnızca her istek vekil sunucunuz üzerinden gelirken açın. Kişiler sunucuya doğrudan da erişebiliyorsa, herhangi biri uydurma bir X-Forwarded-For gönderebilir, güvenlik günlüğüne istediği adresi düşürebilir ve oturum açma limitini aşabilir.

Art arda iki vekil sunucu varsa, örneğin Coolify’nın vekil sunucusunun önünde Cloudflare, OLEAFLY_PROXY_HOPS=2 ayarlayın. Sunucu bu durumda sondan ikinci adresi alır. Yalnızca her isteğin üzerinden geçtiği vekil sunucuları sayın. Doğrudan sunucuya giden bir Cloudflare Tunnel bir olarak sayılır.

Sayıyı denetlemek için kendi bilgisayarınızdan oturum açın ve yönetici konsolunda Güvenlik günlüğü’nü açın. En yeni girdi, ifconfig.me gibi bir sitenin bildirdiği genel adresinizi göstermelidir. Onun yerine özel bir adres veya Cloudflare adresi gösteriyorsa OLEAFLY_PROXY_HOPS değerini bir artırın.

Caddy, WebSocket bağlantılarını ve X-Forwarded-For üstbilgisini ek ayar olmadan geçirir ve sertifikayı kendisi alır. Öne HTTPS koyma bölümünde tam Caddyfile vardır.

Önce etki alanı için bir sertifika alın, örneğin certbot ile. Sonra bunu /etc/nginx/conf.d/oleafly.conf olarak kaydedin ve sudo nginx -t && sudo systemctl reload nginx komutunu çalıştırın:

map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
server {
listen 443 ssl;
server_name collab.example.org;
ssl_certificate /etc/letsencrypt/live/collab.example.org/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/collab.example.org/privkey.pem;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
proxy_set_header X-Forwarded-For $remote_addr;
proxy_read_timeout 1h;
proxy_send_timeout 1h;
client_max_body_size 200m;
}
}

client_max_body_size, OLEAFLY_MAX_PROJECT_MB varsayılanı olan 200 ile eşleşir. Birini yükseltirseniz diğerini de yükseltin.

Apache 2.4.47 veya daha yenisine ihtiyacınız vardır; Debian 12 ile Ubuntu 22.04 ve sonraki sürümler bunu içerir. Modülleri açın:

Terminal penceresi
sudo a2enmod proxy proxy_http ssl

Bunu /etc/apache2/sites-available/oleafly.conf olarak kaydedin, ardından sudo a2ensite oleafly && sudo systemctl reload apache2 komutunu çalıştırın:

<VirtualHost *:443>
ServerName collab.example.org
SSLEngine on
SSLCertificateFile /etc/letsencrypt/live/collab.example.org/fullchain.pem
SSLCertificateKeyFile /etc/letsencrypt/live/collab.example.org/privkey.pem
ProxyPreserveHost On
ProxyPass / http://127.0.0.1:8080/ upgrade=websocket timeout=3600
ProxyPassReverse / http://127.0.0.1:8080/
</VirtualHost>

upgrade=websocket WebSocket bağlantılarını geçirir ve timeout=3600 onları bir saat açık tutar. Apache, istemcinin adresini X-Forwarded-For üstbilgisine kendiliğinden ekler.

Sunucu bir yol altında çalışıyorsa, yolu OLEAFLY_PUBLIC_URL içine ekleyin, örneğin https://www.cs.example.edu/oleafly, ve oturum açma sağlayıcılarına kaydettiğiniz geri çağırma adreslerine de ekleyin. Sunucu, o yol dahil ve yolsuz her iki biçimde de yanıt verir; bu yüzden vekil sunucunuz yolu geçirebilir veya kaldırabilir. nginx ile içinde aynı satırlar bulunan location /oleafly/ { kullanın ve nginx yolun üzerinden geçsin diye proxy_pass http://127.0.0.1:8080; satırını yolsuz bırakın.

Bir sınıfın tamamı çoğu zaman tek bir ağ adresinden oturum açar, örneğin bir üniversitenin NAT’ından. Varsayılanlar buna göre ayarlanmıştır:

  • Oturum açmalar: bir adrese önce 300 oturum açma isteğinden oluşan bir dizinin hakkı verilir, ardından saniyede iki. Bir oturum açma yaklaşık altı istek harcadığından 50 kişi aynı anda oturum açabilir. Bunları OLEAFLY_SIGN_IN_BURST ve OLEAFLY_SIGN_IN_PER_MINUTE ile değiştirin.
  • E-posta bağlantıları: 15 dakikada bir adrese 100 ve bir e-posta adresine 3. Bunları OLEAFLY_EMAIL_LINKS_PER_IP ve OLEAFLY_EMAIL_LINKS_PER_ADDRESS ile değiştirin.
  • Oturum açma kodları: 10 dakikada bir adresten 100 kod ve 10 yanlış kod. Bunu OLEAFLY_DEVICE_CODES_PER_IP ile değiştirin.
  • Canlı bağlantıların kendi, daha büyük limiti vardır; böylece bir adresin arkasındaki bir sınıfın tamamı yeniden başlatmadan sonra aynı anda yeniden bağlanabilir. Bu limiti yalnızca oturumunu kanıtlayamayan bağlantılar tüketir: önce 300’lük bir dizi, ardından saniyede on. Oturumunu kanıtlayan bir bağlantı ise kendi cihazının hakkından düşer; bir cihaz önce bir dizide 60 kez, ardından saniyede bir kez yeniden bağlanabilir.

Bir /64 ağındaki tüm IPv6 adresleri tek bir adres sayılır. Bu limitler kişi başına yalnızca sunucu herkesin gerçek adresini gördüğünde işler; bu yüzden vekil sunucunuzu doğru kurun.

Sunucu her canlı bağlantıya 30 saniyede bir ping gönderir. Bu pingleri 90 saniye boyunca yanıtsız bırakan bir bağlantıyı ve sunucunun gönderdiklerini okumayı bırakan bir bağlantıyı kapatır.

Proje limitleri herkese uygulanır: tüm bir proje için OLEAFLY_MAX_PROJECT_MB (varsayılan 200 MB), tek bir dosya için OLEAFLY_MAX_FILE_MB (50 MB) ve bir projedeki kişiler için OLEAFLY_MAX_MEMBERS_PER_PROJECT (20). Yönetici konsolundaki Genel bakış, geçerli limitleri gösterir.

Her hesaba üç limit uygulanır. Siz ayarlayana kadar kapalıdırlar; açık kayıt açıksa şu varsayılanlarla açılırlar:

LimitAyarAçık kayıtla
Bir hesabın sahip olduğu projeler için depolama alanıOLEAFLY_ACCOUNT_STORAGE_MB100 MB
Bir hesabın sahip olduğu paylaşılan projelerOLEAFLY_MAX_PROJECTS_PER_ACCOUNT50
Bir hesabın bir saatte yaptığı yüklemelerOLEAFLY_UPLOADS_PER_HOUR300

Ayarladığınız bir değer her zaman varsayılanın önüne geçer. Her biri en az 1 olan bir tam sayı olmalıdır.

  • Depolama alanı, hesabın sahip olduğu her projenin (arşivlenmişler dahil) dosyalarını, değişiklik geçmişini ve derlenmiş PDF’lerini toplar. Anlık görüntüler sayılmaz. Birinin bir projeye eklediği dosya, projenin sahibinin hesabından düşer. Sahibin hesabı dolduğunda sunucu, onun projeleri için yeni dosyaları ve derlenmiş PDF’leri reddeder ve sahip başka bir proje paylaşamaz. Dosya, onu ekleyen kişinin bilgisayarında kalır. Kişilerin yazdığı metin eşitlenmeye devam eder.
  • Paylaşılan projeler, hesabın paylaştığı projeleri, hâlâ karşıya yüklenmekte olanlar dahil, sayar. Arşivlenmiş projeler sayılmaz; bu yüzden bir projenin paylaşımını durdurmak yer açar.
  • Yüklemeler, bir saatlik bir zaman aralığındaki her dosya ve anlık görüntü yüklemesini sayar. Derlenmiş PDF’ler sayılmaz. Oleafly, reddedilen bir dosyayı daha sonra kendiliğinden yeniden gönderir.

Yönetici konsolundaki Genel bakış bu limitleri göstermez. Açık kayıt açıkken sunucunun günlüğü, her başlangıçta bu limitleri adlarıyla yazar.

  • Sunucu günlüğü, docker compose logs oleafly-server, Coolify’nın Logs bölümü veya journalctl -u oleafly-server komutunun gösterdiğidir. OLEAFLY_LOG_LEVEL, ne kadar ayrıntı yazacağını belirler.
  • Güvenlik günlüğü, oturum açmaları ve reddedilen oturum açmaları, cihazları, kişileri, rolleri, ayarları, projeleri ve konukları kaydeder; her birinde saat ve IP adresi bulunur. Yöneticiler ve sorumlular bunu yönetici konsolundaki Güvenlik günlüğü altında okur. OLEAFLY_SECURITY_LOG_DAYS gününden eski girdiler silinir.
  • Proje erişim günlükleri, bir projeyi kimin açtığını, projeye katıldığını veya bir kopyasını indirdiğini, cihaz adı ve saatle birlikte kaydeder. Proje erişim günlüklerine izin ver açıkken bir projenin sahibi bunu açar ve yalnızca o sahibi okuyabilir. Aynı saklama süresi geçerlidir.

Eksiksiz bir yedek için ne gerektiği, dosyaların nerede saklandığına bağlıdır:

  • Diskteki dosyalar (OLEAFLY_BLOB_STORE=fs, varsayılan): veritabanı, dosyalar ve anlık görüntülerin tümü veri klasöründedir. Klasörün tamamını yedekleyin.
  • Kovadaki dosyalar: veri klasörü veritabanını tutar, kova ise dosyaları ve anlık görüntüleri. Veritabanının bir kopyası artı kova, eksiksiz bir yedektir. Yanlışlıkla silinen bir nesnenin geri getirilebilmesi için kova için sürümlemeyi açın.
Sunucu verileri nerede tutar ve neyi yedeklemeliVarsayılan olan diskteki dosyalarla, veri klasörü veritabanını ve dosyalarla anlık görüntüleri içeren blobs klasörünü tutar; bu yüzden klasörün tamamını yedeklersiniz. Bir kovadaki dosyalarla, veri klasörü veritabanını tutar, bir S3 kovası da dosyaları ve anlık görüntüleri tutar; bu yüzden veritabanını ve kovayı yedeklersiniz.Diskteki dosyalar (varsayılan)Bir kovadaki dosyalaroleafly-serverVeri klasörüVeritabanı: hesaplar, ayarlar, günlüklerblobs: dosyalar ve anlık görüntülerKlasörün tamamını yedekleyinoleafly-serverVeri klasörüVeritabanıS3 kovasıDosyalar veanlık görüntülerVeritabanını ve kovayı yedekleyinSunucu verileri nerede tutar ve neyi yedeklemeliVarsayılan olan diskteki dosyalarla, veri klasörü veritabanını ve dosyalarla anlık görüntüleri içeren blobs klasörünü tutar; bu yüzden klasörün tamamını yedeklersiniz. Bir kovadaki dosyalarla, veri klasörü veritabanını tutar, bir S3 kovası da dosyaları ve anlık görüntüleri tutar; bu yüzden veritabanını ve kovayı yedeklersiniz.Diskteki dosyalar (varsayılan)Bir kovadaki dosyalaroleafly-serverVeri klasörüVeritabanı ve blobs(dosyalar, anlık görüntüler)Klasörün tamamını yedekleyinoleafly-serverVeri klasörüVeritabanıS3 kovasıDosyalar veanlık görüntülerVeritabanını ve kovayıyedekleyin
Tam bir yedeğin neye ihtiyaç duyduğu dosyaların nerede saklandığına bağlıdır.

Düzenli olarak yedek alın ve kopyaları özel tutun, çünkü her projeyi içerirler. .env gibi ayarlarınız veri klasöründe değildir; bu yüzden onların da bir kopyasını tutun.

Docker ile, birimi kopyalarken sunucu birkaç saniye durur. Oleafly kendi kendine yeniden bağlanır. Bu komutları sunucunun klasöründe çalıştırın; yükleyiciyi kullandıysanız /opt/oleafly-server.

Terminal penceresi
cd /opt/oleafly-server
sudo docker compose stop oleafly-server
sudo docker run --rm -v oleafly-server_oleafly-data:/data:ro -v "$PWD":/backup debian:13.7-slim tar -C /data -czf /backup/oleafly-data-$(date +%F).tar.gz .
sudo docker compose start oleafly-server

systemd ile:

Terminal penceresi
sudo systemctl stop oleafly-server
sudo tar -C /var/lib/private/oleafly-server -czf /root/oleafly-data-$(date +%F).tar.gz .
sudo systemctl start oleafly-server

Arşivi başka bir makineye kopyalayın.

Coolify’da birimin adı, kaynağın kimliğiyle başlar. docker volume ls --filter name=oleafly-data ile bulun, oleafly-server_oleafly-data yerine kullanın ve sunucuyu docker compose yerine Coolify’nın panelinden durdurup başlatın.

Hiç geri yüklemediğiniz bir yedek yalnızca bir umuttur. Bu tatbikat, sunucunun ikinci bir kopyasını bir yedekten başlatır, çalışmakta olanı olduğu gibi bırakır ve ikisinin de aynı sunucu olduğunu denetler. Kendi arşivinizin tarihini 2026-10-11 yerine kullanın.

Terminal penceresi
cd /opt/oleafly-server
sudo docker volume create oleafly-restore-drill
sudo docker run --rm -v oleafly-restore-drill:/data -v "$PWD":/backup:ro debian:13.7-slim tar -C /data -xzf /backup/oleafly-data-2026-10-11.tar.gz
sudo docker run -d --name oleafly-restore-drill -v oleafly-restore-drill:/data -e OLEAFLY_PUBLIC_URL=https://restore-drill.invalid -e OLEAFLY_GITHUB_CLIENT_ID=restore-drill -e OLEAFLY_GITHUB_CLIENT_SECRET=restore-drill "$(sudo docker compose images -q oleafly-server)"
sudo docker run --rm --network container:oleafly-restore-drill curlimages/curl:8.22.0 -fsS --retry 10 --retry-connrefused --retry-delay 1 http://127.0.0.1:8080/.well-known/oleafly-server
curl -fsS https://collab.example.org/.well-known/oleafly-server

İki yanıttaki server_id eşleşmelidir. Tatbikat kopyasında kimseyi oturum açtıramayan yer tutucu bir GitHub oturum açması vardır ve açık portu yoktur; bu yüzden kimse onu kullanamaz. İşiniz bittiğinde kaldırın:

Terminal penceresi
sudo docker rm -f oleafly-restore-drill
sudo docker volume rm oleafly-restore-drill

Docker Compose ile gerçekten geri yüklemek için sunucuyu durdurun, birimin içeriğini arşivle değiştirin ve yeniden başlatın:

Terminal penceresi
cd /opt/oleafly-server
sudo docker compose stop oleafly-server
sudo docker run --rm -v oleafly-server_oleafly-data:/data -v "$PWD":/backup:ro debian:13.7-slim sh -c 'find /data -mindepth 1 -delete && tar -C /data -xzf /backup/oleafly-data-2026-10-11.tar.gz'
sudo docker compose start oleafly-server

systemd ile:

Terminal penceresi
sudo systemctl stop oleafly-server
sudo find /var/lib/private/oleafly-server -mindepth 1 -delete
sudo tar -C /var/lib/private/oleafly-server -xzf /root/oleafly-data-2026-10-11.tar.gz
sudo systemctl start oleafly-server

Geri yüklenmiş bir sunucuda, kişilerin yedekten sonra yaptığı değişiklikler eksiktir. Her uygulama, açık kalmış ya da sonradan açılmış olsun, yeniden bağlandığında bunu fark eder ve kendi eksik değişikliklerini yeniden gönderir. Bunun için kimsenin bir şey yapması gerekmez. Başka birinin eksik değişikliğine dayanan bir değişiklik, o kişi projeyi açana dek bekler, çünkü değişikliklerini yalnızca onun uygulaması gönderebilir. Sorun olduğu sırada düzenleme yapan herkesten, projeyi bir kez açmalarını isteyin.

Bir arşiv, yalnızca oluşturduğunuz anda orada olanı içerir. Litestream (yeni sekmede açılır), sunucunun veritabanındaki her değişikliği, olduktan yaklaşık bir saniye sonra S3 uyumlu bir kovaya kopyalar. Compose dosyası bunu isteğe bağlı bir hizmet olarak içerir.

Litestream yalnızca veritabanını kopyalar. Dosyalar bir kovadaysa kova zaten dosyaları ve anlık görüntüleri tutar; bu yüzden Litestream kopyası ile kova birlikte kayıp bir diski geri getirebilir. Dosyalar diskteyse birimin arşivlerini de almaya devam edin, çünkü Litestream blobs klasörünü kopyalamaz.

  1. Yalnızca bu sunucunun Litestream’inin kullandığı bir kova veya bir kovanın içindeki bir klasör oluşturun. OLEAFLY_BLOB_STORE ile paylaşmayın. Litestream’e, kovayı listeleyebilen ve içindeki nesneleri okuyup yazabilen ve silebilen bir anahtar verin.

  2. Ayrıntıları .env dosyasına ekleyin:

    Terminal penceresi
    LITESTREAM_REPLICA_URL=s3://lab-backups/oleafly-server
    LITESTREAM_REGION=eu-west-1
    LITESTREAM_ACCESS_KEY_ID=your-access-key-id
    LITESTREAM_SECRET_ACCESS_KEY=your-secret-access-key
    COMPOSE_PROFILES=litestream

    Amazon S3 dışındaki bir depo için ayrıca LITESTREAM_ENDPOINT değerini adresine ve LITESTREAM_REGION değerini beklediği bölgeye ayarlayın (R2 için auto). COMPOSE_PROFILES, her docker compose komutunun Litestream’i içermesini sağlar.

  3. Başlatın:

    Terminal penceresi
    sudo docker compose up -d
  4. Veritabanını kopyaladığını denetleyin. Bu, snapshot complete içeren bir satır yazdırır:

    Terminal penceresi
    sudo docker compose logs litestream | grep 'snapshot complete'

Litestream günde bir kez tam kopya alır ve bir haftalık kopyayla aralarındaki değişiklikleri tutar. Zamanlama litestream.yml içindedir.

Bu tatbikat, veritabanını kovadan geçici bir birime geri yükler, üzerinde sunucunun ikinci bir kopyasını başlatır ve ikisinin de aynı sunucu olduğunu denetler. Çalışan sunucuya dokunulmaz.

Terminal penceresi
cd /opt/oleafly-server
sudo docker run --rm -v oleafly-litestream-drill:/data "$(sudo docker compose images -q oleafly-server)" --version
sudo docker compose run --rm --no-deps -v oleafly-litestream-drill:/restore litestream restore -config /etc/litestream.yml -o /restore/oleafly-server.sqlite3 /data/oleafly-server.sqlite3
sudo docker run -d --name oleafly-litestream-drill -v oleafly-litestream-drill:/data -e OLEAFLY_PUBLIC_URL=https://restore-drill.invalid -e OLEAFLY_GITHUB_CLIENT_ID=restore-drill -e OLEAFLY_GITHUB_CLIENT_SECRET=restore-drill "$(sudo docker compose images -q oleafly-server)"
sudo docker run --rm --network container:oleafly-litestream-drill curlimages/curl:8.22.0 -fsS --retry 10 --retry-connrefused --retry-delay 1 http://127.0.0.1:8080/.well-known/oleafly-server
curl -fsS https://collab.example.org/.well-known/oleafly-server

İlk komut, geçici birimi sunucunun ihtiyaç duyduğu sahibiyle oluşturur. Son iki yanıttaki server_id eşleşmelidir. İşiniz bittiğinde kopyayı kaldırın:

Terminal penceresi
sudo docker rm -f oleafly-litestream-drill
sudo docker volume rm oleafly-litestream-drill

Veritabanı dosyası bozulmuş ya da kaybolmuş ama veri klasörünün geri kalanı sağlamsa sunucuyu ve Litestream’i durdurun, veritabanından geriye kalanı kaldırın, geri yükleyin ve yeniden başlatın:

Terminal penceresi
cd /opt/oleafly-server
sudo docker compose stop oleafly-server litestream
sudo docker run --rm -v oleafly-server_oleafly-data:/data debian:13.7-slim rm -rf /data/oleafly-server.sqlite3 /data/oleafly-server.sqlite3-wal /data/oleafly-server.sqlite3-shm /data/.oleafly-server.sqlite3-litestream
sudo docker compose run --rm --no-deps litestream restore -config /etc/litestream.yml /data/oleafly-server.sqlite3
sudo docker compose up -d

Dosyaların kovada olduğu bir disk kaybından sonra, yukarıdaki komutları yeni, boş birimde çalıştırın ve .env içindeki kova ayarlarını aynı tutun. Her proje, dosyalarıyla ve anlık görüntüleriyle geri gelir.

Dosyaların diskte olduğu bir disk kaybından sonra en yeni arşivinizi geri yükleyin ve işi orada bırakın. Litestream’den gelen daha yeni bir veritabanını daha eski bir arşivin üstüne koymayın. Veritabanı, arşivde bulunmayan dosyalara ve anlık görüntülere işaret ederdi ve o projeler açılmazdı.

Önce yedek alın. Sunucu, yeni bir sürüm ilk kez başladığında veritabanını günceller; bu yüzden eski bir sürüme dönmek, güncellemeden önce aldığınız yedeği geri yüklemek demektir.

  • Tek komutla kurulum: curl -fsSL https://oleafly.com/server/install.sh | sudo sh -s -- update komutunu çalıştırın. .env dosyasını korur, yeni sürümün dosyalarını ve imajını alır ve sunucuyu yeniden başlatır.
  • Docker Compose’u elle kurma: Docker Compose’u elle kurma bölümündeki gibi yeni sürümün dosyalarını sunucunun klasörüne indirin, ardından sudo docker compose up -d komutunu çalıştırın.
  • Coolify: Redeploy düğmesini seçin. Yayınlanan imajla bu, imajın etiketi altındaki en yeni sürümü çeker.
  • Render: hizmeti açın ve elle bir dağıtım başlatın; bu, imajı yeniden çeker.
  • Railway: hizmeti menüsünden yeniden dağıtın. Railway, GitHub’ın kayıt defterindeki bir imajı kendi kendine de güncelleyebilir.
  • systemd: yeni sürümü Sunucuyu indirin bölümündeki gibi kurun, ardından sudo systemctl restart oleafly-server komutunu çalıştırın.

Oleafly, her bağlanışında sunucunun sürümünü denetler. Uygulama ile sunucu birlikte çalışamıyorsa Oleafly, hangisinin güncellenmesi gerektiğini söyler.

Görsel önizlemesi

Yapay zekâ yanıtları yüklenemedi

Yeniden deneyin ya da dokümanlarda arama yapın.