Ana içeriğe geç

ONLYOFFICE

Bu makalede

Bilgi

ONLYOFFICE, iş birliğine dayalı belge düzenleme için açık kaynaklı bir ofis paketidir. Eşzamanlı çok kullanıcılı iş birliğini destekleyen metin belgeleri, e-tablolar ve sunumlar için düzenleyiciler içerir. Bir ONLYOFFICE sunucusu; kurumsal ekipler, eğitim kurumları ve güvenli bir ofis çözümüne ihtiyaç duyan kuruluşlar için uygundur.

ONLYOFFICE. Temel Özellikler

  • Gerçek Zamanlı Belge Düzenleme: Iş birliğine dayalı düzenleme yeteneklerine sahip DOCX, XLSX, PPTX için tam özellikli düzenleyiciler;
  • Microsoft Office Formatlarıyla Uyumluluk: Karmaşık biçimlendirmeler dahil olmak üzere MS Office formatları için tam destek;
  • Iş Birliğine Dayalı Düzenleme: Değişiklik takibi ile birden fazla kullanıcı tarafından eşzamanlı belge düzenleme;
  • Gömülü Yorumlar ve Sohbet: Düzenleyici arayüzü içinde belgeleri tartışmak için araçlar;
  • Sürüm Kontrolü: Önceki sürümlere geri dönme yeteneği ile değişiklik geçmişinin takibi;
  • Eklentiler ve Entegrasyonlar: Eklentiler ve popüler depolama sistemleriyle entegrasyon yoluyla işlevselliğin genişletilmesi;
  • Güvenlik: API'yi korumak ve iletim sırasında veri şifreleme için JWT token desteği;
  • Geliştiriciler için API: Özel uygulamalarla entegrasyon için REST API;
  • Mobil Destek: Tabletler ve akıllı telefonlar için adaptif arayüz.

Çalıştırma Özellikleri

ID Yazılım Adı Uyumlu OS VM BM VGPU GPU Min CPU (Çekirdekler) Min RAM (GB) Min HDD/SSD (GB) Özel Alan Adı Aktif
365 ONLYOFFICE Docs Ubuntu 24.04 + + - - 2 4 20 Hayır SIPARIŞ VER

Not

Aksi belirtilmedikçe, resmi proje deposundan gelen en güncel kararlı OnlyOffice Document Server sürümü varsayılan olarak yüklenir.

ONLYOFFICE Kurulumundan Sonra Başlangıç

Kayıt sırasında belirtilen e-posta adresine ödeme yapıldıktan sonra, sunucunun hazır olduğuna dair bir bildirim gönderilecektir. Bu bildirim, VPS IP adresinin yanı sıra bağlantı için kullanıcı adı ve şifreyi içerecektir. Şirketimizin müşterileri, ekipmanlarını server management panel and API — Invapi üzerinden yönetebilirler.

Yetkilendirme verileri, sunucu kontrol panelindeki Information >> Tags sekmesinde veya gönderilen e-postada bulunabilir:

  • ONLYOFFICE web arayüzü paneline erişim bağlantısı: webpanel etiketi içindedir;
  • Sunucu yönetimi için Login ve Password: Sunucu teslimatında e-posta ile gönderilir.

Web Arayüzüne Erişim

ONLYOFFICE Işlevselliğini Kontrol Etme

  1. Bir web tarayıcısı açın ve webpanel etiketindeki bağlantıya gidin;
  2. ONLYOFFICE karşılama sayfasını görmelisiniz:

  3. Düzenleyici işlevselliğini kontrol etmek için yerleşik örnekleri kullanın (bkz. "Test Için Örnekleri Etkinleştirme" bölümü).

Dikkat

ONLYOFFICE, belge düzenleyicilerini diğer sistemlere entegre etmek için bir sunucu uygulamasıdır. Tam işlevsellik, bir belge yönetim sistemi (Nextcloud, ownCloud vb.) ile entegrasyon veya test örneklerinin kullanılmasını gerektirir.

Servis Durumunu Kontrol Etme

Konteynerlerin durumunu kontrol etmek için sunucuda şu komutu çalıştırın:

docker ps
Çalışan iki 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 Secret Yapılandırması

Mevcut JWT Secret Değerini Görüntüleme

JWT secret, 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 şu şekildedir: change_me

JWT Token Yapısı

ONLYOFFICE, farklı amaçlar için üç tür JWT secret kullanır:

  • secret.inbox.string - harici sistemlerden ONLYOFFICE'e gelen istekler için;
  • secret.outbox.string - ONLYOFFICE'den harici sistemlere giden istekler için;
  • secret.session.string - dahili oturumlar ve bileşenler arası etkileşimler için.

Güvenlik Için Önemli

Varsayılan olarak her üç secret da change_me değerine sahiptir. Kurulumunuzun güvenliğini sağlamak için bunları benzersiz değerlerle değiştirmeniz şiddetle tavsiye edilir.

JWT Secret Değiştirme

JWT secret'ları değiştirmek için şu 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
    
  2. 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": "your_unique_secret_for_incoming_requests"
      },
      "outbox": {
        "string": "your_unique_secret_for_outgoing_requests"
      },
      "session": {
        "string": "your_unique_secret_for_sessions"
      }
    }
    
  5. Dosyayı kaydedin ve düzenleyiciden çıkın (Ctrl+X, ardından Y, ardından Enter);
  6. Değişiklikleri uygulamak için konteyneri yeniden başlatın:
    docker restart onlyoffice-docs
    
  7. Servisin doğru şekilde başladığını kontrol edin:
    docker logs onlyoffice-docs --tail 100
    

Ipucu

  • JWT secret oluşturmak için güvenilir bir şifre oluşturucu kullanın. Önerilen uzunluk en az 32 karakterdir;
  • Rastgele bir secret oluşturmak için bu komutu kullanabilirsiniz: openssl rand -base64 32;
  • ONLYOFFICE'i harici bir sistemle entegre ediyorsanız, her iki sistemde de aynı secret'ı kullanın.

Test Için Örnekleri Etkinleştirme

ONLYOFFICE, belge düzenleyicilerini test etmek için yerleşik örnekler içerir. Bunlar varsayılan olarak devre dışıdır.

Örnekleri Aktifleştirme

Test örneklerini etkinleştirmek için aşağıdaki komutları çalıştırın:

Örnek servisini başlatın:

sudo docker exec e32700b1ac75 sudo supervisorctl start ds:example
Konteyner açılışında örneklerin otomatik başlatılmasını yapılandırın:

sudo docker exec e32700b1ac75 sudo sed 's,autostart=false,autostart=true,' -i /etc/supervisor/conf.d/ds-example.conf
Komutlar çalıştırıldıktan sonra:

  1. Tarayıcıda açın: https://your-domain/welcome/;
  2. Düzenleyici örneklerinin olduğu bir sayfa göreceksiniz;
  3. Test etmek için herhangi bir belge türüne tıklayın:
    • Document - metin belgeleri oluşturmak için;
    • Spreadsheet - e-tablolar oluşturmak için;
    • Presentation - sunumlar oluşturmak için;
    • PDF form - PDF formları ile çalışmak için.

Not

Örnekler yalnızca test ve yeteneklerin gösterimi amaçlıdır. Verimli kullanım için Document Server'ı bir belge yönetim sistemi ile entegre edin.

Not

Belirli sistemlerle entegrasyon hakkında ayrıntılı bilgi ONLYOFFICE resmi dokümantasyonunda mevcuttur.

API Kullanarak ONLYOFFICE Sunucusu Sipariş Etme

Bu yazılımı API kullanarak yüklemek için bu talimatları izleyin.