Roundcube Webmail 安裝配置完整教學 (LAMP 架構)

Roundcube 是一套基於瀏覽器的多語言 IMAP 郵件客戶端，介面類似桌面應用程式，支援 MIME、通訊錄、資料夾管理、郵件搜尋、拼字檢查等完整功能。採用 PHP + Ajax 開發，需搭配 MySQL 資料庫，前端採用 XHTML + CSS2 設計，必須先部署 LAMP 環境。

一、Web 伺服器環境準備

請先完成 LAMP 架構部署 (Apache + MySQL + PHP)，確保 PHP 支援必要擴展模組。

二、下載與部署 Roundcube

# 下載最新穩定版 (以 0.3 版為例)
wget https://roundcube.net/download/roundcubemail-0.3-stable.tar.gz

# 解壓並移動至網站目錄
tar zxvf roundcubemail-0.3-stable.tar.gz
mv roundcubemail-0.3-stable /var/www/html/webmail

# 確保 temp 和 logs 目錄可寫入
chmod -R 777 /var/www/html/webmail/temp
chmod -R 777 /var/www/html/webmail/logs

此時瀏覽 https://localhost/webmail 會提示缺少設定檔錯誤：

CONFIGURATION ERROR
main.inc.php was not found.
db.inc.php was not found.
Please read the INSTALL instructions!

三、建立與匯入資料庫

mysql -u root -p
# 輸入 root 密碼後進入 MySQL 控制台

# 建立資料庫 (指定 UTF-8 編碼)
CREATE DATABASE roundcubemail DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;

# 建立資料庫用戶並授權
GRANT ALL PRIVILEGES ON roundcubemail.* TO bianjiesky@localhost IDENTIFIED BY 'your_passwd';

# 匯入資料表結構
USE roundcubemail;
SOURCE /var/www/html/webmail/SQL/mysql.initial.sql;
FLUSH PRIVILEGES;
EXIT;

四、配置資料庫連線設定

cd /var/www/html/webmail/config/
cp db.inc.php.dist db.inc.php
cp main.inc.php.dist main.inc.php

編輯 db.inc.php：

$rcmail_config['db_dsnw'] = 'mysql://bianjiesky:your_passwd@localhost/roundcubemail';

• bianjiesky：資料庫用戶名
• your_passwd：對應密碼
• roundcubemail：資料庫名稱

五、配置主設定檔

編輯 main.inc.php：

# 預設 IMAP 伺服器 (本例使用 Zimbra/IP)
$rcmail_config['default_host'] = '127.0.0.1';

# 預設 SMTP 伺服器
$rcmail_config['smtp_server'] = '127.0.0.1';
$rcmail_config['smtp_user'] = '%u';  # 使用登入用戶名
$rcmail_config['smtp_pass'] = '%p';  # 使用登入密碼

# 自動建立預設資料夾 (收件箱、已發送、草稿等)
$rcmail_config['create_default_folders'] = TRUE;

# 預設網域 (可選，啟用後用戶只需輸入用戶名)
# $rcmail_config['username_domain'] = 'example.org';

# 預設介面語言 (可在程式目錄下尋找可用語言代碼)
$rcmail_config['language'] = 'zh_TW';

完成上述設定後，重新整理瀏覽器即可進入 Roundcube 登入介面。