ISPConfig 서버에서 10단계로 RoundCube 웹메일 설치하기

버전 2.1
저자: [at] bb-hosting [dot] org>

ISPConfig에 사용할 수 있는 멋진 RoundCube 패키지가 http://www.ispconfig.org/downloads.htm에 있습니다.

선택한 RoundCube 패키지는 ISPConfig 업데이트 관리자를 통해 설치할 수 있습니다. 그러나 포트 80에서 실행되는 원하는 웹 공간에 ISPConfig 서버에 RoundCube를 설정하려는 경우, 이 “방법”을 대안으로 사용할 수 있습니다.

이 방법에서는 다음을 예로 사용하겠습니다:

도메인 이름 webmail.myhostingcompany.tld
MySQL 데이터베이스 이름: web_db1
MySQL 사용자 이름: web1_u1
MySQL 사용자 비밀번호: mysqlpassword
RoundCube 버전 0.1.1

이 “방법”을 완료하면 URL http://webmail.myhostingcompany.tld에서 멋진 웹메일 클라이언트를 갖게 됩니다.

2단계는 실제로 필요하지 않지만 FTP를 사용하여 웹사이트를 업로드/다운로드하려는 경우 매우 유용할 수 있습니다. 이는 로컬 데스크탑에서 RoundCube 웹사이트를 사용자 정의하려는 경우 매우 유용합니다.

자, 시작해 보겠습니다:

1단계 - 웹사이트 만들기:

ISPConfig에서 메인 메뉴의 “새 사이트”를 통해 웹사이트를 만듭니다.
“기본” 탭에서 호스트 이름에 webmail을, 도메인 이름에 myhostingcompany.tld를 사용합니다. 이 웹사이트에 대해 MySQL 및 PHP 스크립트를 활성화하지만 PHP 안전 모드는 비활성화합니다. RoundCube는 .htaccess 파일을 사용합니다. 웹사이트 내에서 이러한 파일을 허용하려면 웹사이트의 Apache 지시문 필드에 다음 줄을 추가합니다:

  
Options FollowSymLinks  
AllowOverride All

2단계 – 웹사이트용 관리자 사용자 만들기:

ISPConfig에서 관리자 사용자를 생성하여 나중에 FTP를 통해 웹사이트를 업로드할 수 있도록 합니다:
메인 메뉴에서 “ISP 관리자”를 선택하고 구조 트리에서 webmail.myhostingcompany.tld라는 새 웹사이트를 선택한 다음 “사용자 및 이메일” 탭을 누릅니다.
“새로 만들기”를 누르고 새 사용자와 이메일 주소를 정의합니다. 이 사용자에게 관리자 권한을 부여하고 “저장”을 누릅니다.

3단계 - 웹사이트용 MySQL 데이터베이스 만들기:

“옵션“ 탭을 클릭하고 웹사이트용 새 데이터베이스를 만듭니다.
ISPConfig는 다음을 보여줍니다:
데이터베이스 이름: web1_db1 (예)
데이터베이스 사용자: web1_u1 (예)
그런 다음 데이터베이스 사용자에 대한 비밀번호를 정의하고 “저장”을 누릅니다.

4단계 – 패키지 다운로드/추출 및 일부 파일 제거:

루트로 서버에 로그인합니다.
현재 가장 안정적인 릴리스는 버전 0.1.1입니다.
RoundCube를 다운로드할 웹으로 변경하려면 다음 명령을 입력합니다:

cd /var/www/web1/web/
wget http://downloads.sourceforge.net/roundcubemail/roundcubemail-0.1.1.tar.gz

다음 명령으로 RoundCube를 추출합니다:

tar xzf roundcubemail-0.1.1.tar.gz

tar.gz 파일을 제거합니다:

rm *.tar.gz

5단계 - 파일을 웹 디렉토리로 이동하고 빈 디렉토리 삭제:

cd roundcubemail-0.1.1
mv * ../
cd ../
rmdir roundcubemail-0.1.1

6단계 – Apache에 대해 temp 및 logs 디렉토리를 읽기/쓰기 가능하게 만들기:

/var/www/web1/web 폴더 내에서 웹 서버 프로세스에 temp 및 logs 디렉토리의 모든 폴더에 대한 읽기/쓰기 권한을 부여하려면 다음 명령을 입력합니다:

chown -R www-data:www-data temp  
chown -R www-data:www-data logs

(이는 Debian Linux에서 작동하는 방식이며, 다른 배포판은 다를 수 있습니다).
temp 및 logs 디렉토리를 777로 chmod하는 것도 가능하지만 이는 안전하지 않습니다.

ISPConfig 서버에서 suPHP가 활성화된 php5-cgi를 사용하는 경우 다음 명령을 실행합니다:

cd /var/www/web1/

chown -R -v -f webadmin:web1 web/

(“web1” 및 사용자 이름 “webadmin”은 내 예에 따라 다르므로, 자신의 웹 번호와 사용자 이름을 사용하세요!)

7단계 – RoundCube 구성 (수동):

이 방법을 사용하면 더 많은 옵션을 사용할 수 있습니다!
다음 명령으로 config 폴더로 이동합니다:

cd config

여기에서 db.inc.php.dist 및 main.inc.php.dist라는 두 개의 파일을 찾을 수 있습니다.
.main.inc.php.dist 및 db.inc.php.dist의 이름을 .dist를 제거하여 바꿉니다.
이제 db.inc.php 및 main.inc.php라는 두 개의 파일이 있습니다.

db.inc.php 파일에서 수정할 사항:

텍스트 편집기에서 db.inc.php를 엽니다.
다음 줄을 변경하여 RoundCube가 새로 생성된 데이터베이스에 접근할 수 있도록 합니다:

$rcmail_config[’db_dsnw’]=’mysql:// roundcube:pass@localhost/roundcubemail’;

를 다음으로 변경합니다:

$rcmail_config[’db_dsnw’]=’mysql:// web1_u1:mysqlpassword@localhost/web1_db1’;

다음 줄도 포함되어 있는지 확인하세요:

$rcmail_config[‘db_backend’] = ‘mdb2’;

main.inc.php 파일에서 수정할 사항:

텍스트 편집기에서 main.inc.php 파일을 엽니다:

main.inc.php에서 수정할 사항:

다음 줄을 변경합니다:

$rcmail_config[’default_host’] = ‘’;

를 다음으로 변경합니다:

$rcmail_config[’default_host’] = ‘localhost’;

또는 다음으로:

$rcmail_config[’default_host’] = ‘’;

로그인 시 서버 이름을 선택하려면 필요에 따라 변경하세요.
모든 구성 설정을 기본값으로 유지할 수 있지만 다음 줄이 포함되어 있는지 확인하세요:

$rcmail_config[‘default_port’] = 143;

$rcmail_config[‘virtuser_file’] = ‘/etc/postfix/virtusertable’;

$rcmail_config[‘smtp_server’] = ‘’;

$rcmail_config[‘smtp_port’] = 25;

$rcmail_config[‘create_default_folders’] = TRUE;

$rcmail_config[‘prefer_html’] = TRUE;

$rcmail_config[‘htmleditor’] = FALSE;

$rcmail_config[‘preview_pane’] = TRUE;

$rcmail_config[‘enable_spellcheck’] = TRUE;

보안상의 이유로 다음 줄에 특별한 주의가 필요합니다:

$rcmail_config[‘des_key’] = ‘’;

‘’를 정확히 24자의 문자열로 교체하세요!

사용자가 RoundCube에서 처음으로 이메일 주소로 로그인하면, 신원 섹션 내에서 이메일 주소가 [email protected]와 같이 표시됩니다. 이메일 주소가 [email protected]와 같이 표시되도록 하려면 다음을 수행하세요:

/program/include/main.inc 파일의 709번째 줄을 다음으로 변경합니다:

709 $line = trim($line);

를:

709 $line = trim(str_replace(“www.”, “”, $line));

php.ini 파일 내에 다음 줄이 포함되어 있는지 확인하세요:

; 들어오는 GET/POST/Cookie 데이터에 대한 마법 따옴표.
magic_quotes_gpc = Off

다음 줄을 변경해야 하는 경우:

magic_quotes_gpc = On

를:

magic_quotes_gpc = Off

로 변경한 후 다음 명령으로 Apache2를 다시 시작하세요:

/etc/init.d/apache2 restart

8단계 – RoundCube 구성 (설치 스크립트를 사용하는 대안 방법):

RoundCube에는 멋진 설치 스크립트가 포함되어 있습니다. 이 대안 방법은 RoundCube를 구성하는 매우 쉬운 방법입니다. 브라우저에서 새 RoundCube 웹사이트인 http://webmail.yourhostingcompany.tld/installer/index.php를 방문하세요.

RoundCube 그림 1

기본 요구 사항을 읽고 “설치 시작” 버튼을 누릅니다.
“환경 확인” 화면에서 시스템 요구 사항이 확인됩니다.

하나 이상의 시스템 요구 사항이 빨간색으로 표시되면 RoundCube가 제대로 작동하도록 구성 변경이 필요합니다.

기본 ISPConfig 서버에서는 모든 것이 정상이어야 하며, 아마도 php.ini 파일에서 magic_quotes_gpc를 끄기만 하면 됩니다.
시스템 요구 사항이 괜찮다면 “다음” 버튼을 누릅니다.

“구성 생성” 화면에서 필요한 시스템 구성을 정의할 수 있습니다.
이전 7단계에서 했던 것처럼 구성 설정을 정의합니다.
ISPConfig 내에서 정의한 MySQL 데이터베이스에 따라 데이터베이스 설정을 정의합니다:

RoundCube 그림 2

마지막으로 “구성 생성” 버튼을 누릅니다.

두 개의 구성이 표시됩니다.
첫 번째 구성은 main.inc.php 파일에 복사하고 두 번째 구성은 db.inc.php 파일에 복사합니다.
이 파일들을 RoundCube 설치의 config/ 디렉토리에 저장합니다.
“계속” 버튼을 누릅니다.

RoundCube 그림 3

결과가 표시됩니다.
이제 SMTP 및 IMAP 구성을 테스트합니다.
설치를 완료하고 최종 테스트를 마친 후에는 RoundCube 설치의 문서 루트에서 전체 설치 폴더를 제거하세요.

마지막으로, 이 방법의 7단계에서 설명한 대로 /program/include/main.inc 파일의 709번째 줄을 변경합니다.

9단계 – 새 웹메일 클라이언트에 접근하기:

이제 좋아하는 브라우저로 새 웹메일 클라이언트를 가리킬 수 있습니다. 내 방법에 따르면 주소는: http://webmail.myhostingcompany.tld입니다.

ISPConfig 내에서 정의된 유효한 사용자 이름/비밀번호 또는 이메일 주소/비밀번호 조합으로 로그인할 수 있습니다.

첫 로그인 후에는 RoundCube를 사용하기 전에 몇 가지 설정을 해야 합니다. 여기서 가장 먼저 해야 할 일은 신원을 정의하는 것입니다. 이메일 주소에 대해 하나 이상의 신원을 정의할 수 있지만 최소한 하나는 필요합니다. 신원을 생성할 때 필요에 따라 @localhost를 @yourdomain.tld로 변경하세요.

10단계 – RoundCube 사용자 정의:

RoundCube 웹메일을 사용자 정의하려면, URL: http://paulstamatiou.com/2005/10/29/how-to-setup-roundcube-webmail-on-your-server/의 Paul Stamatiou의 방법을 참조하세요.

RoundCube를 사용자 정의하기 전에, STEP 2에서 언급한 대로 먼저 관리자 계정을 사용하여 다운로드하는 것이 좋습니다. 로컬 데스크탑에서 RoundCube 웹메일을 사용자 정의하는 것이 더 편리합니다.

정보:

RoundCube에 대한 더 많은 정보: http://www.roundcube.net/

특별 감사:

RoundCube 설정을 위한 멋진 방법을 작성하고 게시한 Pauls Stamatiou http://paulstamatiou.com/2005/10/29/how-to-setup-roundcube-webmail-on-your-server/에게 감사드립니다.

유용한 정보를 제공한 Howtoforge 회원들에게도 감사드립니다!