Ana içeriğe geç

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

  1. Tarayıcınızı açın ve webpanel etiketinden gelen bağlantıya gidin;
  2. ONLYOFFICE hoş geldiniz sayfasını görmelisiniz:

  3. 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:

docker ps
İ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'
Varsayılan olarak, 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:

  1. Yapılandırmanın yedeğini oluşturun:
docker exec onlyoffice-docs cp /etc/onlyoffice/documentserver/local.json /etc/onlyoffice/documentserver/local.json.backup
  1. Sadece ONLYOFFICE konteynerine giriş yapın:

docker exec -it onlyoffice-docs /bin/bash
3. Yapılandırma dosyasını düzenleyin:

nano /etc/onlyoffice/documentserver/local.json
4. 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"
  }
}
5. Dosyayı kaydedip düzenleyiciyi kapatın (Ctrl+X, ardından Y ve sonra Enter); 6. Değişiklikleri uygulamak için konteyneri yeniden başlatın:

docker restart onlyoffice-docs
7. Hizmetin doğru şekilde başladığını kontrol edin:

docker logs onlyoffice-docs --tail 100

İ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:

sudo docker exec e32700b1ac75 sudo supervisorctl start ds:example
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
Komutları yaptıktan sonra:

  1. Tarayıcınızda açın: https://your-domain/welcome/;
  2. Düzenleyici örneklerini gösteren bir sayfa görürsünüz;
  3. 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.