ISPConfig 3 - Roundcube 플러그인 설치하기 - Debian 10

ispconfig3_roundcube 플러그인은 ISPConfig 메일 계정 설정을 Roundcube에 통합합니다. 이 튜토리얼에서는 설치 과정을 안내하겠습니다.

전제 조건

• Roundcube는 apt를 사용하여 설치해야 합니다. 그렇지 않으면 이 튜토리얼에서 사용된 파일 경로를 변경해야 할 수 있습니다.
• ISPConfig 및 Roundcube 설치가 최신인지 확인하세요.

원격 사용자 추가하기

ISPConfig 3 플러그인은 API를 사용하여 시스템에 연결합니다. 따라서 제어판에서 원격 사용자를 생성해야 합니다.

패널에 로그인하고 시스템 -> 원격 사용자로 이동한 후 “새 원격 사용자 추가“를 클릭합니다. 양식에 새 사용자 이름과 비밀번호를 입력하세요. 저는 rc-example과 비밀번호 examplepass를 사용할 것입니다. 동일한 자격 증명을 사용하지 말고 본인만의 것을 만드세요. 제 패널은 https://panel.example.com:8080에 위치하며 유효한 SSL 인증서가 있습니다.

원격 사용자에 대해 다음 기능을 활성화하세요:

• Roundcube 플러그인 기능

그리고 웹메일 서버의 IPv4 및 IPv6 주소에 대한 원격 액세스를 활성화하세요.

플러그인 다운로드

다음 명령어를 실행하세요:

cd /tmp  
wget https://github.com/w2c/ispconfig3_roundcube/archive/master.zip  
unzip master.zip  
cd ./ispconfig3_roundcube-master  
cp -r ./ispconfig3_* /usr/share/roundcube/plugins  
ln -s /usr/share/roundcube/plugins/ispconfig* /var/lib/roundcube/plugins/

이제 플러그인이 올바른 폴더에 있으며, /var/lib/roundcube/plugins에서 심볼릭 링크가 생성되었습니다. 다음 단계는 원격 사용자를 사용하도록 구성하는 것입니다. 예제 구성을 복사하고 편집하려면 다음을 실행하세요:

cp /usr/share/roundcube/plugins/ispconfig3_account/config/config.inc.php.dist /usr/share/roundcube/plugins/ispconfig3_account/config/config.inc.php
nano /usr/share/roundcube/plugins/ispconfig3_account/config/config.inc.php

이 구성 파일을 보게 될 것입니다:

$config['identity_limit'] = false;
$config['remote_soap_user'] = '{REMOTE USERNAME}';
$config['remote_soap_pass'] = '{REMOTE PASSWORD}';
$config['soap_url'] = 'https://{YOUR SERVER}:8080/remote/';
$config['soap_validate_cert'] = true;

저는 이를 다음과 같이 변경할 것입니다:

$config['identity_limit'] = false;
$config['remote_soap_user'] = 'rc-example';
$config['remote_soap_pass'] = 'examplepass';
$config['soap_url'] = 'https://panel.example.com:8080/remote/';
$config['soap_validate_cert'] = true;

빨간색으로 밑줄 친 텍스트를 본인만의 자격 증명과 패널 주소로 바꾸는 것을 잊지 마세요. https를 사용하지만 신뢰할 수 있는 SSL 인증서가 설치되어 있지 않은 경우 soap_validate_cert를 false로 변경하세요.

플러그인 활성화하기

플러그인을 활성화하려면 Roundcube 구성을 엽니다:

nano /etc/roundcube/config.inc.php

그리고 다음 줄을 검색하세요:

// 활성 플러그인 목록 (plugins/ 디렉토리 내) $config['plugins'] = array();

플러그인을 활성화하려면 대괄호 사이에 다음을 추가하세요:

"jqueryui", "ispconfig3_account", "ispconfig3_autoreply", "ispconfig3_pass", "ispconfig3_spam", "ispconfig3_fetchmail", "ispconfig3_filter", "ispconfig3_forward", "ispconfig3_wblist"

그럼 이 줄은 다음과 같이 보일 것입니다:

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

여기에 대한 몇 가지 주의 사항:

• jqueryui 플러그인은 다른 플러그인 앞에 배치해야 합니다.
• 플러그인을 사용하고 싶지 않다면, 예를 들어 fetchmail 플러그인을 사용하지 않으려면 ispconfig3_fetchmail을 생략하세요.
• 여러 개의 메일 서버를 사용하는 경우, ispconfig3_autoselect를 목록에 추가하고 $config['default_host']를 비워 두세요. ispconfig3_autoselect는 로그인하는 사용자에게 적합한 서버를 자동으로 선택합니다. Roundcube와 외부 메일 서버 간의 tls/ssl 연결을 활성화하려면 ispconfig3_autoselect/config/config.inc.php.dist의 자체 구성 파일을 편집할 수 있습니다.

구성 파일을 저장한 후, 웹메일 설정에 “계정”이라는 새 탭이 나타납니다:

완료되었습니다!

문제가 발생하면 https://github.com/w2c/ispconfig3_roundcube/wiki/Troubleshooting—FAQ의 문제 해결 FAQ를 확인하세요.

질문이나 의견이 있으시면 댓글로 남기거나 포럼 게시물을 작성할 수 있습니다.