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

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

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

1 사전 참고

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

RoundCube에 대한 vhost를 구성하는 방법을 보여드리겠습니다. 이를 통해 /webmail이라는 별칭을 통해 접근할 수 있습니다(예: http://www.example.com/webmail).

2 ISPConfig에서 원격 사용자 생성하기

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

사용자 이름과 비밀번호를 제공합니다…

… 다음 기능을 활성화합니다:

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

그런 다음 저장을 클릭합니다.

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가 설정됩니다.

다음으로 ISPConfig에서 웹사이트로 이동합니다. 옵션 탭에서 nginx 지시어 필드를 볼 수 있습니다:

다음 지시어를 입력하고 저장을 클릭합니다(이 vhost에 대해 PHP가 활성화되어 있는지 여부는 중요하지 않습니다. 이 코드 조각은 www-data 사용자 및 그룹 아래에서 실행되는 시스템의 기본 PHP를 사용합니다. 이는 RoundCube가 vhost의 문서 루트 외부인 /var/lib/roundcube에 설치되기 때문에 중요합니다):

| client_max_body_size 100M; location /roundcube { root /var/lib/; index index.php index.html index.htm; location ~ (.+\.php)$ { try_files $uri =404; include /etc/nginx/fastcgi_params; # SquirrelMail에 접근하려면 기본 사용자(예: Debian/Ubuntu의 www-data)를 사용해야 합니다. #fastcgi_pass 127.0.0.1:9000; fastcgi_pass unix:/var/run/php5-fpm.sock; fastcgi_index index.php; fastcgi_intercept_errors on; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; fastcgi_buffer_size 128k; fastcgi_buffers 256 4k; fastcgi_busy_buffers_size 256k; fastcgi_temp_file_write_size 256k; } location ~* /.svn/ { deny all; } location ~* /README|INSTALL|LICENSE|SQL|bin|CHANGELOG$ { deny all; } } location /webmail { rewrite ^ /roundcube last; } |

이 구성으로 RoundCube는 http://www.example.com/webmail 및 http://www.example.com/roundcube URL에서 접근할 수 있습니다.

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_* /usr/share/roundcube/  
cd /usr/share/roundcube/  
mv ispconfig3_account/config/config.inc.php.dist ispconfig3_account/config/config.inc.php  
ln -s /usr/share/roundcube/ispconfig3_* /var/lib/roundcube/plugins/

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 // ---------------------------------- // 활성 플러그인 목록 (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 별칭(예: www.example.com/webmail) 아래에서 RoundCube에 접근할 수 있습니다. ISPConfig를 통해 생성된 이메일 계정의 이메일 주소와 비밀번호로 로그인합니다: