Roundcube

Roundcube 접속

• 브라우저에서 다음 URL을 여세요: https://<SERVER_IP>
• 설치에는 자체 서명 TLS 인증서를 사용하므로 브라우저에 보안 경고가 표시됩니다. 계속하려면 인증서를 수락하세요.
• 80 포트로 들어온 HTTP 요청은 자동으로 HTTPS로 리디렉션됩니다.

로그인

• Roundcube는 메일박스 계정을 생성하거나 저장하지 않습니다.
• 구성한 IMAP 서버에 있는 기존 메일박스의 사용자 이름과 비밀번호로 로그인합니다.

메일 서버 구성

메일 서버 연결 설정은 다음 위치에 저장됩니다: /root/roundcube/.env

주요 설정:

• IMAP 호스트: IMAP_HOST
• IMAP 포트: IMAP_PORT
• SMTP 호스트: SMTP_HOST
• SMTP 포트: SMTP_PORT
• 사용자 이름 도메인: USERNAME_DOMAIN

기본 설정에는 자리표시자 값이 들어 있습니다:

IMAP_HOST=ssl://mail.example.org
IMAP_PORT=993

SMTP_HOST=tls://mail.example.org
SMTP_PORT=587

실제 메일 서버 호스트명으로 바꾸세요.

설정을 변경한 뒤 다음 명령으로 적용합니다:

cd /root/roundcube && docker compose up -d

TLS 연결 유형

메일 서버에 맞는 접두사를 사용하세요:

• ssl://: Implicit TLS, typically used with IMAP port 993 or SMTP port 465.
• tls://: STARTTLS, typically used with IMAP port 143 or SMTP port 587.

자체 서명 메일 서버 인증서

IMAP 또는 SMTP 서버가 자체 서명 인증서를 사용하면 Roundcube가 연결을 거부할 수 있습니다.

선택적 TLS 검증 설정은 다음 위치에 있습니다: /root/roundcube/config/custom.inc.php

해당 IMAP 또는 SMTP 연결 옵션은 메일 서버와 네트워크를 신뢰할 수 있을 때만 주석을 해제하고 설정하세요.

설정을 적용하세요:

cd /root/roundcube && docker compose restart roundcube

플러그인과 스킨

기본 설치에서 활성화되는 항목:

• archive
• zipdownload

Plugins are configured through the PLUGINS variable in: /root/roundcube/.env

예시:

PLUGINS=archive,zipdownload,managesieve

변경 사항을 적용하세요:

cd /root/roundcube && docker compose up -d

Bundled plugins such as managesieve, markasjunk, 그리고 enigma can be enabled by adding them to PLUGINS, when supported by the image.

For third-party plugins, add them to ROUNDCUBEMAIL_COMPOSER_PLUGINS in the Compose file and include their names in PLUGINS.

Roundcube 관리

컨테이너 상태 확인:

cd /root/roundcube && docker compose ps

로그 보기:

cd /root/roundcube && docker compose logs -f

Roundcube 다시 시작:

cd /root/roundcube && docker compose restart roundcube

스택 중지:

cd /root/roundcube && docker compose down

스택 시작:

cd /root/roundcube && docker compose up -d

중요한 파일 및 디렉토리

• 설치 경로: /root/roundcube
• Compose 파일: /root/roundcube/docker-compose.yml
• 환경 파일: /root/roundcube/.env
• 추가 설정: /root/roundcube/config/custom.inc.php
• 데이터베이스 볼륨: /var/lib/docker/volumes/roundcube_db_data
• Nginx 설정: /etc/nginx/sites-available/roundcube
• TLS 인증서: /etc/nginx/ssl/roundcube.crt
• TLS 개인 키: /etc/nginx/ssl/roundcube.key

도메인 및 HTTPS

1. Point your domain to the server's IP address (e.g., yourdomain.com;).

2. Certbot 설치:

apt update
apt install -y certbot python3-certbot-nginx

3. Edit NGINX config and replace both server_name _; entries with your domain (e.g., server_name yourdomain.com;):

vim /etc/nginx/sites-available/roundcube

4. TLS 인증서를 발급합니다:

certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com

5. 편집하세요: /etc/nginx/sites-available/roundcube 그리고 다음을 업데이트하세요: ssl_certificate 와 ssl_certificate_key Let's Encrypt 인증서를 사용하도록 지시문을.

Before:
    ssl_certificate     /etc/nginx/ssl/roundcube.crt;
    ssl_certificate_key /etc/nginx/ssl/roundcube.key;
After:
    ssl_certificate  /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;

6. 설정을 검사합니다:

nginx -t

7. NGINX를 다시 로드합니다:

systemctl reload nginx

8. 브라우저를 열고 다음 주소로 접속하세요. https://yourdomain.com

참고

• Roundcube is publicly accessible through Nginx on ports 80 와 443.
• The Roundcube container itself listens only on 127.0.0.1:8000.
• MariaDB는 Docker 내부 서비스이며 호스트에 직접 노출되지 않습니다.
• 기본 웹 인터페이스는 자체 서명 TLS 인증서를 사용합니다.
• The upload limit is set to 25 MB; increase both UPLOAD_MAX_FILESIZE and Nginx's client_max_body_size for larger uploads.
• 필요에 따라 Roundcube 설정을 변경하세요.