Z-Push; Microsoft’un ActiveSync protokolünü açık-kaynak olarak uygulayan, mobil cihazların e-posta, takvim ve kişi verilerini push yöntemiyle senkronize etmesini sağlayan bir PHP uygulamasıdır. Nginx + PHP-FPM üzerinde çalışır; Zimbra Open Source Edition için fiilen standart ActiveSync çözümüdür.
ActiveSync’in push modeli, istemcinin sürekli IMAP IDLE açık tutması yerine sunucunun yeni veriyi aktif olarak cihaza iletmesi anlamına gelir - bu, pil ömrü ve anlık bildirim güvenilirliği açısından belirgin avantaj sağlar.
Mono’nun yaklaşımı
- Backend: Zimbra OSE kurulumlarında standart olarak Z-Push devreye alınır.
- State depolama: 200+ cihaz için Redis state backend; daha küçük kurulumlar için dosya sistemi.
- TLS: Nginx reverse proxy üzerinden HTTPS zorunlu; cihaz PIN politikası Z-Push politika dosyasından yönetilir.
- Loglama: Z-Push
LOGLEVEL_DEBUGyerineLOGLEVEL_WARNproduction’da; sorun anında geçici debug modu.
Yaygın sorunlar ve çözümler
- Cihaz senkronize olmuyor: Z-Push state dosyası bozulmuş olabilir. İlgili kullanıcının state dizinini (
/var/lib/z-push/<username>) temizle; cihaz yeniden eşleşir. - PHP-FPM 502 hatası:
pm.max_childrenyetersiz. Eşzamanlı cihaz sayısınız-push-admin.php -a listile kontrol et; havuzu artır. - Takvim/kişi gelmiyor: Backend konfigürasyonunda ilgili veri sınıflarının (
CALENDAR_FOLDER,CONTACT_FOLDER) doğru tanımlandığını doğrula. - Cihaz politikası uyumsuzluğu: Bazı eski Android cihazlar şifreleme politikasını karşılamaz;
PROVISIONINGdeğerinifalseyaparak bypass edilebilir (güvenlik değerlendirmesi ile).
İlgili hizmetlerimiz
Sıkça sorulan sorular
ActiveSync nedir?
ActiveSync, Microsoft tarafından geliştirilen ve mobil cihazların e-posta sunucusuyla e-posta, takvim ve kişileri push yöntemiyle senkronize etmesini sağlayan protokoldür. IMAP’tan farkı: IMAP’ta cihaz periyodik olarak sunucuyu yoklar; ActiveSync’te sunucu yeni veriyi anında cihaza iter. Z-Push bu protokolü açık-kaynak olarak uygular.
Zimbra'nın kendi ActiveSync'i varken Z-Push neden kullanılır?
Zimbra Network Edition kendi native ActiveSync desteğiyle gelir. Z-Push, Open Source Edition kullanan kurumlar için bu boşluğu doldurur. Ayrıca Zimbra dışında Kopano, SOGo veya özel IMAP/CalDAV backend’leri için de Z-Push bir seçenek olmaya devam eder.
Hangi cihaz ve istemciler desteklenir?
iOS Mail, Android mail istemcileri, Outlook (2013+), Samsung Mail ve ActiveSync protokolünü destekleyen tüm istemciler. Z-Push, Microsoft’un ActiveSync 14.1 protokolünü uygular; bu versiyon modern iOS ve Android sürümleriyle tam uyumludur.
Z-Push performansını ne etkiler?
Eşzamanlı bağlı cihaz sayısı ve PHP-FPM worker havuzu doğrudan ilişkilidir. 500+ cihazlı bir kurulumda PHP-FPM
pm.max_children ve state backend (dosya sistemi yerine Redis) yapılandırması kritik olur. Mono büyük kurulumlar için Redis state backend kullanır.