Ana içeriğe geç

ONLYOFFICE Docs Developer Edition'ı Debian ve Ubuntu üzerine kurma

Giriş​

Developer Edition, ONLYOFFICE Docs'u yerel sunucunuza kurmanıza ve çevrimiçi editörleri web uygulamanızla entegre etmenize olanak tanır (özelliklerin ayrıntılı listesine bakın). Bu kılavuz, ONLYOFFICE Docs Developer Edition'ın 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 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 işletim sistemine bağlıdır. Daha fazlası daha iyidir
  • OS: 64 bit Debian, Ubuntu veya çekirdek sürümü 3.13 ya da üzeri olan diğer uyumlu dağıtımlar
  • Ek gereksinimler
    • PostgreSQL: 12.9 veya üzeri sürüm
    • NGINX: 1.3.13 veya üzeri sürüm
    • libstdc++6: 4.8.4 veya üzeri sürüm
    • Redis: 4 veya üzeri sürüm
    • RabbitMQ

ONLYOFFICE Docs'u kurma​

Debian tabanlı dağıtımlara kurulum için sistemde libstdc++6, NGINX ve PostgreSQL bulunması da gerekir.

Bu bileşenlerin ve bağımlılıklarının kurulumuna ilişkin tüm talimatları resmi web sitelerinde bulabilirsiniz.

ONLYOFFICE Docs ile birlikte kurulan başka bağımlılıklar da vardır:

  • libcurl3
  • libxml2
  • fonts-dejavu
  • fonts-liberation
  • ttf-mscorefonts-installer
  • fonts-crosextra-carlito
  • fonts-takao-gothic
  • fonts-opensymbol

Bu bağımlılıklar Ubuntu 14.04 LTS veya üzerini kullandığınızda otomatik olarak kurulur. Daha eski dağıtımlarda elle kurulmaları gerekebilir.

Bağımlılıkları kurma​

ONLYOFFICE Docs, veritabanı olarak NGINX ve PostgreSQL kullanır. Sistem deposunda bulunan bağımlılıklar, ONLYOFFICE Docs kurulumu sırasında apt-get install komutuyla otomatik olarak kurulur.

PostgreSQL'i kurma ve yapılandırma​

Ubuntu sürümünüzle birlikte gelen PostgreSQL sürümünü kurun:

sudo apt-get install postgresql
not

PostgreSQL Deposu'ndan başka bir PostgreSQL sürümü kurmak istiyorsanız ayrıntılar için resmi PostgreSQL belgelerine bakın.

PostgreSQL kurulduktan sonra PostgreSQL veritabanını ve kullanıcısını oluşturun:

not

Veritabanı kullanıcısının adı onlyoffice olmalıdır. Parola olarak istediğinizi belirleyebilirsiniz.

sudo -i -u postgres psql -c "CREATE USER onlyoffice WITH PASSWORD 'onlyoffice';"
sudo -i -u postgres psql -c "CREATE DATABASE onlyoffice OWNER onlyoffice;"

Redis'i kurma​

sudo apt-get install redis-server

RabbitMQ'yu kurma​

sudo apt-get install rabbitmq-server

NGINX'i kurma​

sudo apt-get install nginx
not

Ubuntu 18.04'te bunun yerine nginx-extras paketini kurun: sudo apt-get install nginx-extras

Ö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 takdirde ONLYOFFICE Docs düzgün ç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 iletiyi güvenle yok sayabilirsiniz.

not

14.04 LTS öncesi Ubuntu dağıtımlarında başka bağımlılıkların da kurulması gerekebilir.

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

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

not

Varsayılan bağlantı noktasını değiştirecekseniz, yeni 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 debconf sistemindeki varsayılan bağlantı noktasını aşağıdaki komutla değiştirmeniz gerekir:

echo onlyoffice-documentserver-de onlyoffice/ds-port select <PORT_NUMBER> | sudo debconf-set-selections

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'i 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 yapmayın, bunun yerine bu talimatı kullanın.

ONLYOFFICE Docs kurulumunda kullanılabilecek ek seçenekler de vardır. Bunlar hakkında daha fazla bilgi için bu bölümü okuyun.

Bundan sonra ONLYOFFICE Docs kurulumuna devam edebilirsiniz.

ONLYOFFICE Docs'u kurma​

GPG anahtarını ekleyin:

mkdir -p -m 700 ~/.gnupg
curl -fsSL https://download.onlyoffice.com/GPG-KEY-ONLYOFFICE | gpg --no-default-keyring --keyring gnupg-ring:/tmp/onlyoffice.gpg --import
chmod 644 /tmp/onlyoffice.gpg
sudo chown root:root /tmp/onlyoffice.gpg
sudo mv /tmp/onlyoffice.gpg /usr/share/keyrings/onlyoffice.gpg

ONLYOFFICE Docs deposunu ekleyin:

echo "deb [signed-by=/usr/share/keyrings/onlyoffice.gpg] https://download.onlyoffice.com/repo/debian squeeze main" | sudo tee /etc/apt/sources.list.d/onlyoffice.list
not

APT paketi Debian Squeeze'e göre derlenmiş olsa da Ubuntu dahil çok sayıda Debian türeviyle uyumludur. Bu nedenle aynı depoyu tüm bu dağıtımlarda kullanabilirsiniz.

ONLYOFFICE Docs'u Debian'a kurarken /etc/apt/sources.list dosyasına contrib bileşenini ekleyin. Daha fazla bilgi için Debian belgelerine bakabilirsiniz.

Paket yöneticisi önbelleğini güncelleyin:

sudo apt-get update

mscorefonts paketini kurun:

sudo apt-get install ttf-mscorefonts-installer

ONLYOFFICE Docs'u kurun:

sudo apt-get install onlyoffice-documentserver-de
not

Kurulum sırasında onlyoffice PostgreSQL kullanıcısı için bir parola girmeniz istenir. PostgreSQL'i yapılandırırken belirlediğiniz onlyoffice parolasını girin.

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

Artık tarayıcınızın adres çubuğuna http://localhost:8083 yazarak ONLYOFFICE Docs karşılama sayfasını açabilirsiniz. Bu sayfada, belge örneklerini etkinleştirme veya çevrimiçi editörleri sağlanan API ile web uygulamanıza entegre etme konusunda daha fazla talimat bulabilirsiniz.

ONLYOFFICE Docs'u HTTPS ile çalıştırma​

Çoğu durumda portala varsayılan olarak kullanılan HTTP yerine HTTPS protokolüyle erişmek çok daha güvenlidir. ONLYOFFICE Docs'u güvenli bağlantıyla kolayca çalıştırabilirsiniz. Bunun nasıl yapılacağını öğrenmek için ayrıntılara buradan bakın.

Developer Edition sürümünüzü kaydetme​

Developer Edition satın aldıysanız ve license.lic dosyasını aldıysanız, yazılımın tam sürümünü elde etmek için bu dosyayı kurulumunuza yerleştirebilirsiniz.

Debian tabanlı bir Linux dağıtımı kullanıyorsanız license.lic dosyası aşağıdaki klasöre yerleştirilir:

/var/www/onlyoffice/Data/license.lic

Bundan sonra Developer Edition sürümünüz kaydedilmiş ve tam işlevli olur.

Ek bilgi: ONLYOFFICE Docs kurulumu için diğer seçenekler​

ONLYOFFICE Docs kurulumunda daha fazla debconf seçeneği kullanılabilir. Bu seçenekler, kurulumu birden fazla sunucuya yapmayı planladığınızda veya başka durumlarda çok yararlı olabilir.

Bu seçenekler şunlardır:

  • PostgreSQL veritabanı seçenekleri

    • PostgreSQL veritabanı ana bilgisayar adresini ayarlayın (<DB_HOST> yerine kurulu PostgreSQL sunucusunun gerçek adresini yazın):

      echo onlyoffice-documentserver-de onlyoffice/db-host string <DB_HOST> | sudo debconf-set-selections

    • PostgreSQL veritabanı kullanıcı adını ayarlayın (<DB_USER> yerine ilgili PostgreSQL veritabanı haklarına sahip kullanıcının gerçek adını yazın):

      echo onlyoffice-documentserver-de onlyoffice/db-user string <DB_USER> | sudo debconf-set-selections

    • PostgreSQL veritabanı kullanıcı parolasını ayarlayın (<DB_PASSWORD> yerine ilgili PostgreSQL veritabanı haklarına sahip kullanıcının gerçek parolasını yazın):

      echo onlyoffice-documentserver-de onlyoffice/db-pwd password <DB_PASSWORD> | debconf-set-selections

    • PostgreSQL veritabanı adını ayarlayın (<DB_NAME> yerine gerçek PostgreSQL veritabanı adını yazın):

      echo onlyoffice-documentserver-de onlyoffice/db-name string <DB_NAME> | sudo debconf-set-selections

  • Redis seçenekleri

    • Redis ana bilgisayar adresini ayarlayın (<REDIS_HOST> yerine kurulu Redis'in gerçek adresini yazın):

      echo onlyoffice-documentserver-de onlyoffice/redis-host string <REDIS_HOST> | sudo debconf-set-selections

  • RabbitMQ seçenekleri

    • RabbitMQ ana bilgisayar adresini ayarlayın (<RABBITMQ_HOST> yerine kurulu RabbitMQ'nun gerçek adresini yazın):

      echo onlyoffice-documentserver-de onlyoffice/rabbitmq-host string <RABBITMQ_HOST> | sudo debconf-set-selections

    • RabbitMQ kullanıcı adını ayarlayın (<RABBITMQ_USER> yerine ilgili RabbitMQ haklarına sahip kullanıcının gerçek adını yazın):

      echo onlyoffice-documentserver-de onlyoffice/rabbitmq-user string <RABBITMQ_USER> | sudo debconf-set-selections

    • RabbitMQ kullanıcı parolasını ayarlayın (<RABBITMQ_PWD> yerine ilgili RabbitMQ haklarına sahip kullanıcının gerçek parolasını yazın):

      echo onlyoffice-documentserver-de onlyoffice/rabbitmq-pwd password <RABBITMQ_PWD> | sudo debconf-set-selections

  • JWT seçenekleri

    ONLYOFFICE Docs güncellendikten sonra local.json dosyasındaki özel değerlerin üzerine yazılmasını devre dışı bırakmak için debconf-set-selections komutunu kullanabilirsiniz.

    • JSON Web Token'ları (JWT) etkinleştirin:

      echo onlyoffice-documentserver-de onlyoffice/jwt-enabled boolean true | sudo debconf-set-selections

    • <JWT_SECRET> yerine kendi değerinizi yazarak bir JWT gizli anahtarı ayarlayın:

      echo onlyoffice-documentserver-de onlyoffice/jwt-secret password <JWT_SECRET> | sudo debconf-set-selections