Ana içeriğe geç

ONLYOFFICE Docs'u CentOS ve türevlerine kurma

Giriş​

Community Edition, ONLYOFFICE Docs'u yerel sunucunuza kurmanıza ve çevrimiçi editörleri ONLYOFFICE ortak çalışma platformu veya diğer popüler sistemlerle entegre etmenize olanak tanır. Böylece dosyaları paylaşabilir, erişim haklarını yönetebilir, belgeleri bir web sitesine gömebilir ve ONLYOFFICE'a bağlı Drive, Box, Dropbox, OneDrive veya ownCloud üzerinde saklanan dosyaları düzenleyebilirsiniz (özelliklerin ayrıntılı listesine bakın). Bu kılavuz, ONLYOFFICE Docs Community Edition Linux sürümünü makinenize nasıl kuracağınızı gösterir.

Sistem gereksinimleri​

  • CPU: çift çekirdekli 2 GHz veya daha iyi
  • RAM: en az 2 GB, ancak ana bilgisayar işletim sistemine bağlıdır. Daha fazlası daha iyidir
  • HDD: en az 40 GB boş alan
  • SWAP: en az 4 GB, ancak ana bilgisayar işletim sistemine bağlıdır. Daha fazlası daha iyidir
  • OS: CentOS Stream 9, RHEL 8 veya RHEL 9
  • Ek gereksinimler
    • NGINX: sürüm 1.30 veya üzeri

Bağımlılıkları kurma​

NGINX paketinin güncel sürümünü kurma​

RHEL/CentOS için yum deposunu ayarlamak üzere, /etc/yum.repos.d/nginx.repo adlı dosyayı aşağıdaki içerikle oluşturun:

[nginx-stable]
name=nginx stable repo
baseurl=http://nginx.org/packages/centos/$releasever/$basearch/
gpgcheck=1
enabled=1
gpgkey=https://nginx.org/keys/nginx_signing.key
[nginx-mainline]
name=nginx mainline repo
baseurl=http://nginx.org/packages/mainline/centos/$releasever/$basearch/
gpgcheck=1
enabled=0
gpgkey=https://nginx.org/keys/nginx_signing.key

Resmi talimat

NGINX'i kurun:

sudo yum install nginx

Ardından /etc/nginx/nginx.conf NGINX yapılandırma dosyasını aşağıdaki gibi görünecek şekilde düzenleyin:

user                  nginx;
worker_processes      1;
error_log             /var/log/nginx/error.log warn;
pid                   /var/run/nginx.pid;
events {
  worker_connections  1024;
}
http {
  include             /etc/nginx/mime.types;
  default_type        application/octet-stream;
  log_format          main  '$remote_addr - $remote_user [$time_local] "$request" '
                            '$status $body_bytes_sent "$http_referer" '
                            '"$http_user_agent" "$http_x_forwarded_for"';
  access_log          /var/log/nginx/access.log  main;
  sendfile            on;
  #tcp_nopush         on;
  keepalive_timeout   65;
  #gzip               on;
  include             /etc/nginx/conf.d/*.conf;
}
Önemli

ONLYOFFICE Docs'u 80 numaralı bağlantı noktasında çalıştırmayı planlıyorsanız, varsayılan NGINX web sitesini şimdi devre dışı bırakın. Aksi halde ONLYOFFICE Docs doğru çalışmayabilir. Bunun için aşağıdaki komutları çalıştırın:

sudo mv -f /etc/nginx/sites-enabled/default /etc/nginx/sites-available/default.disabled
sudo mv -f /etc/nginx/conf.d/default.conf /etc/nginx/conf.d/default.conf.disabled
sudo systemctl is-active --quiet nginx && sudo systemctl reload nginx || sudo systemctl start nginx

NGINX'in nasıl kurulduğuna bağlı olarak, ilk iki komuttan biri dosyanın bulunmadığını bildirebilir. Bu mesajı güvenle yok sayabilirsiniz.

EPEL deposunu kurma​

sudo yum install epel-release

CentOS 9'a EPEL kurmak için aşağıdaki komutları kullanın:

sudo yum config-manager --set-enabled crb
sudo yum install epel-release epel-next-release

RHEL'e EPEL kurmak için aşağıdaki komutları kullanın:

sudo subscription-manager repos --enable codeready-builder-for-rhel-$REV-$(arch)-rpms
sudo yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-$REV.noarch.rpm

$REV değerini işletim sisteminizin sürümüyle elle değiştirin (7.x sürümleri için 7, 8.x sürümleri için 8, 9.x sürümleri için 9 vb.).

ONLYOFFICE Docs deposunu ekleme​

Aşağıdaki komutla ONLYOFFICE Docs yum deposunu ekleyin:

sudo yum install https://download.onlyoffice.com/repo/centos/main/noarch/onlyoffice-repo.noarch.rpm

mscorefonts'u kurma​

cabextract ve xorg-x11-font-utils paketlerini kurun:

sudo yum install cabextract xorg-x11-font-utils

CentOS 7.8(2003) için fontconfig de gereklidir:

sudo yum install fontconfig

msttcore yazı tipleri paketini kurun:

sudo rpm -i https://sourceforge.net/projects/mscorefonts2/files/rpms/msttcore-fonts-installer-2.6-1.noarch.rpm

ONLYOFFICE Docs'u kurma​

Community sürümü için aşağıdaki komutu çalıştırın:

sudo yum install onlyoffice-documentserver

nginx hizmetini başlatın ve sistem açılışında başlamasını etkinleştirin:

sudo service nginx start
sudo systemctl enable nginx

Bundan sonra ONLYOFFICE Docs bir işlem olarak çalışacaktır. Paket, diğer rpm paketleri gibi güncellenecektir.

ONLYOFFICE Docs'u güncelleme​

ONLYOFFICE Docs'u güncellemek için aşağıdaki komutu çalıştırın:

sudo yum update onlyoffice-documentserver
Önemli

RHEL 8 ve türevlerinde, ONLYOFFICE deposu etkinken yum update çalıştırmak bir bağımlılık hatasıyla başarısız olabilir.

Bunu önlemek için, bu paketlerin sistem AppStream deposundan alınması amacıyla onları ONLYOFFICE deposundan hariç tutun:

echo "excludepkgs=xorg-x11-server-Xvfb,xorg-x11-server-common" >> /etc/yum.repos.d/onlyoffice.repo

Bu komutu yalnızca bir kez çalıştırmanız yeterlidir. Bundan sonra yum update beklendiği gibi çalışacaktır.

ONLYOFFICE Docs'u OneClick Install ile kurduysanız, bu hariç tutma zaten otomatik olarak uygulanmıştır.

ONLYOFFICE Docs varsayılan bağlantı noktasını değiştirme​

Varsayılan olarak ONLYOFFICE Docs gelen bağlantıları 8083 numaralı bağlantı noktasından dinler. 4.3 sürümünden itibaren varsayılan bağlantı noktası yerine başka bir bağlantı noktası kullanmayı planlıyorsanız ONLYOFFICE Docs için bağlantı noktasını değiştirebilirsiniz.

not

Varsayılan bağlantı noktasını değiştirecekseniz, bağlantı noktasının gelen/giden bağlantılara açık olduğundan emin olun. ONLYOFFICE Docs tarafından kullanılan bağlantı noktalarının tam listesine bakın.

Bunun için aşağıdaki komutu çalıştırarak DS_PORT ortam değişkenini düzenlemeniz gerekir:

export DS_PORT=<PORT_NUMBER>

Yukarıdaki komutta <PORT_NUMBER> yerine bağlantı noktası numarasını yazın.

not

Bağlantı noktasını 80 olarak ayarlarsanız, varsayılan NGINX web sitesini NGINX paketinin güncel sürümünü kurma bölümünde açıklandığı gibi devre dışı bıraktığınızdan emin olun.

Uyarı

ONLYOFFICE Docs protokolünü HTTPS olarak değiştirmek istiyorsanız, bağlantı noktasını 443 olarak değiştirmeyin; bunun yerine bu talimatı kullanın.

Bundan sonra ONLYOFFICE Docs'u yapılandırmaya devam edebilirsiniz.

ONLYOFFICE Docs'u yapılandırma​

Yapılandırma betiğini çalıştırma​

documentserver-configure betiğini çalıştırın:

bash documentserver-configure

Güvenlik duvarı istisnası ekleme​

sudo firewall-cmd --zone=public --add-port=8083/tcp --permanent
sudo firewall-cmd --reload

SELinux'u devre dışı bırakma​

not

v.5.0 sürümünden itibaren kullanım dışıdır

/etc/selinux/config dosyasını herhangi bir metin düzenleyiciyle açın, SELINUX=enforcing veya SELINUX=permissive satırını SELINUX=disabled ile değiştirin ve değişiklikleri kaydedin.

Değişikliklerin geçerli olması için sunucunuzu yeniden başlatın.

Not

Güvenlik nedeniyle, v8.1 sürümünden itibaren documentserver-configure betiği çalıştırıldığında local.json dosyasında yeni WOPI anahtarları oluşturulur. WOPI bağlantısı kullanıyorsanız, ONLYOFFICE Docs'u güncelledikten sonra betiği çalıştırmanız gerekir:

documentserver-configure --wopienabled true

ONLYOFFICE Docs'u tarayıcıda başlatma​

Yapılandırma tamamlandıktan sonra, ONLYOFFICE Docs karşılama sayfasını açmak için tarayıcınızın adres çubuğuna http://localhost:8083 yazabilirsiniz. Bu sayfada belge örneklerini nasıl etkinleştireceğinize veya çevrimiçi editörleri sağlanan API ile web uygulamanıza nasıl entegre edeceğinize dair ek talimatları bulacaksınız.

ONLYOFFICE Docs'u ONLYOFFICE Workspace'e bağlamak için bu talimata bakın.