メインコンテンツまでスキップ

CentOSおよび派生版にONLYOFFICE Docsをインストールする

はじめに​

コミュニティ版では、ONLYOFFICE Docsをローカルサーバーにインストールし、ONLYOFFICEコラボレーションプラットフォームや他の人気システムとオンラインエディターを統合して、ファイルの共有、アクセス権の管理、ウェブサイトへのドキュメントの埋め込み、ONLYOFFICEに接続されたDrive、Box、Dropbox、OneDrive、ownCloudに保存されたファイルの編集を行うことができます（詳細な機能リストをご覧ください）。このガイドでは、ONLYOFFICE Docs コミュニティ版のLinuxバージョンをマシンにインストールする方法を説明します。

システム要件​

  • CPU：デュアルコア 2 GHz以上
  • RAM：最低2 GB、ただしホストOSに依存。多いほど良い
  • HDD：最低40 GBの空き容量
  • SWAP：最低4 GB、ただしホストOSに依存。多いほど良い
  • OS：CentOS Stream 9、RHEL 8、またはRHEL 9
  • 追加要件
    • NGINX：バージョン1.30以上

依存関係のインストール​

最新のNGINXパッケージバージョンのインストール​

RHEL/CentOS用のyumリポジトリを設定するには、/etc/yum.repos.d/nginx.repoという名前のファイルを作成し、次の内容を記述します：

[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

公式インストラクション

NGINXをインストールします：

sudo yum install nginx

その後、/etc/nginx/nginx.confのNGINX設定ファイルを編集し、次のようにします：

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;
}
重要

ONLYOFFICE Docsをポート80で実行する予定の場合は、ここでNGINXのデフォルトWebサイトを無効にしてください。無効にしないと、ONLYOFFICE Docsが正しく動作しない可能性があります。そのためには、次のコマンドを実行します：

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のインストール方法によっては、最初の2つのコマンドのいずれかでファイルが存在しないと表示される場合があります。このメッセージは無視してかまいません。

EPELリポジトリのインストール​

sudo yum install epel-release

CentOS 9にEPELをインストールするには、次のコマンドを使用します：

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

RHELにEPELをインストールするには、次のコマンドを使用します：

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を手動でOSバージョンに変更します（バージョン7.xの場合は7、8.xの場合は8、9.xの場合は9など）。

ONLYOFFICE Docsリポジトリの追加​

次のコマンドでyum ONLYOFFICE Docsリポジトリを追加します：

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

mscorefontsのインストール​

cabextractとxorg-x11-font-utilsパッケージをインストールします：

sudo yum install cabextract xorg-x11-font-utils

CentOS 7.8(2003)では、fontconfigも必要です：

sudo yum install fontconfig

msttcoreフォントパッケージをインストールします：

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

ONLYOFFICE Docsのインストール​

コミュニティ版のために次のコマンドを実行します：

sudo yum install onlyoffice-documentserver

nginxサービスを開始し、起動時に自動的に開始するように設定します：

sudo service nginx start
sudo systemctl enable nginx

その後、ONLYOFFICE Docsはプロセスとして実行されます。パッケージは他のrpmパッケージと同様に更新されます。

ONLYOFFICE Docsの更新​

ONLYOFFICE Docsを更新するには、次のコマンドを実行します：

sudo yum update onlyoffice-documentserver
重要

RHEL 8およびその派生版では、ONLYOFFICEリポジトリが有効な状態でyum updateを実行すると、依存関係エラーで失敗する場合があります。

これを防ぐには、これらのパッケージをONLYOFFICEリポジトリから除外し、代わりにシステムのAppStreamリポジトリから取得されるようにします：

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

このコマンドは一度だけ実行する必要があります。その後、yum updateは正常に動作します。

OneClick InstallでONLYOFFICE Docsをインストールした場合、この除外はすでに自動的に適用されています。

デフォルトのONLYOFFICE Docsポートを変更する​

デフォルトでは、ONLYOFFICE Docsはポート8083を使用して受信接続をリッスンします。バージョン4.3以降、デフォルトのポートの代わりに使用する予定がある場合は、ONLYOFFICE Docsのポートを変更できます。

注記

デフォルトのポートを変更する場合は、受信/送信接続のためにポートが開いていることを確認してください。ONLYOFFICE Docsで使用されるポートの完全なリストを参照してください。

そのためには、次のコマンドを実行してDS_PORT環境変数を編集する必要があります：

export DS_PORT=<PORT_NUMBER>

上記のコマンドで<PORT_NUMBER>の代わりにポート番号を記入してください。

注記

ポートを80に設定する場合は、最新のNGINXパッケージバージョンのインストールセクションの説明に従ってNGINXのデフォルトWebサイトを無効にしていることを確認してください。

警告

ONLYOFFICE DocsのプロトコルをHTTPSに変更したい場合、ポートを443に変更せず、代わりにこの手順を使用してください。

その後、ONLYOFFICE Docsの設定を続行できます。

ONLYOFFICE Docsの設定​

設定スクリプトを実行する​

documentserver-configureスクリプトを実行します：

bash documentserver-configure

ファイアウォール例外を追加する​

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

SELinuxを無効にする​

注記

v.5.0以降非推奨

任意のテキストエディタを使用して/etc/selinux/configファイルを開き、SELINUX=enforcingまたはSELINUX=permissiveの文字列をSELINUX=disabledに置き換え、変更を保存します。

変更を有効にするためにサーバーを再起動してください。

注意

セキュリティ上の理由から、v8.1以降、documentserver-configureスクリプトの実行時に新しいWOPIキーがlocal.jsonで生成されます。WOPI接続を使用している場合、ONLYOFFICE Docsを更新した後にスクリプトを実行する必要があります：

documentserver-configure --wopienabled true

ブラウザでONLYOFFICE Docsを起動する​

設定が完了したら、ブラウザのアドレスバーにhttp://localhost:8083を入力してONLYOFFICE Docsのウェルカムページを開き、ドキュメントのサンプルを有効にする方法や、提供されたAPIを使用してオンラインエディターをウェブアプリケーションに統合する方法についてのさらなる指示を見つけてください。

ONLYOFFICE DocsをONLYOFFICE Workspaceに接続するには、この手順を参照してください。