Apacheでデプロイする

Apache HTTP Serverを使ってBentoPDFをホストします。

前提条件

Apache 2.4+
mod_rewriteが有効
SSL証明書（推奨）

ステップ1：プロジェクトをビルドする

bash

git clone https://github.com/alam00000/bentopdf.git
cd bentopdf
npm install
npm run build

ブランディングをカスタマイズするには、ビルド前に環境変数を設定します。

bash

VITE_BRAND_NAME="AcmePDF" VITE_BRAND_LOGO="images/acme-logo.svg" npm run build

ステップ2：ファイルをコピーする

bash

sudo mkdir -p /var/www/bentopdf
sudo cp -r dist/* /var/www/bentopdf/
sudo chown -R www-data:www-data /var/www/bentopdf

ステップ3：Apacheの設定

/etc/apache2/sites-available/bentopdf.conf を作成します。

apache

<VirtualHost *:80>
    ServerName your-domain.com
    Redirect permanent / https://your-domain.com/
</VirtualHost>

<VirtualHost *:443>
    ServerName your-domain.com
    DocumentRoot /var/www/bentopdf

    SSLEngine on
    SSLCertificateFile /etc/letsencrypt/live/your-domain.com/fullchain.pem
    SSLCertificateKeyFile /etc/letsencrypt/live/your-domain.com/privkey.pem

    <Directory /var/www/bentopdf>
        Options -Indexes +FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>

    # WASM MIME type
    AddType application/wasm .wasm

    # Prevent double-compression of pre-compressed files
    SetEnvIfNoCase Request_URI "\.gz$" no-gzip

    # Compression
    <IfModule mod_deflate.c>
        AddOutputFilterByType DEFLATE text/html text/plain text/css application/javascript application/json application/wasm
    </IfModule>

    # Cache headers
    <IfModule mod_expires.c>
        ExpiresActive On
        ExpiresByType application/javascript "access plus 1 year"
        ExpiresByType text/css "access plus 1 year"
        ExpiresByType application/wasm "access plus 1 year"
        ExpiresByType image/png "access plus 1 year"
        ExpiresByType image/svg+xml "access plus 1 year"
    </IfModule>

    # Required headers for SharedArrayBuffer (LibreOffice WASM)
    Header always set Cross-Origin-Embedder-Policy "require-corp"
    Header always set Cross-Origin-Opener-Policy "same-origin"
    Header always set Cross-Origin-Resource-Policy "cross-origin"

    # Security headers
    Header always set X-Frame-Options "SAMEORIGIN"
    Header always set X-Content-Type-Options "nosniff"

    # Pre-compressed LibreOffice WASM files
    <FilesMatch "soffice\.wasm\.gz$">
        ForceType application/wasm
        Header set Content-Encoding "gzip"
    </FilesMatch>
    <FilesMatch "soffice\.data\.gz$">
        ForceType application/octet-stream
        Header set Content-Encoding "gzip"
    </FilesMatch>
</VirtualHost>

ステップ4：ルーティング用の.htaccess

/var/www/bentopdf/.htaccess を作成します。

apache

RewriteEngine On
RewriteBase /

# Existing files/dirs - serve directly
RewriteCond %{REQUEST_FILENAME} -f [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^ - [L]

# ============================================
# LANGUAGE ROUTES
# ============================================
# Supported languages: de, es, zh, zh-TW, vi, it, id, tr, fr, pt
# English has no prefix - served from root

# English prefix redirects to root
RewriteRule ^en/?$ / [R=301,L]
RewriteRule ^en/(.+)$ /$1 [R=301,L]

# Language prefix root (e.g., /de/ -> /de/index.html)
RewriteCond %{DOCUMENT_ROOT}/$1/index.html -f
RewriteRule ^(de|es|zh|zh-TW|vi|it|id|tr|fr|pt)/?$ /$1/index.html [L]

# Language prefix with path (e.g., /de/merge-pdf -> /de/merge-pdf.html)
RewriteCond %{DOCUMENT_ROOT}/$1/$2.html -f
RewriteRule ^(de|es|zh|zh-TW|vi|it|id|tr|fr|pt)/([^/]+)/?$ /$1/$2.html [L]

# ============================================
# ADD .HTML EXTENSION (ROOT LEVEL)
# ============================================
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME}.html -f
RewriteRule ^([^/]+)$ $1.html [L]

ErrorDocument 404 /404.html

ステップ5：必要なモジュールを有効にする

bash

sudo a2enmod rewrite
sudo a2enmod ssl
sudo a2enmod headers
sudo a2enmod expires
sudo a2enmod deflate

ステップ6：サイトを有効にする

bash

sudo a2ensite bentopdf.conf
sudo apache2ctl configtest
sudo systemctl reload apache2

サブディレクトリへのデプロイ

/pdf/ でホストするには：

ベースURLを指定してビルドします。

bash

BASE_URL=/pdf/ npm run build

.htaccess を更新します。

apache

RewriteEngine On
RewriteBase /pdf/

# Existing files/dirs - serve directly
RewriteCond %{REQUEST_FILENAME} -f [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^ - [L]

# Language routes
RewriteRule ^en/?$ /pdf/ [R=301,L]
RewriteRule ^en/(.+)$ /pdf/$1 [R=301,L]

RewriteCond %{DOCUMENT_ROOT}/pdf/$1/index.html -f
RewriteRule ^(de|es|zh|zh-TW|vi|it|id|tr|fr|pt)/?$ /pdf/$1/index.html [L]

RewriteCond %{DOCUMENT_ROOT}/pdf/$1/$2.html -f
RewriteRule ^(de|es|zh|zh-TW|vi|it|id|tr|fr|pt)/([^/]+)/?$ /pdf/$1/$2.html [L]

# Root level .html extension
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME}.html -f
RewriteRule ^([^/]+)$ $1.html [L]

ErrorDocument 404 /pdf/404.html

トラブルシューティング

WASMの404エラー

MIMEタイプが設定されていることを確認してください。

apache

AddType application/wasm .wasm

PDFへ署名またはフォーム入力で空白のビューアが表示される（`.mjs` のMIMEエラー）

ブラウザのコンソールに次のように表示される場合：

Failed to load module script: The server responded with a non-JavaScript
MIME type of "application/octet-stream". Strict MIME type checking is
enforced for module scripts per HTML spec.

…かつ失敗しているリクエストが .mjs で終わる場合、Apacheの設定に .mjs → application/javascript の対応付けがありません。同梱のPDFビューアは拡張子 .mjs のESモジュールファイルを配布していますが、Apache標準の mime.types にはデフォルトで含まれていません。

VirtualHostまたは .htaccess に追加します。

apache

AddType application/javascript .mjs

続いてApacheをリロードします。

bash

sudo apache2ctl configtest && sudo systemctl reload apache2

確認するには、ブラウザのDevToolsの「Network」タブで失敗している .mjs のリクエストを探し、レスポンスヘッダー Content-Type を確認します。application/octet-stream ではなく application/javascript になっているはずです。

リライトが動作しない

mod_rewriteが有効になっているか確認してください。

bash

sudo a2enmod rewrite

Word/ODT/ExcelからPDFへの変換が動作しない

LibreOffice WASMには SharedArrayBuffer が必要で、次のヘッダーが求められます。

apache

Header always set Cross-Origin-Embedder-Policy "require-corp"
Header always set Cross-Origin-Opener-Policy "same-origin"

セキュアコンテキストも必要です。ローカルでのテストでは http://localhost が使えますが、http://192.168.x.x などのLAN IPでは通常HTTPSが必要です。ヘッダーが設定されているのに window.crossOriginIsolated が false のままの場合は、ループバック以外のオリジンでページがプレーンなHTTPで開かれていないか確認してください。

事前圧縮された .wasm.gz と .data.gz ファイルにも、正しい Content-Encoding が必要です。

apache

<FilesMatch "soffice\.wasm\.gz$">
    ForceType application/wasm
    Header set Content-Encoding "gzip"
</FilesMatch>
<FilesMatch "soffice\.data\.gz$">
    ForceType application/octet-stream
    Header set Content-Encoding "gzip"
</FilesMatch>

mod_headers が有効になっていることを確認してください：sudo a2enmod headers

パーミッションエラー

bash

sudo chown -R www-data:www-data /var/www/bentopdf
sudo chmod -R 755 /var/www/bentopdf

Apacheでデプロイする ​

前提条件 ​

ステップ1：プロジェクトをビルドする ​

ステップ2：ファイルをコピーする ​

ステップ3：Apacheの設定 ​

ステップ4：ルーティング用の.htaccess ​

ステップ5：必要なモジュールを有効にする ​

ステップ6：サイトを有効にする ​

サブディレクトリへのデプロイ ​

トラブルシューティング ​

WASMの404エラー ​

PDFへ署名またはフォーム入力で空白のビューアが表示される（.mjs のMIMEエラー） ​

リライトが動作しない ​

Word/ODT/ExcelからPDFへの変換が動作しない ​

パーミッションエラー ​

Apacheでデプロイする

前提条件

ステップ1：プロジェクトをビルドする

ステップ2：ファイルをコピーする

ステップ3：Apacheの設定

ステップ4：ルーティング用の.htaccess

ステップ5：必要なモジュールを有効にする

ステップ6：サイトを有効にする

サブディレクトリへのデプロイ

トラブルシューティング

WASMの404エラー

PDFへ署名またはフォーム入力で空白のビューアが表示される（`.mjs` のMIMEエラー）

リライトが動作しない

Word/ODT/ExcelからPDFへの変換が動作しない

パーミッションエラー