ONLYOFFICE¶
Bu makalede:
Bilgi
ONLYOFFICE, belgeleri birlikte düzenlemek için açık kaynaklı bir ofis paketidir. Metin belgesi, elektronik tablo ve sunum editörlerini içerir; bunlar aynı anda birden fazla kullanıcı tarafından işbirliği yapılabilir. Bir ONLYOFFICE sunucusu, kurumsal takımlar, eğitim kurumları ve güvenli bir ofis çözümüne ihtiyaç duyan organizasyonlar için uygundur.
ONLYOFFICE. Özellikler¶
- Gerçek Zamanlı Belgeler Düzenleme: DOCX, XLSX, PPTX için tam özellikli editörler; işbirlikçi düzenleme yetenekleriyle;
- Microsoft Office Biçimleri ile Uyumluluk: MS Office biçimleri tam destekle, karmaşık biçimlendirme dahil;
- İşbirlikçi Düzenleme: Aynı anda birden fazla kullanıcı tarafından belge düzenlemesi; değişiklik takibi;
- Yorumlar ve Sohbet İçeren Belgeler: Editör arayüzünde doğrudan belgeler hakkında konuşmak için araçlar;
- Versiyon Kontrolü: Değişiklik geçmişi takibi; önceki versiyona geri dönme yeteneği;
- Eklentiler ve Entegrasyonlar: Popüler depolama sistemleriyle entegrasyon yoluyla işlevselliği genişletmek için eklentiler;
- Güvenlik: API'yi korumak ve veri iletiminde şifrelemeyi destekleme için JWT tokenları;
- Geliştiriciler İçin API: Kendi uygulamalarınıza entegre etmek için REST API;
- Mobil Desteği: Tabletler ve akıllı telefonlar için uyumlu arayüz.
Çalıştırma Özellikleri¶
| ID | Uyumlu OS | VM | BM | VGPU | GPU | Min CPU (Çekirdekler) | Min RAM (GB) | Min HDD/SSD (GB) | Aktif |
|---|---|---|---|---|---|---|---|---|---|
| 375 | Ubuntu 22.04 | + | + | - | - | 2 | 8 | 40 | SİPARİŞ VER |
- Konteyner tabanlı dağıtım - Sistemi Docker ile birlikte gelen önceden yapılandırılmış konteynerlerle hızlı kurulum için;
- Ana Konteynerler:
onlyoffice-docs- ana ONLYOFFICE konteyneri;nginx-nginx-1- Certbot (jonasal/nginx-certbot:latest) ile SSL desteği olan Nginx web sunucusu.
- Ağ Yapılandırması:
- Harici Bağlantı Noktaları: 80 (HTTP), 443 (HTTPS);
- İç ONLYOFFICE Bağlantı Noktası: 8080 (ana bilgisayara: 0.0.0.0:8080->80/tcp olarak yönlendirilmiş);
- Let's Encrypt aracılığıyla SSL sertifikalarının otomatik edinimi.
- Ana Dizinler:
/etc/onlyoffice- ONLYOFFICE konteyneri içindeki yapılandırma dosyaları;/var/lib/onlyoffice- uygulama verileri;/var/log/onlyoffice- sistem işletim günlükleri;/var/www/onlyoffice- web uygulamasının kök dizini;/var/www/onlyoffice/documentserver- ana Document Server dizini.
Not
Aksi belirtilmedikçe, varsayılan olarak yalnızca resmi proje deposundan gelen OnlyOffice Document Server'ın en son kararlı sürümü kurulur.
Yalnızca ONLYOFFICE Dağıttıktan Sonra Başlarken¶
Kayıt sırasında belirttiğiniz e-posta adresine yapılan ödeme sonrasında, sunucu hazır olduğuna dair bir bildirim gönderilecektir. Bu bildirimde VPS IP adresi ve bağlantı için kullanıcı adı ve şifre de bulunacaktır. Kuruluşumuzun müşterileri sunucu yönetim paneli ve API - Invapi aracılığıyla ekipmanlarını yönetir.
- ONLYOFFICE web arayüzüne erişim için bağlantı: sunucu kontrol panelinde bilgi >> etiketler sekmesinde webpanel etiketi;
- Sunucuyu yönetmek için Kullanıcı Adı ve Şifre: sunucu teslimatında e-posta yoluyla gönderilir.
Web Arayüzüne Erişim¶
ONLYOFFICE İşlevselliğini Kontrol Etme¶
- Tarayıcınızı açın ve webpanel etiketinden gelen bağlantıya gidin;
-
ONLYOFFICE hoş geldiniz sayfasını görmelisiniz:

-
Düzenleyici işlevselliğini kontrol etmek için, "Test İçin Örnekleri Aktifleştirme" bölümünde belirtilen dahili örnekleri kullanın.
Önemli
ONLYOFFICE, diğer sistemlere belge editörlerini entegre eden bir sunucu uygulamasıdır. Tam işlevselliği sağlamak için bir belge yönetim sistemi (Nextcloud, ownCloud vb.) ile entegrasyon veya test örnekleri kullanılmasını gerektirir.
Hizmet Durumunu Kontrol Etme¶
Konteynerlerin durumunu kontrol etmek için sunucuda aşağıdaki komutu çalıştırın:
İki çalışan konteyner görmelisiniz:CONTAINER ID IMAGE STATUS PORTS NAMES
527cd331a316 jonasal/nginx-certbot:latest Up 19 hours nginx-nginx-1
e32700b1ac75 onlyoffice/documentserver Up 19 hours 0.0.0.0:8080->80/tcp onlyoffice-docs
JWT Gizli Yapılandırma¶
Şu Anki JWT Gizlini Görüntüleme¶
JWT gizli, Document Server API'sini korumak için kullanılır. Mevcut değerini görüntülemek için:
sudo docker exec e32700b1ac75 /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json 'services.CoAuthoring.secret.session.string'
change_me olarak ayarlanmıştır. JWT Tokenların Yapısı¶
ONLYOFFICE, farklı amaçlar için üç tür JWT gizli kullanır:
secret.inbox.string- ONLYOFFICE'a dış sistemlerden gelen istekleri korumak için;secret.outbox.string- dış sistemlere yapılan istekleri korumak için ONLYOFFICE'tan çıkış yapmak için;secret.session.string- iç oturumlar ve bileşenler arasındaki etkileşimler için.
Güvenlik İçin Önemli
Varsayılan olarak, üç gizlinin de değeri change_me. Kurulumunuzun güvenliğini sağlamak için bunları benzersiz değerlere değiştirmenizi şiddetle tavsiye ediyoruz.
JWT Gizli Değerlerini Değiştirme¶
JWT gizli değerlerini değiştirmek için aşağıdaki adımları izleyin:
- Yapılandırmanın yedeğini oluşturun:
docker exec onlyoffice-docs cp /etc/onlyoffice/documentserver/local.json /etc/onlyoffice/documentserver/local.json.backup
- Sadece ONLYOFFICE konteynerine giriş yapın:
services.CoAuthoring.secret bölümünü bulun ve değerleri değiştirin: "secret": {
"inbox": {
"string": "dışa gelen istekler için benzersiz gizli"
},
"outbox": {
"string": "çıkışta dış sistemlere yapılan istekler için benzersiz gizli"
},
"session": {
"string": "oturumlar ve etkileşimler için benzersiz gizli"
}
}
Ctrl+X, ardından Y ve sonra Enter); 6. Değişiklikleri uygulamak için konteyneri yeniden başlatın: 7. Hizmetin doğru şekilde başladığını kontrol edin: İpucu
- JWT gizli oluşturmak için güvenilir bir şifre jeneratörü kullanın. Önerilen uzunluk en az 32 karakterdir;
- Bu komutla rastgele bir gizli oluşturabilirsiniz:
openssl rand -base64 32; - ONLYOFFICE'ı harici bir sistemle entegre ediyorsanız, iki sisteminde aynı gizliyi kullanın.
Test İçin Örnekleri Aktifleştirme¶
ONLYOFFICE, belge editörlerini test etmek için dahili örnekler içerir. Varsayılan olarak devre dışı bırakılmışlardır.
Örnekleri Etkinleştirme¶
Test örneklerini etkinleştirmek için aşağıdaki komutları çalıştırın:
Örnek hizmeti başlat:
Konteyner yeniden başladığında örneklerin otomatik olarak başlamasını yapılandır:sudo docker exec e32700b1ac75 sudo sed 's,autostart=false,autostart=true,' -i /etc/supervisor/conf.d/ds-example.conf
- Tarayıcınızda açın:
https://your-domain/welcome/; - Düzenleyici örneklerini gösteren bir sayfa görürsünüz;
- Herhangi bir belge türüne tıklayarak test edin:
- Document - metin belgeleri oluşturmak için;
- Spreadsheet - elektronik tablolar oluşturmak için;
- Presentation - sunumlar oluşturmak için;
- PDF form - PDF formlarıyla çalışmak için.

Not
Örnekler yalnızca test ve yetenek gösterimi amacıyla tasarlanmıştır. Üretim kullanımı için, Document Server'ın bir belge yönetim sistemi ile entegre edilmesi gerekir.
Not
Belirli sistemlerle entegrasyon hakkında ayrıntılı bilgi ONLYOFFICE resmi dokümantasyonunda bulunabilir.
API kullanarak ONLYOFFICE siparişi¶
Bu yazılımı API kullanarak kurmak için bu talimatları izleyin.
Bu sayfanın bazı içerikleri ya da yazıları AI tarafından oluşturulmuş veya çevrilmiş olabilir.