Roundcube 1.6.x → 1.7.2 Upgrade Guide
冒頭
Roundcube Webmail のメジャーバージョン更新(1.6.x → 1.7.x)に伴い、セキュリティアップデートと設定変更が発生します。本記事では、1.6 で報告された脆弱性、1.7.0 の破壊的変更、および Nginx での設定調整をまとめます。
本記事の特徴:
- 公式 CVE データベースに基づいた脆弱性一覧
- アップグレード実施時の実体験に基づく Nginx 設定差分
- 最頻出の「CSS 読み込み失敗」問題のデバッグ方法
- FreeBSD ports での実装経験を反映
📌 本記事執筆時点での重要情報
執筆日: 2026年7月6日 14:00 JST
FreeBSD ports での脆弱性対応
現在、FreeBSD ports で公開されている Roundcube 1.7.1 には、以下の脆弱性があります:
CVE-2026-54432 CVSS 未定義
CVE-2026-54433 CVSS 未定義
状況: これらの脆弱性により、FreeBSD ports インストールがセキュリティブロック対象になる可能性があります。
対応方法: Makefile の version を 1.7.1 → 1.7.2 に書き換え、make makesum で tarball を更新(後述の「FreeBSD ports での Roundcube アップグレード手順」参照)
Part 0: データベーススキーマ変更(アップグレード前の必須対応)
⚠️ 重要:Session テーブルへの新カラム追加
Roundcube 1.7.0 以降、Session テーブルに新しいカラムが追加されました:
| カラム名 | 型 | 説明 |
|---|---|---|
expires_at |
timestamp / INTEGER | セッション有効期限(タイムスタンプ) |
このカラムがないと、セッション管理が正常に機能しません。 アップグレード 前に このカラムを追加することを強く推奨します。
PostgreSQL の場合
ALTER TABLE session ADD COLUMN expires_at timestamp NULL DEFAULT NULL;
MySQL / MariaDB の場合
ALTER TABLE session ADD COLUMN expires_at timestamp NULL DEFAULT NULL;
SQLite3 の場合(注意が必要)
-- SQLite3 には TIMESTAMP 型がありません
-- Unix timestamp を格納する INTEGER 型が推奨です
ALTER TABLE session ADD COLUMN expires_at INTEGER;
-- または、ISO 8601 形式の文字列を格納する場合
-- ALTER TABLE session ADD COLUMN expires_at TEXT;
SQLite3 での実装上の注意:
- Roundcube のセッション GC(ガベージコレクション)ロジックが
expires_atをどのように参照しているか検証が必須 - 一部のコードが時刻文字列を期待している可能性があるため、
program/lib/database/sqlite.phpを確認 - テスト環境で十分な検証を行ってからアップグレード
スキーマ確認コマンド
# SQLite3 のスキーマ確認
sqlite3 /path/to/roundcube.db ".schema session"
# 出力: CREATE TABLE session (..., expires_at INTEGER);
# PostgreSQL のスキーマ確認
psql -U roundcube_user -d roundcube -c "\d session;"
# 出力: expires_at | timestamp without time zone |
# MySQL のスキーマ確認
mysql -u roundcube_user -p roundcube -e "DESCRIBE session;"
# 出力: expires_at | timestamp | YES | MUL | NULL |
アップグレード前チェック
# スキーマ変更を実行済みか確認
# PostgreSQL の場合
psql -U roundcube_user -d roundcube -c \
"SELECT column_name FROM information_schema.columns WHERE table_name='session' AND column_name='expires_at';"
# MySQL の場合
mysql -u roundcube_user -p roundcube -e \
"SELECT COLUMN_NAME FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_NAME='session' AND COLUMN_NAME='expires_at';"
Part 1: Roundcube 1.6.x の脆弱性状況
概要
1.6 系列は LTS(Long-Term Support)モードに移行し、セキュリティ修正のみの提供となります。アップグレード前に、どのような脆弱性が存在していたかを把握することは重要です。
主要な脆弱性一覧
| CVE ID | CVSS | 種類 | 説明 | 影響範囲 |
|---|---|---|---|---|
| CVE-2025-49113 | 9.9 (Critical) | RCE | PHP Object Deserialization による認証後 RCE(upload.php の _from パラメータ検証不足) |
≤ 1.6.10, < 1.5.10 |
| CVE-2026-26079 | - | CSS Injection | CSS コメント処理の不十分さにより XSS 可能(rcube_utils.php) | < 1.6.13, < 1.5.13 |
| CVE-2026-48843 | - | SSRF / 情報漏洩 | CSS サニタイゼーション不足。SVG アニメーションによるリモート画像読み込み | 1.6.14 - 1.6.16, < 1.7.1 |
| CVE-2026-48845 | - | 情報漏洩 | リモート画像ブロック設定が局所アドレスに対して有効でない | 1.6.14 - 1.6.16, < 1.7.1 |
| CVE-2026-54432 | - | TBD | 1.7.1 で新たに報告 | 1.7.1 |
| CVE-2026-54433 | - | TBD | 1.7.1 で新たに報告 | 1.7.1 |
詳細解説
CVE-2025-49113(最重要)
- 発見者: Kirill Firsov(FearsOff)
-
問題:
program/actions/settings/upload.phpの_fromパラメータが不十分な検証で、PHP オブジェクトのデシリアライゼーション脆弱性を招く - 利用条件: 認証済みユーザー
- 影響: 10 年間放置されていた。約 5,300 万ホストに影響
-
対策: 1.6.11 以降で
_fromの無効文字(.など)を除外
CSS インジェクション関連(CVE-2026-26079, CVE-2026-48843, CVE-2026-48845)
- 共通点: HTML メール内のスタイルシート処理が不十分
-
攻撃手法:
- SVG
<animate>要素のattributeName="style"による CSS 注入 - CSS
var()関数によるリモート画像読み込み迂回 - 外部スタイルシートリンクを利用した SSRF
- SVG
- 報告者: Orange Cyberdefense、wooseokdotkim ほか複数の独立研究者
- ユースケース: フィッシング、内部ネットワーク情報の漏洩
CVE-2026-54432, CVE-2026-54433
- 状況: 1.7.1 で報告された新規脆弱性
- 詳細: 関連ドキュメント公開待ち
- 対応: 1.7.2 以降で修正予定
その他の修正
- pre-auth SQL インジェクション(virtuser_query プラグイン)
- pre-auth 任意ファイル削除(Redis/Memcache セッション中毒)
- LDAP コード注入(autovalues オプション)
セキュリティ更新の推移
- 1.6.16/1.7.1(2026年5月24日): CSS インジェクション他を修正
- 1.7.2/1.6.17(2026年7月5日): ゼロクリック XSS、SSRF バイパス、TNEF 無限ループを修正
Part 2: Roundcube 1.7.0 からの変更点
メジャーアップグレードの位置付け
1.7.0 はほぼ 4 年間の開発を経てリリースされた次の安定版であり、いくつかの破壊的変更と新機能をもたらします。1.6 との互換性が失われる部分が多数あるため、事前の検証が必須です。
破壊的変更(Breaking Changes)
1. PHP バージョン要件の厳格化
- 変更: PHP 8.1 未満のサポートを廃止
- 影響: PHP 7.4 以下の環境では 1.7.x へのアップグレード不可
-
確認コマンド:
php --version
2. public_html/ エントリーポイントの必須化
- 変更: public_html エントリーポイントが HTTP サーバー向けに必須化され、すべてのインストール環境を保護
- 背景: Web アクセスを public_html/ 配下のみに制限し、プログラム内部ファイルへの直接アクセスを防止
-
影響:
- Nginx/Apache のドキュメントルート設定変更が必須
- 全ての静的リソースは
public_html/static.phpを経由
-
例示:
Before: /var/www/roundcube/ After: /var/www/roundcube/public_html/
3. APC キャッシュドライバの廃止
- 変更: APC キャッシュドライバを削除し、APCU ドライバに置き換え
-
対応: config.php の
$config['cache_driver']で 'apc' を使用している場合は 'apcu' に変更// Before $config['cache_driver'] = 'apc'; // After $config['cache_driver'] = 'apcu';
4. データベースサポートの削除
- 変更: MS SQL Server と Oracle のサポート廃止
- 対応: これらのデータベースを利用している場合は、事前に PostgreSQL/MySQL への移行が必須
5. Internet Explorer サポートの廃止
- 変更: Internet Explorer サポート廃止
- 影響: JavaScript の最新構文が使用されるようになり、古いブラウザでの動作保証なし
新機能
OAuth2/OIDC の改善
- OIDC Discovery サポート
- OIDC ロジアウトの対応
- セキュリティ強化型の認証フロー
Markdown メール対応
- メール送受信時に Markdown 形式をサポート
- リッチテキスト編集とプレーンテキスト表示のハイブリッド対応
クイックアクション UI
- メッセージリスト上のマウスオーバーで操作メニューを表示
- ユーザビリティ向上
高度なメール検索構文
- より複雑な検索クエリをサポート
- サーバー側の検索フィルタリング機能を活用
推奨事項
-
段階的な検証:
- 本番環境とは別にステージング環境でテスト
- メール受信・送信・連絡先インポートの動作確認
-
設定ファイルの見直し:
-
config/config.inc.php全体を再度確認 - プラグイン設定の互換性チェック
-
-
バックアップ:
- アップグレード前に必ずデータベースとファイルシステムをバックアップ
Part 3: Nginx 設定の変更
1.6 系での Nginx 設定(参照)
Roundcube 1.6.x では、通常以下のような Nginx 設定が使用されていました:
server {
listen 80;
server_name mail.example.com;
# ドキュメントルート:インストールディレクトリのルート
root /var/www/roundcube;
index index.php;
location ~ \.php$ {
fastcgi_pass unix:/run/php/php-fpm.sock;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
# 静的ファイルのキャッシュ
location ~* \.(css|js|jpg|png|gif|ico|woff|woff2)$ {
expires 30d;
}
}
1.7.x での設定変更(実装事例)
Before (1.6.x 設定)
# 静的リソースの直接配信(キャッシュ設定)
location ~* \.(jpg|jpeg|gif|css|png|js|ico|html|xml|txt|pdf|eot|ttf|woff|woff2)$ {
access_log off;
log_not_found off;
expires max;
}
# PHP
location ~ \.php$ {
try_files $uri =404;
fastcgi_split_path_info ^(.+\.php)(/.+)$;
fastcgi_pass unix:/var/run/php/sock;
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_param PATH_INFO $fastcgi_path_info;
}
After (1.7.x 設定)
# ⚠️ DEPRECATED in 1.7.x: 下記の location ブロックは削除
# 1.7.x では static.php を経由するため、Nginx での直接配信はサポート終了
# 詳細は「ハマりどころ:CSS が読み込めない問題」セクション参照
#
# location ~* \.(jpg|jpeg|gif|css|png|js|ico|html|xml|txt|pdf|eot|ttf|woff|woff2)$ {
# access_log off;
# log_not_found off;
# expires max;
# }
# PHP(より厳密な正規表現に変更)
# 1.7.x では以下の点で正規表現が改善:
# - 1.6.x: ~ \.php$ (単純な .php マッチ)
# - 1.7.x: ~^(.+\.php)(/.*)?$ (キャプチャ + パス情報対応)
# PATH_INFO を正確に渡すため、(.+\.php) と (/.*)?$ で分離
#
location ~^(.+\.php)(/.*)?$ {
include fastcgi_params;
fastcgi_split_path_info ^(.+\.php)(/.+)$;
fastcgi_pass unix:/var/run/php/sock;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_param PATH_INFO $fastcgi_path_info;
}
一般的な設定例(参考)
1.7.x 推奨設定(public_html 必須化対応)
upstream php_backend {
server unix:/run/php/php-fpm.sock;
}
server {
listen 80;
server_name mail.example.com;
# ドキュメントルートを public_html に指定(必須)
root /var/www/roundcube/public_html;
index index.php;
# セキュリティ: 親ディレクトリへのアクセスを防止
location ~ /\. {
deny all;
access_log off;
log_not_found off;
}
# PHP ファイルの処理
location ~ \.php$ {
fastcgi_pass php_backend;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
# セキュリティヘッダ
fastcgi_param HTTPS on;
}
# 静的ファイルキャッシュ(public_html/static 以下のみ)
location ~* ^/static/.*\.(css|js|jpg|png|gif|ico|woff|woff2|svg)$ {
expires 30d;
add_header Cache-Control "public, immutable";
}
# static.php 経由での静的リソース取得(1.7.x 対応)
location /static {
rewrite ^/static/(.*)$ /static.php?__file=$1 last;
}
# その他の静的リソース
location ~ ^/(favicon\.ico|robots\.txt)$ {
expires 30d;
log_not_found off;
}
# エラーハンドリング
error_page 404 /index.php;
}
設定のポイント
-
ドキュメントルートの変更
-
root /var/www/roundcube/public_html;に明示的に指定 - これにより、Web アクセスが
public_html/以下のみに限定される
-
-
static.php の活用
- 1.7.x では静的ファイルアクセスが
static.phpを経由 - キャッシュヘッダの制御と安全な配信を実現
- 1.7.x では静的ファイルアクセスが
-
セキュリティ強化
-
location ~ /\.で隠しファイル(.envなど)へのアクセスを拒否 - 親ディレクトリへのアクセスを防止
-
-
HTTPS への転用
- 本番環境では必ず SSL/TLS を導入(証明書は Let's Encrypt 等で取得)
- 上記例に
listen 443 ssl;の追加と証明書パスを指定
⚠️ ハマりどころ:CSS が読み込めない問題
現象の説明
1.6.x から 1.7.x にアップグレードした際、以下の症状が発生することがあります:
- CSS ファイルが 403/404 で読み込み失敗
- JavaScript も読み込めない
- SVG ファイルは読み込める(実は内部埋め込みだった)
- UI が崩れて、ロゴが巨大に表示される
これは設定差分で示したように、静的リソースの location ブロックをコメントアウトしたものの、static.php へのルーティング設定を追加していないためです。
根本原因の分析
| 処理段階 | 1.6.x | 1.7.x |
|---|---|---|
| CSS リクエスト到着 | ✅ location ~* \.css$ で直接ファイル配信 |
❌ マッチするルールがない |
| location ブロック処理 | — | PHP location も非マッチ(.php ではないため) |
| 結果 | CSS 取得成功 (200 OK) | CSS 取得失敗 (403 or 404) |
なぜ SVG は読める?
- SVG ファイルが直接ファイルシステムから読まれているのではなく、HTML に埋め込まれている可能性が高い
- または
<img src="logo.svg" />でアクセスしているが、1.7.x の設定では public_html 外の SVG ファイルへのアクセスが偶然許可されている - CSS が読めない理由は、
@importや<link>タグでファイルパスを指定しており、Nginx がそのリクエストを処理できていないことが原因
正しい修正方法
1.7.x では、以下のいずれかの方法で static.php へのルーティングを 必ず追加 する必要があります。
方法 A: static ディレクトリ専用ルール(推奨)
# static.php を経由した静的ファイル配信
location /static {
rewrite ^/static/(.+)$ /static.php?__file=$1 last;
expires max;
}
# 直接アクセスも許可(キャッシュ効率化)
location ~* \.(jpg|jpeg|gif|css|png|js|svg|ico|woff|woff2|ttf|eot)$ {
expires 30d;
}
方法 B: 全静的リソースを static.php 経由(セキュリティ重視)
# すべての静的リソースを static.php 経由で配信
location ~* \.(jpg|jpeg|gif|css|png|js|svg|ico|woff|woff2|ttf|eot|xml|txt|pdf|html)$ {
try_files $uri /static.php?__file=$uri;
expires 30d;
}
方法 C: PHP location の処理順序を工夫
# CSS/JS など特定の拡張子は static.php へリダイレクト
location ~ \.(css|js)$ {
rewrite ^(.*)$ /static.php?__file=$1 last;
}
# PHP ファイルは通常処理
location ~^(.+\.php)(/.*)?$ {
# ... 以下、通常の PHP 設定
}
推奨される最終設定
server {
listen 80;
server_name mail.example.com;
# ドキュメントルート(1.7.x では必須)
root /var/www/roundcube/public_html;
index index.php;
# 隠しファイル・ディレクトリへのアクセス拒否
location ~ /\. {
deny all;
access_log off;
log_not_found off;
}
# 静的リソースの処理(method A: static ディレクトリ指定)
location /static {
# キャッシュ設定
expires 30d;
add_header Cache-Control "public, immutable";
# static.php を経由して配信
rewrite ^/static/(.+)$ /static.php?__file=$1 last;
}
# 直接アクセス可能な静的ファイル(ルートレベル)
location ~* \.(favicon\.ico|robots\.txt)$ {
expires 30d;
log_not_found off;
}
# PHP ファイルの処理
location ~^(.+\.php)(/.*)?$ {
include fastcgi_params;
fastcgi_split_path_info ^(.+\.php)(/.+)$;
fastcgi_pass unix:/var/run/php/sock;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_param PATH_INFO $fastcgi_path_info;
}
# 存在しないリクエストは index.php へ
error_page 404 =200 /index.php;
}
デバッグ手順
CSS が読み込めない場合、以下の手順で原因を特定します:
# 1. ブラウザの開発者ツール (F12) → Network タブで CSS リクエストを確認
# → Status: 404 or 403 か、別のエラーか確認
# 2. Nginx エラーログを確認
sudo tail -f /var/log/nginx/error.log
# 出力例: [error] 12345#12345: *1 open() "/var/www/roundcube/public_html/css/app.css" failed (2: No such file or directory)
# → ファイルパスが正しくない、または static.php へのルーティングがない
# 3. Roundcube インストールディレクトリ構造を確認
find /var/www/roundcube -name "*.css" | head -10
# CSS ファイルが /var/www/roundcube/public_html/static/ 配下にあるか確認
# 4. Nginx 設定の文法チェック
sudo nginx -t
# → syntax is ok であることを確認
# 5. Nginx をリロード
sudo systemctl reload nginx
# 6. キャッシュをクリア(ブラウザ)
# → Ctrl+Shift+Del で履歴とキャッシュを削除
# → または、Private Window で再度アクセス
よくある間違い
| 誤り | 正しい設定 | 理由 |
|---|---|---|
| location ブロックをすべてコメントアウト |
static.php へのルーティング追加 |
1.7.x では static.php 経由が必須 |
try_files $uri =404; を残す |
try_files $uri /static.php?__file=$uri; |
static.php へのフォールバックが必要 |
location /static がない |
/static または /static.php へのルーティング必須 |
静的ファイルの配信パスが確立されない |
| キャッシュヘッダなし |
expires max; を明示的に指定 |
ブラウザキャッシュが効かず、毎回リロード |
設定変更時のチェックリスト
# 1. Nginx 設定ファイルの文法チェック
sudo nginx -t
# 2. Roundcube 1.7 のインストーラー実行
cd /var/www/roundcube/public_html
php installer/index.php
# 3. ファイルアクセス権限の確認
ls -la /var/www/roundcube/public_html/
# 必要に応じて: chown -R www-data:www-data /var/www/roundcube
# 4. ログファイルの確認
sudo tail -f /var/log/nginx/error.log
sudo tail -f /var/log/php-fpm.log
# 5. キャッシュのクリア(ブラウザとサーバー側)
# config.php で cache_dir を確認し、ファイルを削除
トラブルシューティング
0. Session テーブルエラー(Part 0 参照)
症状:
Database error: Unknown column 'expires_at' in 'field list'
原因: Part 0 の Session テーブル変更が実施されていない
対応: Part 0 のセクションで該当の ALTER TABLE を実行してください
1. CSS/JS ファイルが 404/403 で読み込み失敗(最頻出)
原因と症状:
- ✗ UI が崩れて、レイアウトが表示されない
- ✗ ボタンやフォームのスタイルが適用されない
- ✗ ブラウザ開発者ツール → Network タブで CSS リクエストが
404 Not Foundまたは403 Forbidden - ✗ SVG など別の静的ファイルは読める(ロゴが巨大表示される)
根本原因:
- 1.6.x の
location ~* \.(css|js|...)$ブロックをコメントアウトした - しかし、1.7.x 対応の
static.phpへのルーティングを追加していない - CSS リクエストが Nginx のどの
locationブロックにもマッチせず、404 で処理されている
対応手順:
# Step 1: Nginx エラーログで確認
sudo tail -f /var/log/nginx/error.log &
# Step 2: ブラウザ開発者ツール (F12) → Network で CSS リクエストをクリック
# → Request URL を確認: /static/css/app.css など
# Step 3: Nginx 設定に以下を追加
sudo nano /etc/nginx/sites-available/roundcube
追加する設定(以下のいずれか1つ):
# Option A: static ディレクトリ専用(推奨)
location /static {
rewrite ^/static/(.+)$ /static.php?__file=$1 last;
expires 30d;
}
# Option B: CSS/JS を個別リライト
location ~ \.(css|js)$ {
rewrite ^(.*)$ /static.php?__file=$1 last;
}
# Option C: すべての静的拡張子を処理
location ~* \.(css|js|jpg|jpeg|gif|png|svg|ico|woff|woff2|ttf|eot)$ {
try_files $uri /static.php?__file=$uri;
expires 30d;
}
# Step 4: 文法チェック
sudo nginx -t
# Step 5: Nginx リロード
sudo systemctl reload nginx
# Step 6: キャッシュクリア(重要)
# ブラウザ: Ctrl+Shift+Del で履歴とキャッシュを削除
# または Private/Incognito Window で再度アクセス
# Step 7: CSS が読み込まれたか確認
sudo tail -f /var/log/nginx/access.log | grep "\.css"
# → 200 OK で返っていることを確認
2. 「public_html が見つからない」エラー
原因: ドキュメントルートが正しく設定されていない
対応:
# Roundcube インストールディレクトリの構造を確認
ls -la /var/www/roundcube/
# 出力: public_html/ index.php program/ plugins/ ...
# public_html の中身を確認
ls -la /var/www/roundcube/public_html/
# 出力: index.php, static.php, static/ などが含まれているはず
3. static.php 経由のファイルが 404
原因: 以下のいずれか
-
static.phpへのルーティングが間違っている -
fastcgi_param SCRIPT_FILENAMEの設定が不足 - rewrite ルールが
lastでなくpermanentになっている
対応:
# ❌ 間違った例
location /static {
try_files $uri =404; # static.php へのフォールバックがない
}
# ✅ 正しい例
location /static {
try_files $uri /static.php?__file=$uri; # static.php へフォールバック
}
# または、より明示的に
location /static {
rewrite ^/static/(.+)$ /static.php?__file=$1 last;
}
# 確認コマンド
# 1. Nginx 設定の構文チェック
sudo nginx -t
# 2. static.php ファイルが存在するか確認
test -f /var/www/roundcube/public_html/static.php && echo "static.php exists" || echo "static.php NOT found"
# 3. static.php のアクセス権限確認
ls -la /var/www/roundcube/public_html/static.php
# 4. Roundcube アクセスログで static.php のリクエストを確認
sudo tail /var/log/nginx/access.log | grep "static.php"
4. Permission Denied / 403 エラー(特に Linux 環境、FreeBSD)
症状:
- ブラウザで 403 Forbidden
- Nginx ログ:
Permission denied - static.php へのアクセスが 403
原因:
- アップグレード後、Roundcube ファイルのオーナーが正しくない
- php-fpm が Web サーバーユーザーで実行されていない
対応:
# Step 1: Roundcube ディレクトリの所有者を確認
ls -ld /var/www/roundcube/public_html
# 出力例(問題あり): drwxr-xr-x root wheel 4096
# 出力例(正常): drwxr-xr-x www-data www-data 4096
# Step 2: www ユーザーに所有者を変更
# Linux の場合
sudo chown -R www-data:www-data /var/www/roundcube
# FreeBSD の場合
sudo chown -R www:www /var/www/roundcube
# Step 3: logs/temp ディレクトリは Web サーバーが書き込める必要あり
sudo chmod 750 /var/www/roundcube/{logs,temp,cache}
sudo chmod 750 /var/www/roundcube/config
# Step 4: PHP-FPM 設定を確認
# Linux の場合
cat /etc/php/fpm/pool.d/www.conf | grep "user ="
# FreeBSD の場合
cat /usr/local/etc/php-fpm.d/www.conf | grep "user ="
# 出力確認: user = www-data (Linux) or www (FreeBSD)
# Step 5: PHP-FPM を再起動
sudo systemctl restart php-fpm
# Linux での例
# sudo service php-fpm restart
# sudo systemctl restart php7.4-fpm
# FreeBSD での例
# sudo service php-fpm restart
5. PHP アップグレード後に動作しない
原因: PHP 8.1 の厳格な型チェックに引っかかっている可能性
対応:
// config.php で error_reporting を確認
error_reporting(E_ALL & ~E_NOTICE & ~E_DEPRECATED);
// または、php.ini で
display_errors = Off
log_errors = On
error_log = /var/log/php-error.log
# PHP エラーログを監視
sudo tail -f /var/log/php-fpm.log
6. Logo や特定の画像だけが巨大表示される
原因: CSS が読み込まれていない(上記「1. CSS/JS ファイルが 404/403」参照)
症状の詳細:
- HTML に
<svg>で埋め込まれたロゴ、または base64 化された画像は表示される - 外部ファイル参照の CSS が無視されているため、サイズ制限が効かない
- SVG 元のサイズでそのまま表示される
対応: 上記「1. CSS/JS ファイルが 404/403」と同じ手順で CSS ファイルへのルーティングを修正
Column: 1.7.x の設計思想
なぜ public_html/ が必須化されたのか?
1.7.x での public_html/ エントリーポイント必須化は、単なる設定の変更ではなく、セキュリティを中心とした設計変更 です。
1.6.x では、ドキュメントルートが /var/www/roundcube/ のため、/program/ や /config/ ディレクトリへのアクセス防止に頼っていました。しかし 1.7.x では、Nginx のドキュメントルートを /var/www/roundcube/public_html/ に限定することで、Web からアクセス可能な範囲を物理的に制限 しています。
さらに、すべての静的ファイルが static.php を経由することで、キャッシュヘッダやセキュリティヘッダを一元管理可能になりました。
Column: FreeBSD ports での Roundcube アップグレード手順
ports ツリーの更新と脆弱性チェック
# 1. ports ツリーをアップデート
sudo portsnap fetch update
# 2. セキュリティアドバイザリをチェック
sudo pkg audit roundcube
# 出力例:
# d5578ba4-7889-11f1-b72c-8447094a420f: roundcube -- Multiple vulnerabilities
# CVE: CVE-2026-54432
# CVE: CVE-2026-54433
脆弱性がある場合の対応(1.7.1 の場合)
# Step 1: ports の Makefile を編集
sudo nano /usr/ports/mail/roundcube/Makefile
# Step 2: DISTVERSION を 1.7.1 → 1.7.2 に変更
# 編集前: DISTVERSION= 1.7.1
# 編集後: DISTVERSION= 1.7.2
# Step 3: ダウンロードするファイルのチェックサムを更新
cd /usr/ports/mail/roundcube
sudo make makesum
# Step 4: インストール(patch が必要な場合はここで失敗)
sudo make install clean
# Step 5: インストール後の確認
pkg info roundcube
# 出力: roundcube-1.7.2
注意事項
-
FreeBSD patch が必要な場合: 上記
make installは失敗します
(Roundcube はほぼ./configureで吸収するため稀です) -
ダウンロード後:
/usr/ports/distfiles/に tarball が保存されます -
アップグレード後:
pkg auditで脆弱性がないか再確認してください
参考: FreeBSD ports でインストールされた Roundcube のパスは以下のいずれかです:
-
/usr/local/www/roundcube/(Apache の場合) -
/var/www/roundcube/(独立サーバーの場合)
まとめ
| 項目 | 対応 | タイミング | 優先度 |
|---|---|---|---|
| Session テーブル schema 変更 | ALTER TABLE session ADD COLUMN expires_at | アップグレード前 | 🔴 必須 |
| PHP 8.1 以上へのアップグレード | 環境確認 + 本体更新 | アップグレード前 | 🔴 必須 |
| Roundcube 1.7.2 へ更新 | ダウンロード・解凍 | アップグレード当日 | 🔴 必須 |
| public_html ドキュメント設定 | Nginx config 修正 | アップグレード当日 | 🔴 必須 |
| static.php へのルーティング追加 | Nginx location ブロック追加 | アップグレード当日 | 🔴 必須 |
| APC → APCU キャッシュ切り替え | config.php 修正 | アップグレード当日 | 🟡 推奨 |
| ファイルパーミッション修正 | chown -R www-data:www-data | アップグレード直後 | 🟡 推奨 |
| SSL/TLS 設定の確認 | Nginx + 証明書更新 | 運用期間中 | 🟡 推奨 |
最後に:
-
アップグレード前には必ずフルバックアップを取得してください
# PostgreSQL の場合 sudo -u postgres pg_dump roundcube > /backup/roundcube_backup_$(date +%Y%m%d).sql # MySQL の場合 mysqldump -u root -p roundcube > /backup/roundcube_backup_$(date +%Y%m%d).sql # ファイルシステムのバックアップ sudo rsync -av /var/www/roundcube/ /backup/roundcube_backup_$(date +%Y%m%d)/ -
ステージング環境での十分なテストを推奨します
- メール送受信
- 連絡先のインポート/エクスポート
- OAuth2/OIDC 認証(使用している場合)
- モバイルブラウザでの UI 確認
-
アップグレード後、最初にすること
# キャッシュクリア sudo rm -rf /var/www/roundcube/temp/* sudo rm -rf /var/www/roundcube/cache/* # ファイルパーミッション再設定 sudo chown -R www-data:www-data /var/www/roundcube sudo chmod 750 /var/www/roundcube/{config,logs,temp,cache} # Nginx リロード sudo systemctl reload nginx # ブラウザキャッシュクリア(Ctrl+Shift+Del)
参考リンク
公式ドキュメント
- Roundcube Official Release Notes
- GitHub Roundcube Repository
- Roundcube 1.7.0 Changes
- Security Updates 1.6.16/1.7.1
FreeBSD 関連
Nginx / PHP
- Nginx Official Documentation
- Nginx location ディレクティブ処理順序
- PHP-FPM Configuration
- PHP 8.1 Migration Guide