ISPConfig 3와 함께 Debian Wheezy (Apache2)에서 RoundCube 웹메일 사용하기

이 가이드는 ISPConfig와 Apache2를 실행하는 Debian Wheezy 서버에 RoundCube 웹메일 애플리케이션을 설치하는 방법과 사용자가 RoundCube 내에서 이메일 비밀번호를 변경하는 등의 작업을 수행할 수 있도록 RoundCube용 ISPConfig 3 플러그인을 활성화하는 방법을 설명합니다. Roundcube 웹메일은 애플리케이션과 같은 사용자 인터페이스를 가진 브라우저 기반 다국어 IMAP 클라이언트입니다. MIME 지원, 주소록, 폴더 조작, 메시지 검색 및 맞춤법 검사와 같은 기능이 포함되어 있습니다.

이것이 당신에게 작동할 것이라는 보장을 하지 않습니다!

1 사전 참고

이 튜토리얼은 ISPConfig 3 서버에서 웹 서버로 Apache2를 사용하고 있다고 가정합니다. 이 튜토리얼은 nginx에서는 작동하지 않습니다. Debian Wheezy 저장소에서 RoundCube를 설치할 것입니다. 이는 비교적 최근 버전입니다 (0.7.2.9 vs 0.9.1 (현재 안정 버전)).

RoundCube는 각 vhost에서 /webmail 별칭을 통해 접근할 수 있도록 구성됩니다 (예: http://www.example.com/webmail).

이미 SquirrelMail과 같은 다른 웹메일 애플리케이션을 사용하고 있다면, 이를 완전히 비활성화하거나 최소한 /webmail 별칭을 비활성화해야 합니다. SquirrelMail을 Debian 패키지로 설치한 경우, /etc/apache2/conf.d/squirrelmail.conf에서 별칭을 찾을 수 있습니다. /webmail 별칭을 비활성화하려면 별칭을 주석 처리하거나 전체 파일을 주석 처리하여 SquirrelMail을 완전히 비활성화하세요. 그 후 Apache를 재시작하는 것을 잊지 마세요.

2 ISPConfig에서 원격 사용자 생성

RoundCube용 ISPConfig 3 플러그인은 ISPConfig의 원격 API를 통해 작동합니다. 이 API를 사용하려면 원격 사용자가 필요합니다. 이러한 사용자를 생성하려면 시스템 > 사용자 관리 > 원격 사용자로 이동하여 새 사용자 추가 버튼을 클릭하세요:

사용자 이름과 비밀번호를 제공하세요…

… 그리고 다음 기능을 활성화하세요:

서버 기능
클라이언트 기능
메일 사용자 기능
메일 별칭 기능
메일 스팸 필터 사용자 기능
메일 스팸 필터 정책 기능
메일 페치메일 기능
메일 스팸 필터 화이트리스트 기능
메일 스팸 필터 블랙리스트 기능
메일 사용자 필터 기능

그런 다음 저장을 클릭하세요.

3 RoundCube 설치

다음과 같이 RoundCube를 설치할 수 있습니다:

apt-get install roundcube roundcube-plugins roundcube-plugins-extra

다음 질문이 표시됩니다:

Roundcube의 데이터베이스를 dbconfig-common으로 구성하시겠습니까? <– 예
Roundcube에서 사용할 데이터베이스 유형: <– mysql
데이터베이스의 관리 사용자 비밀번호: <– yourrootsqlpassword (MySQL 루트 사용자 비밀번호)
Roundcube의 MySQL 애플리케이션 비밀번호: <– roundcubesqlpassword
비밀번호 확인: <– roundcubesqlpassword

이렇게 하면 roundcube라는 MySQL 데이터베이스가 생성되고 MySQL 사용자 roundcube와 비밀번호 roundcubesqlpassword가 생성됩니다.

다음으로 /etc/apache2/conf.d/roundcube를 열어보세요…

vi /etc/apache2/conf.d/roundcube

… 그리고 Alias /webmail /var/lib/roundcube라는 줄을 추가하세요. 또한 섹션에 PHP 구성을 추가하세요 (변경 사항을 강조 표시했습니다):

| # 여러 호스트에서 제대로 작동하지 않는 별칭입니다. # 사용하려면 주석을 제거하거나 구성에 맞게 조정하세요. Alias /roundcube/program/js/tiny_mce/ /usr/share/tinymce/www/ Alias /roundcube /var/lib/roundcube Alias /webmail /var/lib/roundcube # tinymce 파일에 대한 접근 Options Indexes MultiViews FollowSymLinks AllowOverride None Order allow,deny allow from all Options +FollowSymLinks DirectoryIndex index.php AddType application/x-httpd-php .php php_flag magic_quotes_gpc Off php_flag track_vars On php_flag register_globals Off php_value include_path .:/usr/share/php # /var/lib/roundcube/.htaccess를 파싱하는 데 필요합니다. AllowOverride를 None으로 설정하기 전에 내용을 확인하세요. AllowOverride All order allow,deny allow from all # 기본 디렉토리 보호: Options -FollowSymLinks AllowOverride None Options -FollowSymLinks AllowOverride None Order allow,deny Deny from all Options -FollowSymLinks AllowOverride None Order allow,deny Deny from all |

그 후 Apache를 재시작하세요:

/etc/init.d/apache2 restart

4 RoundCube 구성

/etc/roundcube/main.inc.php를 열어보세요…

vi /etc/roundcube/main.inc.php

… 그리고 $rcmail_config[‘default_host’] = ‘localhost’; (또는 원격 머신에 있는 경우 메일 서버의 호스트 이름 또는 IP 주소)로 설정하세요:

| [...] $rcmail_config['default_host'] = 'localhost'; [...] |

그렇지 않으면 RoundCube는 각 로그인 전에 호스트 이름을 요청하여 사용자가 과도하게 부담을 느낄 수 있습니다. 우리는 사용이 최대한 간편하도록 하고자 합니다.

다음으로 RoundCube용 ISPConfig 3 플러그인을 설치하세요:

cd /tmp  
git clone https://github.com/w2c/ispconfig3_roundcube.git  
cd /tmp/ispconfig3_roundcube/  
mv ispconfig3_* /var/lib/roundcube/plugins  
cd /var/lib/roundcube/plugins  
mv ispconfig3_account/config/config.inc.php.dist ispconfig3_account/config/config.inc.php

ispconfig3_account/config/config.inc.php를 열어보세요…

vi ispconfig3_account/config/config.inc.php

… 그리고 ISPConfig 원격 사용자의 로그인 세부정보와 원격 API의 URL을 입력하세요. 제 ISPConfig 설치는 https://192.168.0.100:8080에서 실행되므로 원격 API의 URL은 https://192.168.0.100:8080/remote/입니다:

| |

마지막으로 /etc/roundcube/main.inc.php를 다시 열어보세요…

vi /etc/roundcube/main.inc.php

… 그리고 jquerui 플러그인과 ISPConfig 3 플러그인을 활성화하세요…

| [...] // ---------------------------------- // 플러그인 // ---------------------------------- // 활성 플러그인 목록 (plugins/ 디렉토리 내) //$rcmail_config['plugins'] = array(); $rcmail_config['plugins'] = array("jqueryui", "ispconfig3_account", "ispconfig3_autoreply", "ispconfig3_pass", "ispconfig3_spam", "ispconfig3_fetchmail", "ispconfig3_filter"); [...] |

… 그리고 스킨을 기본값에서 클래식으로 변경하세요 (그렇지 않으면 ISPConfig 3 플러그인이 작동하지 않습니다):

| [...] // 스킨 이름: skins/의 폴더 $rcmail_config['skin'] = 'classic'; [...] |

그게 전부입니다. 이제 /webmail 별칭 아래에서 RoundCube에 접근할 수 있습니다 (예: www.example.com/webmail). ISPConfig를 통해 생성된 이메일 계정의 이메일 주소와 비밀번호로 로그인하세요: