메일 서버 · 2 min read · Sep 29, 2025

Debian 10에서 Modoboa로 메일 서버 설정하는 방법

Modoboa는 Linux용 오픈 소스 메일 서버 호스팅 및 관리 플랫폼입니다. Python으로 작성되었으며 이메일을 보내고 받기 위해 Postfix와 Dovecot을 사용합니다. Nginx 웹 서버와 MySQL/PostgreSQL 데이터베이스를 사용합니다. 무제한 메일박스와 무제한 메일 도메인을 생성할 수 있습니다. Let’s Encrypt와 통합하여 이메일 서버와 외부 네트워크 간의 모든 통신을 암호화할 수 있습니다. 도메인, 메일박스, 별칭 등을 관리하기 위한 웹 기반 관리 패널이 제공됩니다.

이 튜토리얼에서는 Debian 10 서버에 Modoboa를 설치하는 방법을 보여드리겠습니다.

필수 조건

  • Debian 10을 실행하는 서버.
  • 서버 IP를 가리키는 유효한 도메인 이름.
  • 서버에 구성된 루트 비밀번호가 있으며 루트로 로그인되어 있어야 합니다.

시작하기

시작하기 전에 다음 명령어로 시스템 패키지를 최신 버전으로 업데이트합니다:

apt-get update -y

다음으로, 다음 명령어로 필요한 다른 종속성을 설치합니다:

apt-get install git curl gnupg2 wget -y

다음으로, 다음 명령어로 시스템 호스트 이름을 설정합니다:

hostnamectl set-hostname modoboa.example.com

Modoboa 설치

다음으로, 다음 명령어로 Modoboa의 최신 버전을 다운로드합니다:

git clone https://github.com/modoboa/modoboa-installer

다운로드가 완료되면 Modoboa 디렉토리로 변경하고 다음 명령어로 구성을 확인합니다:

cd modoboa-installer  
./run.py --stop-after-configfile-check example.com

이렇게 하면 현재 작업 디렉토리에 새로운 구성 파일 installer.cfg가 생성됩니다.

다음으로, 다음 명령어로 구성 파일을 편집합니다:

nano installer.cfg

다음 줄을 변경합니다:

[certificate]
generate = true
type = letsencrypt

[letsencrypt]
email = [email protected]

[database]
engine = postgres
host = 127.0.0.1
install = true

파일을 저장하고 닫은 후 다음 명령어로 설치를 시작합니다:

./run.py --interactive example.com

설치가 완료되면 다음과 같은 출력이 표시됩니다:

Welcome to Modoboa installer!

Warning:
Before you start the installation, please make sure the following DNS records exist for domain 'modoboa.example.com':
  mail IN A   
       IN MX  modoboa.example.com.

Your mail server will be installed with the following components:
modoboa automx amavis clamav dovecot nginx razor postfix postwhite spamassassin uwsgi radicale opendkim
Do you confirm? (Y/n) Y
The process can be long, feel free to take a coffee and come back later ;)
Starting...
Generating new certificate using letsencrypt
Installing amavis
Installing spamassassin
Installing razor
Installing clamav
Installing modoboa
Installing automx
Installing radicale
Installing uwsgi
Installing nginx
Installing opendkim
Installing postfix
Installing postwhite
Installing dovecot
Congratulations! You can enjoy Modoboa at https://modoboa.example.com (admin:password)

Modoboa 웹 인터페이스에 접근하기

이제 웹 브라우저를 열고 URL https://modoboa.example.com을 입력합니다. Modoboa 로그인 페이지가 표시되어야 합니다:

Modoboa 로그인

기본 사용자 이름: admin, 비밀번호: password를 입력한 후 로그인 버튼을 클릭합니다. 다음 페이지에서 Modoboa 대시보드로 리디렉션됩니다:

Modoboa UI

주의 사항

현재 Modoboa 설치 프로그램에 버그가 있으며, 이는 이 가이드가 처음 작성되고 테스트된 이후에 도입되었습니다. 증상은 Modoboa GUI에 로그인한 후 ‘내부 서버 오류’ 메시지가 표시되는 것입니다. 이 문제의 해결 방법은 파일 /srv/modoboa/instance/instance/settings.py를 편집하는 것입니다.

nano /srv/modoboa/instance/instance/settings.py

그리고 다음과 같이 설정합니다:

USE_TZ = False

그런 다음 uwsgi를 재시작합니다:

service uwsgi restart

Modoboa 이슈 트래커에서 참조: https://github.com/modoboa/modoboa/issues/2286

결론

위의 게시물에서는 Debian 10 서버에 Modoboa를 설치하는 방법을 배웠습니다. 이제 첫 번째 도메인을 추가하고 다른 이메일 주소로 메일을 보낼 수 있습니다.

Share: X/Twitter LinkedIn

새 게시물을 받은 편지함에서 받기

스팸은 없습니다. 언제든지 구독 해지 가능합니다.