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.
Ayarlar
Bölüm başlığı “Ayarlar”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şken | Ne yapar | Varsayılan |
|---|---|---|
OLEAFLY_PUBLIC_URL | Kiş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_BIND | Sunucunun dinlediği adres ve port. | 0.0.0.0:8080 |
OLEAFLY_DATA_DIR | Veritabanının ve depolanan dosyaların bulunduğu klasör. | /data |
OLEAFLY_SERVER_NAME | Kişilerin Oleafly’de gördüğü ad, örneğin Smith Lab. | Oleafly Server |
OLEAFLY_SERVER_ICON_URL | Adın yanında gösterilen kare bir görselin HTTPS adresi. | Yok |
OLEAFLY_SETUP_CODE | Kendi 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_SECRET | GitHub ile oturum açmayı açar. | Kapalı |
OLEAFLY_GITHUB_URL | Bir GitHub Enterprise Server’ın adresi. | https://github.com |
OLEAFLY_GITHUB_API_URL | GitHub API adresi, sizinki alışılmadıksa. | https://api.github.com ya da OLEAFLY_GITHUB_URL altında /api/v3 |
OLEAFLY_GITHUB_LABEL | GitHub 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>_LABEL | Oturum açma düğmesindeki metin, örneğin University login. | <NAME> |
OLEAFLY_OIDC_<NAME>_TRUST_EMAIL | Bu 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_FROM | E-posta. E-posta bölümünü okuyun. | Kapalı |
OLEAFLY_OPEN_SIGNUP | Sağ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_WEB | Tarayı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_ENDPOINT | Amazon 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_REGION | Kovanın bölgesi. | us-east-1 |
OLEAFLY_S3_ACCESS_KEY_ID, OLEAFLY_S3_SECRET_ACCESS_KEY | Sunucunun kova için kullandığı anahtar. s3:// adresiyle zorunludur. | Yok |
OLEAFLY_MAX_PROJECT_MB | Sunucunun kabul ettiği en büyük proje, megabayt cinsinden. | 200 |
OLEAFLY_MAX_FILE_MB | En büyük tek dosya, megabayt cinsinden. | 50 |
OLEAFLY_MAX_MEMBERS_PER_PROJECT | Bir projedeki en fazla kişi sayısı. | 20 |
OLEAFLY_ACCOUNT_STORAGE_MB | Bir 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_ACCOUNT | Bir hesabın sahip olabileceği en fazla paylaşılan proje sayısı. | Limit yok; açık kayıtla 50 |
OLEAFLY_UPLOADS_PER_HOUR | Bir 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_BURST | Bir 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_IP | Sunucunun 15 dakikada tek bir ağ adresindeki kişilere kaç oturum açma e-postası göndereceği. | 100 |
OLEAFLY_EMAIL_LINKS_PER_ADDRESS | Bir 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_IP | Tek bir ağ adresindeki kişilerin 10 dakikada isteyebileceği oturum açma kodu sayısı. | 100 |
OLEAFLY_SNAPSHOT_MEMORY_MB | Sunucunun 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_PROXY | Her kişinin adresini, vekil sunucunuzun eklediği X-Forwarded-For üstbilgisinden alır. Compose, Coolify ve Render dosyaları bunu açar. | false |
OLEAFLY_PROXY_HOPS | Her isteğin sunucuya ulaşmadan önce üzerinden geçtiği vekil sunucu sayısı. OLEAFLY_BEHIND_PROXY=true gerektirir. | 1 |
OLEAFLY_LOG_LEVEL | Sunucunun 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_DAYS | Gü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_DAYS | Sahibi paylaşmayı bıraktıktan sonra bir projenin kaç gün saklanacağı. | 30 |
OLEAFLY_POLL_HOLD_SECONDS | Bekleyen 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.
Depolama
Bölüm başlığı “Depolama”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.
Kova içindeki dosyalar
Bölüm başlığı “Kova içindeki dosyalar”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.
-
Bir kova oluşturun ve ona genel erişimi engelleyin.
-
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ızarn:aws:s3:::lab-bucket/oleafly/*üzerinde)s3:GetObject,s3:PutObjectves3:DeleteObjectanlamına gelir. -
Değişkenleri ayarlayın, örneğin
.enviçinde:Terminal penceresi OLEAFLY_BLOB_STORE=s3://lab-bucket/oleaflyOLEAFLY_S3_REGION=eu-west-1OLEAFLY_S3_ACCESS_KEY_ID=your-access-key-idOLEAFLY_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.
Anlık görüntüler ve bellek
Bölüm başlığı “Anlık görüntüler ve bellek”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.
Derlenmiş PDF’ler
Bölüm başlığı “Derlenmiş PDF’ler”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.
Ters vekil sunucu arkasında
Bölüm başlığı “Ters vekil sunucu arkasında”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_MBkadar 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.
WebSocket bağlantıları engellendiğinde
Bölüm başlığı “WebSocket bağlantıları engellendiğinde”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.
OLEAFLY_BEHIND_PROXY neyi değiştirir
Bölüm başlığı “OLEAFLY_BEHIND_PROXY neyi değiştirir”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
Bölüm başlığı “Apache”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:
sudo a2enmod proxy proxy_http sslBunu /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.
Bir yol altında
Bölüm başlığı “Bir yol altında”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.
Tek bir ağdaki bir sınıf için limitler
Bölüm başlığı “Tek bir ağdaki bir sınıf için limitler”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_BURSTveOLEAFLY_SIGN_IN_PER_MINUTEile değiştirin. - E-posta bağlantıları: 15 dakikada bir adrese 100 ve bir e-posta adresine 3. Bunları
OLEAFLY_EMAIL_LINKS_PER_IPveOLEAFLY_EMAIL_LINKS_PER_ADDRESSile değiştirin. - Oturum açma kodları: 10 dakikada bir adresten 100 kod ve 10 yanlış kod. Bunu
OLEAFLY_DEVICE_CODES_PER_IPile 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.
Hesap başına limitler
Bölüm başlığı “Hesap başına limitler”Her hesaba üç limit uygulanır. Siz ayarlayana kadar kapalıdırlar; açık kayıt açıksa şu varsayılanlarla açılırlar:
| Limit | Ayar | Açık kayıtla |
|---|---|---|
| Bir hesabın sahip olduğu projeler için depolama alanı | OLEAFLY_ACCOUNT_STORAGE_MB | 100 MB |
| Bir hesabın sahip olduğu paylaşılan projeler | OLEAFLY_MAX_PROJECTS_PER_ACCOUNT | 50 |
| Bir hesabın bir saatte yaptığı yüklemeler | OLEAFLY_UPLOADS_PER_HOUR | 300 |
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.
Günlükler
Bölüm başlığı “Günlükler”- Sunucu günlüğü,
docker compose logs oleafly-server, Coolify’nın Logs bölümü veyajournalctl -u oleafly-serverkomutunun 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_DAYSgü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.
Yedekler
Bölüm başlığı “Yedekler”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.
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.
cd /opt/oleafly-serversudo docker compose stop oleafly-serversudo 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-serversystemd ile:
sudo systemctl stop oleafly-serversudo tar -C /var/lib/private/oleafly-server -czf /root/oleafly-data-$(date +%F).tar.gz .sudo systemctl start oleafly-serverArş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.
Geri yükleme tatbikatı
Bölüm başlığı “Geri yükleme tatbikatı”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.
cd /opt/oleafly-serversudo docker volume create oleafly-restore-drillsudo 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.gzsudo 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-servercurl -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:
sudo docker rm -f oleafly-restore-drillsudo docker volume rm oleafly-restore-drillGeri yükleme
Bölüm başlığı “Geri yükleme”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:
cd /opt/oleafly-serversudo docker compose stop oleafly-serversudo 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-serversystemd ile:
sudo systemctl stop oleafly-serversudo find /var/lib/private/oleafly-server -mindepth 1 -deletesudo tar -C /var/lib/private/oleafly-server -xzf /root/oleafly-data-2026-10-11.tar.gzsudo systemctl start oleafly-serverGeri 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.
Litestream ile sürekli kopyalar
Bölüm başlığı “Litestream ile sürekli kopyalar”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.
-
Yalnızca bu sunucunun Litestream’inin kullandığı bir kova veya bir kovanın içindeki bir klasör oluşturun.
OLEAFLY_BLOB_STOREile paylaşmayın. Litestream’e, kovayı listeleyebilen ve içindeki nesneleri okuyup yazabilen ve silebilen bir anahtar verin. -
Ayrıntıları
.envdosyasına ekleyin:Terminal penceresi LITESTREAM_REPLICA_URL=s3://lab-backups/oleafly-serverLITESTREAM_REGION=eu-west-1LITESTREAM_ACCESS_KEY_ID=your-access-key-idLITESTREAM_SECRET_ACCESS_KEY=your-secret-access-keyCOMPOSE_PROFILES=litestreamAmazon S3 dışındaki bir depo için ayrıca
LITESTREAM_ENDPOINTdeğerini adresine veLITESTREAM_REGIONdeğerini beklediği bölgeye ayarlayın (R2 içinauto).COMPOSE_PROFILES, herdocker composekomutunun Litestream’i içermesini sağlar. -
Başlatın:
Terminal penceresi sudo docker compose up -d -
Veritabanını kopyaladığını denetleyin. Bu,
snapshot completeiç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.
Litestream geri yükleme tatbikatı
Bölüm başlığı “Litestream geri yükleme tatbikatı”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.
cd /opt/oleafly-serversudo docker run --rm -v oleafly-litestream-drill:/data "$(sudo docker compose images -q oleafly-server)" --versionsudo 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.sqlite3sudo 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-servercurl -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:
sudo docker rm -f oleafly-litestream-drillsudo docker volume rm oleafly-litestream-drillVeritabanını Litestream’den geri yükleme
Bölüm başlığı “Veritabanını Litestream’den geri yükleme”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:
cd /opt/oleafly-serversudo docker compose stop oleafly-server litestreamsudo 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-litestreamsudo docker compose run --rm --no-deps litestream restore -config /etc/litestream.yml /data/oleafly-server.sqlite3sudo docker compose up -dDosyaları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ı.
Güncelleme
Bölüm başlığı “Güncelleme”Ö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 -- updatekomutunu çalıştırın..envdosyası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 -dkomutunu ç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-serverkomutunu ç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.