64ビットARMアーキテクチャ向けONLYOFFICE Docsエンタープライズ版Dockerバージョンのインストール

システム要件

• CPU：64ビットARMプロセッサ
• RAM：4 GB以上
• HDD：少なくとも40 GBの空き容量
• SWAP：少なくとも4 GB、ただしホストOSに依存します。多いほうが良いです
• OS：arm64用のLinuxディストリビューション
• 追加要件
  • Docker：Dockerチームがサポートするバージョンのいずれか

certbotを使用してONLYOFFICE DocsをHTTPSに切り替える

certbotを使用してLet's Encrypt SSL証明書を自動的に取得することで、ONLYOFFICE DocsをHTTPSに切り替える最も簡単な方法です。

ポート80と443を指定し、変数に独自の値を設定してONLYOFFICE Docs Dockerコンテナを実行します：

sudo docker run -i -t -d -p 80:80 -p 443:443 --restart=always \
    -e LETS_ENCRYPT_DOMAIN=yourdomain.com -e LETS_ENCRYPT_MAIL=email@example.com -e JWT_SECRET=my_jwt_secret onlyoffice/documentserver-ee:latest

ここで：

• LETS_ENCRYPT_DOMAIN - 証明書に使用するドメイン名。
• LETS_ENCRYPT_MAIL - 登録および復旧連絡用のメール。

letsencrypt.orgのCAによって署名された証明書が自動的に生成され、サーバーにインストールされます。これで、ONLYOFFICE Docsはhttps://yourdomain.comで利用可能になります。

自己署名証明書の生成

自己署名SSL証明書の生成は、簡単な3ステップの手順で行います。

ステップ 1：サーバーの秘密鍵を作成

openssl genrsa -out onlyoffice.key 2048

ステップ 2：証明書署名要求（CSR）を作成

openssl req -new -key onlyoffice.key -out onlyoffice.csr

ステップ 3：秘密鍵とCSRを使って証明書に署名

openssl x509 -req -days 365 -in onlyoffice.csr -signkey onlyoffice.key -out onlyoffice.crt

これで、365日有効なSSL証明書が生成されました。

サーバーセキュリティの強化

このセクションでは、サーバーセキュリティを強化するための手順を提供します。

これを達成するには、より強力なDHEパラメータを生成する必要があります。

openssl dhparam -out dhparam.pem 2048

SSL証明書のインストール

上記で生成された4つのファイルのうち、onlyoffice.key、onlyoffice.crt、dhparam.pemファイルをonlyofficeサーバーにインストールする必要があります。CSRファイルは必要ありませんが、将来必要になる可能性があるため、安全にバックアップしてください。

onlyofficeアプリケーションがSSL証明書を探すために設定されているデフォルトのパスは/var/www/onlyoffice/Data/certsですが、SSL_KEY_PATH、SSL_CERTIFICATE_PATH、SSL_DHPARAM_PATHの設定オプションを使用して変更できます。

/var/www/onlyoffice/Data/のパスはデータストアのパスであるため、/app/onlyoffice/DocumentServer/data/内にcertsというフォルダーを作成し、ファイルをコピーする必要があります。また、セキュリティ対策としてonlyoffice.keyファイルの権限を所有者のみが読み取り可能に更新します。

mkdir -p /app/onlyoffice/DocumentServer/data/certs
cp onlyoffice.key /app/onlyoffice/DocumentServer/data/certs/
cp onlyoffice.crt /app/onlyoffice/DocumentServer/data/certs/
cp dhparam.pem /app/onlyoffice/DocumentServer/data/certs/
chmod 400 /app/onlyoffice/DocumentServer/data/certs/onlyoffice.key

そしてDockerコンテナを再起動します：

sudo docker restart {{DOCUMENT_SERVER_ID}}

これで、アプリケーションのセキュリティが確保されるまであと一歩です。

利用可能な設定パラメータ

以下は、環境変数を使用して設定できるパラメータの完全なリストです。

• ONLYOFFICE_HTTPS_HSTS_ENABLED：HSTS設定をオフにするための高度な設定オプション。SSLが使用されている場合にのみ適用されます。デフォルトはtrueです。
• ONLYOFFICE_HTTPS_HSTS_MAXAGE：onlyoffice NGINX vHost設定でHSTSの最大年齢を設定するための高度な設定オプション。SSLが使用されている場合にのみ適用されます。デフォルトは31536000です。
• SSL_CERTIFICATE_PATH：使用するSSL証明書のパス。デフォルトは/var/www/onlyoffice/Data/certs/tls.crtです。
• SSL_KEY_PATH：SSL証明書の秘密鍵のパス。デフォルトは/var/www/onlyoffice/Data/certs/tls.keyです。
• SSL_DHPARAM_PATH：Diffie-Hellmanパラメータのパス。デフォルトは/var/www/onlyoffice/Data/certs/dhparam.pemです。
• SSL_VERIFY_CLIENT：CA_CERTIFICATES_PATH fileを使用してクライアント証明書の検証を有効にします。デフォルトはfalseです。
• DB_TYPE：データベースのタイプ。サポートされている値はpostgres、mariadb、またはmysqlです。デフォルトはpostgresです。
• DB_HOST：データベースサーバーが実行されているホストのIPアドレスまたは名前。
• DB_PORT：データベースサーバーのポート番号。
• DB_NAME：イメージ起動時に作成されるデータベースの名前。
• DB_USER：データベースアカウントのスーパーユーザー権限を持つ新しいユーザー名。
• DB_PWD：データベースアカウントに設定されたパスワード。
• AMQP_URI：メッセージブローカーサーバーに接続するためのAMQP URI。
• AMQP_TYPE：メッセージブローカーのタイプ。サポートされている値はrabbitmqまたはactivemqです。デフォルトはrabbitmqです。
• REDIS_SERVER_HOST：Redisサーバーが実行されているホストのIPアドレスまたは名前。
• REDIS_SERVER_PORT：Redisサーバーのポート番号。
• REDIS_SERVER_PASS：Redisサーバーのパスワード。デフォルトでは設定されていません。
• NGINX_WORKER_PROCESSES：NGINXワーカープロセスの数を定義します。
• NGINX_WORKER_CONNECTIONS：NGINXワーカープロセスが開くことができる同時接続の最大数を設定します。
• SECURE_LINK_SECRET：nginx設定ディレクティブsecure_link_md5のための秘密を定義します。デフォルトはランダム文字列です。
• JWT_ENABLED：ONLYOFFICE DocsによるJSON Webトークンの検証を有効にするかどうかを指定します。デフォルトはtrueです。
• JWT_SECRET：ONLYOFFICE DocsへのリクエストでJSON Webトークンを検証するための秘密鍵を定義します。デフォルトはランダム値です。
• JWT_HEADER：JSON Webトークンを送信するために使用されるHTTPヘッダーを定義します。デフォルトはAuthorizationです。
• JWT_IN_BODY：ONLYOFFICE Docsへのリクエストボディでのトークン検証を有効にするかどうかを指定します。デフォルトはfalseです。
• ALLOW_META_IP_ADDRESS：メタIPアドレスへの接続を許可するかどうかを定義します。デフォルトはfalseです。
• ALLOW_PRIVATE_IP_ADDRESS：プライベートIPアドレスへの接続を許可するかどうかを定義します。デフォルトはfalseです。
• WOPI_ENABLED：wopiハンドラーの有効化を指定します。デフォルトはfalseです。
• USE_UNAUTHORIZED_STORAGE：ストレージサーバーに自己署名証明書を使用している場合にtrueに設定します。例：Nextcloud。デフォルトはfalseです。
• GENERATE_FONTS：trueの場合、起動時にフォントリストとフォントサムネイルなどを再生成します。デフォルトはtrueです。
• METRICS_ENABLED：ONLYOFFICE DocsのStatsDを有効にするかどうかを指定します。デフォルトはfalseです。
• METRICS_HOST：StatsDのリスニングホストを定義します。デフォルトはlocalhostです。
• METRICS_PORT：StatsDのリスニングポートを定義します。デフォルトは8125です。
• METRICS_PREFIX：バックエンドサービスのためのStatsDメトリクスプレフィックスを定義します。デフォルトはds.です。
• LETS_ENCRYPT_DOMAIN：Let's Encrypt証明書のドメインを定義します。
• LETS_ENCRYPT_MAIL：Let's Encrypt証明書のドメイン管理者メールアドレスを定義します。