はじめに
開発者版は、ONLYOFFICE Docsをローカルサーバーにインストールし、オンラインエディタとWebアプリケーションを統合することができます。
ONLYOFFICE Docsは、テキスト、スプレッドシート、スライドのビューアとエディタからなるオンラインオフィススイートで、Office Open XMLフォーマットと完全な互換性を持っています。DOCX、XLSX、PPTXと完全に互換性があり、リアルタイムでの共同編集を可能にします。
機能概要
- ドキュメントエディタ
- 表計算エディタ
- スライドエディタ
- モバイルWebビューアー
- モバイルWebエディタ
- 共同編集
- ヒエログリフのサポート
- すべての一般的な形式をサポート:DOC, DOCX, TXT, ODT, RTF, ODP, EPUB, ODS, XLS, XLSX, CSV, PPTX, HTML
ONLYOFFICE Docs 開発者版の機能一覧をご覧ください。
このガイドでは、ONLYOFFICE Docs Developer Edition Linux版をあなたのマシンにインストールする方法を紹介します。
システム要件
- CPU:デュアルコア 2GHz以上
- RAM:2GB以上
- HDD:40GB以上の空き容量
- 追加要件:スワップ4GB以上
- OS:64-bit Debian, Ubuntu またはカーネルバージョン 3.13 以降の互換性のあるディストリビューション
- その他の要件:
- PostgreSQL: バージョン 12.9 以降
- NGINX: バージョン1.3.13またはそれ以降
- libstdc++6: バージョン 4.8.4 以降
- Redis
- RabbitMQ
ONLYOFFICE Docsのインストール
Debianベースのディストリビューションでのインストールは、システム内にlibstdc++6
、NGINX
、PostgreSQL
があることを必要とします。
これらのコンポーネントとその依存関係のインストールに必要なすべてのインストラクションは、それらの公式ウェブサイトで見つけることができます。
ONLYOFFICE Docsと一緒にインストールされる他の依存関係もあります。
- libcurl3
- libxml2
- supervisor
- fonts-dejavu
- fonts-liberation
- ttf-mscorefonts-installer
- fonts-crosextra-carlito
- fonts-takao-gothic
- fonts-opensymbol
これらの依存関係は、Ubuntu 14.04 LTS 以降を使用する場合、自動的にインストールされます。それ以前のディストリビューションでは、手動でインストールする必要がある場合があります。
依存関係のインストール
ONLYOFFICE Docsでは、NGINX
とデータベースにPostgreSQL
を利用しています。システムリポジトリにある依存関係は、ONLYOFFICE Docs のインストール時に apt-get install コマンドを使用して自動的にインストールされます。
PostgreSQLのインストールと設定:
Ubuntuのバージョンに含まれるPostgreSQLのバージョンをインストールします。
sudo apt-get install postgresql
PostgreSQLリポジトリから他のバージョンのPostgreSQLをインストールしたい場合は、PostgreSQLの公式ドキュメントを参照してください。
PostgreSQLがインストールされたら、PostgreSQLのデータベースとユーザを作成します。
データベースユーザはonlyofficeという名前である必要があります。パスワードは任意で指定可能です。
sudo -i -u postgres psql -c "CREATE DATABASE onlyoffice;" sudo -i -u postgres psql -c "CREATE USER onlyoffice WITH password 'onlyoffice';" sudo -i -u postgres psql -c "GRANT ALL privileges ON DATABASE onlyoffice TO onlyoffice;"
redisをインストールします。
sudo apt-get install redis-server
rabbitmqをインストールします。
sudo apt-get install rabbitmq-server
14.04 LTS 以前の Ubuntu ディストリビューションでは、他の依存パッケージのインストールが必要な場合があります。
Ubuntu 18.04 では、nginx-extras のインストールが必要です。これは、コマンドを使用して行います。
sudo apt-get install nginx-extras
ONLYOFFICE Docsのデフォルトポートを変更する
デフォルトでは、ONLYOFFICE Docsはポート80を使用して受信接続をリッスンします。バージョン4.3からは、ONLYOFFICE Docsをデフォルトのポートではなく、使用する予定であれば、ポートを変更することができます。
デフォルトのポートを変更する場合、そのポートが着信/発信接続のために開いていることを確認してください。ONLYOFFICE Docsで使用されるすべてのポートのリストを参照してください。
これを行うには、コマンドを実行して、debconfシステムのデフォルトポートを変更する必要があります。
echo onlyoffice-documentserver-de onlyoffice/ds-port select <PORT_NUMBER> | sudo debconf-set-selections
上記コマンドの<PORT_NUMBER>
の代わりにポート番号を記述してください。
ご注意: ONLYOFFICE DocsのプロトコルをHTTPSに変更する場合は、ポートを443に変更せず、こちらのガイドを使用してください。
ONLYOFFICE Docsのインストールに使用できる追加オプションがあります。
その後、ONLYOFFICE Docsのインストールを続けることができます。
ONLYOFFICE Docsのインストール
GPGキーを追加します。
mkdir -p ~/.gnupg chmod 700 ~/.gnupg gpg --no-default-keyring --keyring gnupg-ring:/tmp/onlyoffice.gpg --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys CB2DE8E5 chmod 644 /tmp/onlyoffice.gpg sudo chown root:root /tmp/onlyoffice.gpg sudo mv /tmp/onlyoffice.gpg /etc/apt/trusted.gpg.d/
ONLYOFFICE Docsレポジトリを追加します。
echo "deb https://download.onlyoffice.com/repo/debian squeeze main" | sudo tee /etc/apt/sources.list.d/onlyoffice.list
APTパッケージはDebian Squeezeに対してビルドされていますが、多くのDebian派生版(Ubuntuを含む)と互換性があり、これらのディストリビューションすべてで同じリポジトリを使用できることを意味します。
DebianにONLYOFFICE Docsをインストールする場合、/etc/apt/sources.list
にcontrib
コンポーネントを追加してください。より詳しく知りたい場合は、Debianのドキュメントを参照してください。
パッケージマネージャのキャッシュを更新してください。
sudo apt-get update
mscorefonts
をインストールします。
sudo apt-get install ttf-mscorefonts-installer
ONLYOFFICE Docsをインストールします。
sudo apt-get install onlyoffice-documentserver-de
インストール時に、PostgreSQLのユーザ
onlyoffice
のパスワードの入力を要求されます。PostgreSQLの設定時に指定したonlyoffice
のパスワードを入力してください。
その後、ONLYOFFICE Docsはプロセスとして実行されます。パッケージは他のdebパッケージと同様に更新されます。
ここで、ブラウザのアドレスバーにhttp://localhost を入力すると、ONLYOFFICE Docsのウェルカムページが開きます。そこには、提供されているAPIを使ってドキュメントサンプルを有効にしたり、オンラインエディタをあなたのウェブアプリケーションに統合する方法について、さらなる説明が記載されています。
HTTPSを使用してONLYOFFICE Docsを実行する
ほとんどの場合、HTTPSプロトコル経由でポータルにアクセスすることは、デフォルトで使用されているHTTP経由よりもはるかに安全です。セキュアな接続を使用してONLYOFFICE Docsを簡単に実行することができます。これを行う方法の詳細については、こちらをご覧ください。
開発者版のバージョン登録
開発者版を購入し、license.licファイルを受け取った場合、それをインストールすることで、ソフトウェアの製品版を入手することができます。
DebianベースのLinuxディストリビューションユーザーの場合、license.licファイルは以下のフォルダに配置されます。
/var/www/onlyoffice/Data/license.lic
その後、あなた開発者版のバージョンは登録され、フル機能を持つようになります。
追加情報:ONLYOFFICE Docsのインストールにおけるより多くのオプション
ONLYOFFICE Docsのインストールでは、より多くのdebconfオプションを使用することができ、複数のサーバーへのインストールを計画している場合、あるいは他のケースで非常に役に立つかもしれません。
これらのオプションは以下の通りです。
PostgreSQL データベースオプション
- PostgreSQLデータベースのホストアドレスを設定します(
<DB_HOST>
をインストールされたPostgreSQLサーバの実際のアドレスに置き換えてください)
- PostgreSQLデータベースのホストアドレスを設定します(
echo onlyoffice-documentserver-de onlyoffice/db-host string <DB_HOST> | sudo debconf-set-selections
- PostgreSQLデータベースのユーザー名を設定します(
<DB_USER>
を適切なPostgreSQLデータベース権限を持つユーザーの実際の名前に置き換えます)
- PostgreSQLデータベースのユーザー名を設定します(
echo onlyoffice-documentserver-de onlyoffice/db-user string <DB_USER> | sudo debconf-set-selections
- PostgreSQLデータベースユーザーのパスワードを設定します(
<DB_PASSWORD>
を適切なPostgreSQLデータベース権限を持つユーザーの実際のパスワードに置き換えてください)
- PostgreSQLデータベースユーザーのパスワードを設定します(
echo onlyoffice-documentserver-de onlyoffice/db-pwd password <DB_PASSWORD> | debconf-set-selections
- PostgreSQLデータベース名を設定します(
<DB_NAME>
を実際のPostgreSQLデータベース名に置き換えてください)
- PostgreSQLデータベース名を設定します(
echo onlyoffice-documentserver-de onlyoffice/db-name string <DB_NAME> | sudo debconf-set-selections
- Redisオプション
- Redisのホストアドレスを設定します(
<REDIS_HOST>
を実際にインストールされているRedisのアドレスに置き換えてください)
- Redisのホストアドレスを設定します(
echo onlyoffice-documentserver-de onlyoffice/redis-host string <REDIS_HOST> | sudo debconf-set-selections
- RabbitMQのオプション
- RabbitMQのホストアドレスを設定します(
<RABBITMQ_HOST>
を実際にインストールされているRabbitMQのアドレスに置き換えてください)
- RabbitMQのホストアドレスを設定します(
echo onlyoffice-documentserver-de onlyoffice/rabbitmq-host string <RABBITMQ_HOST> | sudo debconf-set-selections
- RabbitMQユーザ名を設定します(
<RABBITMQ_USER>
を適切なRabbitMQ権限を持つユーザの実際の名前に置き換えます)
- RabbitMQユーザ名を設定します(
echo onlyoffice-documentserver-de onlyoffice/rabbitmq-user string <RABBITMQ_USER> | sudo debconf-set-selections
- RabbitMQユーザのパスワードを設定します(
<RABBITMQ_PWD>
を、適切なRabbitMQ権限を持つユーザの実際のパスワードに置き換えます)
- RabbitMQユーザのパスワードを設定します(
echo onlyoffice-documentserver-de onlyoffice/rabbitmq-pwd password <RABBITMQ_PWD> | sudo debconf-set-selections
- JWTオプション
ONLYOFFICE Docsのアップデート後に、debconf-set-selections
を使用して、local.jsonファイルのカスタム値の上書きを無効にすることが可能です。
- JSON Web Tokens (JWT) を有効にします
echo onlyoffice-documentserver-de onlyoffice/jwt-enabled boolean true | sudo debconf-set-selections
<JWT_SECRET>
を自分の値に置き換えて、JWTシクレットキーを設定します。
echo onlyoffice-documentserver-de onlyoffice/jwt-secret password <JWT_SECRET> | sudo debconf-set-selections