Ubuntu 22.04에서 Apache를 사용하여 RoundCube 웹메일 설치하기

RoundCube는 PHP 기반의 오픈소스 웹메일 클라이언트로, IMAP 및 SMTP 서버와 연동하여 이메일을 웹에서 관리할 수 있는 인터페이스를 제공합니다. 이 가이드에서는 Ubuntu 22.04와 Apache를 사용하여 RoundCube를 설치하고 설정하는 방법을 단계별로 안내합니다.

1. 요구 사항

설치를 시작하기 전에 서버 환경이 다음 요구 사항을 충족하는지 확인하세요:
• 운영 체제: Ubuntu 22.04
• 웹 서버: Apache
• PHP: PHP 7.4 이상 (PHP 8.1 권장)
• 데이터베이스: MySQL, MariaDB, PostgreSQL, SQLite 중 하나
• IMAP 및 SMTP 서버: 이메일 송수신을 처리하는 서버 필요 (예: Dovecot, Postfix)

2. 필수 소프트웨어 설치

먼저, RoundCube를 실행하기 위해 필요한 Apache, PHP, 그리고 데이터베이스 서버를 설치합니다.

2.1 Apache 설치

sudo apt update
sudo apt install apache2 -y

2.2 PHP 및 확장 설치

RoundCube에 필요한 PHP와 확장을 설치합니다:

sudo apt install php php-cli php-mbstring php-intl php-json php-common php-curl php-xml php-mysql php-sqlite3 unzip -y

2.3 MariaDB 설치

MariaDB를 설치하고 보안 설정을 수행합니다:

sudo apt install mariadb-server mariadb-client -y
sudo mysql_secure_installation

3. RoundCube 다운로드 및 설치

RoundCube는 공식 웹사이트 또는 GitHub에서 다운로드할 수 있습니다.

3.1 RoundCube 다운로드

wget https://github.com/roundcube/roundcubemail/releases/download/1.6.2/roundcubemail-1.6.2-complete.tar.gz
tar -xvzf roundcubemail-1.6.2-complete.tar.gz
sudo mv roundcubemail-1.6.2 /var/www/roundcube

3.2 권한 설정

Apache가 RoundCube 파일에 접근할 수 있도록 권한을 설정합니다:

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

4. 데이터베이스 설정

RoundCube에서 사용할 데이터베이스와 사용자 계정을 생성합니다.

4.1 데이터베이스 생성

MySQL 또는 MariaDB에 접속하여 데이터베이스를 생성합니다:

sudo mysql -u root -p

다음 명령어를 입력하여 데이터베이스와 사용자를 생성합니다:

CREATE DATABASE roundcube;
CREATE USER 'roundcubeuser'@'localhost' IDENTIFIED BY 'yourpassword';
GRANT ALL PRIVILEGES ON roundcube.* TO 'roundcubeuser'@'localhost';
FLUSH PRIVILEGES;
EXIT;

4.2 스키마 설정

RoundCube 디렉토리에 포함된 SQL 스키마 파일을 데이터베이스에 적용합니다:

mysql -u roundcubeuser -p roundcube < /var/www/roundcube/SQL/mysql.initial.sql

5. RoundCube 구성

RoundCube 설정 파일을 생성하고 수정합니다.

5.1 설정 파일 생성

RoundCube 디렉토리에서 기본 설정 파일을 복사합니다:

sudo cp /var/www/roundcube/config/config.inc.php.sample /var/www/roundcube/config/config.inc.php

5.2 설정 파일 편집

config.inc.php 파일을 열고 IMAP 및 SMTP 서버 정보를 추가로 설정합니다:

sudo nano /var/www/roundcube/config/config.inc.php

다음과 같이 수정합니다:

6. Apache 구성

RoundCube를 Apache를 통해 서비스하도록 설정합니다.

6.1 Apache 가상 호스트 구성

RoundCube용 가상 호스트 파일을 생성합니다:

sudo nano /etc/apache2/sites-available/roundcube.conf

다음 내용을 추가합니다:

<VirtualHost *:80>
ServerName mail.yourdomain.com
DocumentRoot /var/www/roundcube

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

ErrorLog ${APACHE_LOG_DIR}/roundcube_error.log
CustomLog ${APACHE_LOG_DIR}/roundcube_access.log combined

6.2 가상 호스트 활성화 및 Apache 재시작

sudo a2ensite roundcube.conf
sudo systemctl reload apache2

7. HTTPS 설정

운영 환경에서는 HTTPS를 활성화하는 것이 중요합니다. Let’s Encrypt를 사용하여 무료 SSL 인증서를 설치합니다:

sudo apt install certbot python3-certbot-apache
sudo certbot --apache -d mail.yourdomain.com

8. RoundCube 설치 확인

브라우저에서 RoundCube 설치 페이지에 접속하여 정상적으로 작동하는지 확인합니다:

http://mail.yourdomain.com

9. 추가 보안 설정
   1. enable_installer 설정 비활성화:
      • 설치가 완료되면 반드시 config.inc.php에서 enable_installer = false로 설정합니다.
   2. 폴더 접근 제한:
      • logs 및 temp 디렉토리에 접근하지 못하도록 .htaccess로 보호합니다.

이 가이드를 따라 RoundCube를 설치하면, Ubuntu 22.04와 Apache 환경에서 안정적으로 웹메일 서비스를 운영할 수 있습니다.
설치 후에는 IMAP/SMTP 설정과 보안 강화를 점검하여 운영 환경에 적합한 구성을 완성하세요. 😊