넷시티 메시지&메일함메일빌더 플랫폼 메일함으로 돌아가기

SETUP GUIDE · IMAP + SMTP

메일 서버 연결 안내

기존 메일 호스팅 또는 직접 운영하는 메일 서버를 안전하게 연결하는 순서입니다. 이 안내는 서버를 자동 설치하거나 설정을 변경하지 않습니다.

이 페이지에서 서버 설치를 실행하지 않습니다

연결 정보는 웹 서버 환경 변수에 직접 설정해야 합니다. 비밀번호를 이 페이지나 브라우저에 입력하지 마세요.

설정 안내
01

메일 서비스 선택

도메인 주소를 새로 만들지, 기존 외부 계정을 연결할지 먼저 구분하세요.

간편 운영

기존 메일 호스팅

사업자가 제공하는 IMAP/SMTP 서버 주소, 포트, 보안 방식, 계정 정보를 사용합니다. 서버 관리 부담이 적어 시작할 때 적합합니다.

도메인 메일

도메인 구입처 웹메일

도메인 구입처에서 웹메일을 신청하고 메일함을 만든 뒤, 상품이 IMAP 수신과 SMTP 인증 발신을 허용하면 연결할 수 있습니다. 연결 가능 여부와 DNS 관리 위치를 먼저 확인하세요.

구입처 웹메일 설정 순서 보기 ↗

직접 관리

Postfix + Dovecot

고정 공인 IP가 있고 DNS, 보안 업데이트, 스팸 대응, 백업, IP 평판을 지속적으로 관리할 수 있는 경우에 선택합니다.

고정 IP 메일 서버 구축 준비 ↗

주소 만들기와 연결은 별도입니다: webmaster@netcity.co.kr 같은 주소가 필요하면 먼저 도메인 메일 서비스에서 주소·메일함을 생성하고 DNS를 설정해야 합니다. Gmail 등 이미 가진 계정을 이 사이트에서 조회하는 방법과의 차이는 도메인 메일 안내에서 확인하세요.

시작 전 확인: 제공업체에서 앱 비밀번호 또는 전용 계정이 필요한지, IMAP/SMTP와 외부 접속이 허용되는지 확인하세요. 자체 서버는 고정 공인 IP, PTR(역방향 DNS), 포트 25 정책을 먼저 확인해야 합니다. 유동 IP에서 도메인 메일을 사용하는 방법은 유동 IP 메일 연결 가이드를 확인하세요.

IP

고정 공인 IP 환경에서 메일 서버 구축

직접 운영은 메일 소프트웨어 설치 외에도 네트워크·DNS·보안 운영이 필요합니다.

1. 회선과 서버 준비서버 운영이 허용된 고정 공인 IP인지 확인하고, 인터넷 사업자의 SMTP 발신 포트 25 제한과 서버 호스팅 정책을 확인합니다. 안정적인 운영 환경과 백업 저장 공간도 준비합니다.
2. 메일 구성요소 설치일반적인 Linux 구성은 Postfix를 SMTP 수신·전달(MTA)에, Dovecot을 IMAP 메일함 접근에 사용합니다. 지원 중인 OS 저장소의 패키지와 보안 업데이트를 이용하고, 서버별 공식 설치 지침을 따릅니다.
3. 도메인과 DNS 연결메일 호스트 이름의 A/AAAA, MX, 발신 IP의 PTR을 일관되게 구성하고, 제공자별 SPF·DKIM·DMARC 레코드를 설정합니다. 기존 DNS/MX를 변경하기 전 메일 이전·수신 중단 가능성을 점검합니다.
4. 암호화와 접근 제어신뢰된 TLS 인증서를 적용하고 필요한 SMTP 수신·제출 및 IMAP 포트만 방화벽에 허용합니다. 공개 릴레이가 되지 않도록 SMTP 인증·전달 정책을 제한하고 운영체제와 메일 소프트웨어를 최신 보안 업데이트로 유지합니다.
5. 스팸·백업·모니터링수신 스팸 필터링, 발신 속도·평판 관리, 큐와 디스크 사용량 모니터링, 메일함 및 설정 백업과 복구 절차를 마련합니다. 구축 뒤 외부 도메인 간 수신·발신, SPF/DKIM/DMARC 결과를 확인합니다.
6. 메일빌더에 연결서버가 IMAP과 인증된 SMTP 연결을 제공하면 이 사이트의 환경 변수에 접속 정보를 설정할 수 있습니다. 메일빌더는 메일 서버를 설치하거나 DNS·메일함을 자동 구성하지 않습니다.

고정 IP만으로 안정적인 메일 송수신이 보장되지는 않습니다. PTR 설정 권한, ISP의 포트 정책, IP 평판, 수신 사업자의 필터링을 먼저 확인하세요. 메일 서버 운영 경험이 없다면 관리형 외부 메일 호스팅을 사용하는 편이 안전하고 간편할 수 있습니다.

02

도메인과 발신 인증 준비

도메인 DNS는 도메인 사업자 또는 DNS 호스팅 업체에서 설정합니다.

MX도메인으로 들어오는 메일을 수신 서버로 안내합니다. 사용 중인 메일 제공자의 값으로 설정하세요.
SPF도메인에서 메일 발신이 허용된 서버를 지정합니다. 기존 SPF가 있으면 새 레코드를 중복 생성하지 말고 합쳐야 합니다.
DKIM메일 서버가 서명한 공개키를 DNS에 게시합니다. 키와 레코드 값은 메일 제공자 안내를 따르세요.
DMARCSPF/DKIM 인증 결과에 대한 처리 정책과 보고 방법을 정합니다. 모니터링부터 시작해 단계적으로 강화하세요.
TLS / PTR서버 인증서는 IMAP/SMTP 암호화에 사용합니다. 자체 서버는 발신 IP의 PTR과 서버 이름도 사업자 및 수신 서버 요구사항에 맞춰 확인하세요.

DNS 레코드 값은 도메인과 메일 사업자마다 다릅니다. 예시 값을 그대로 복사하지 말고, 현재 사용 중인 업체가 제공하는 정확한 값을 사용하세요.

MX 변경 전 주의: MX는 도메인의 새 수신 메일을 어느 사업자로 전달할지 결정합니다. 기존 메일 서비스를 사용 중이라면 전환 시 메일이 다른 곳으로 전달될 수 있으므로, 메일 이전·공존 계획과 현재 DNS 관리 위치를 확인한 뒤 변경하세요. IMAP/SMTP만 연결하려는 경우 MX 변경이 필요하지 않을 수도 있습니다.

03

웹 서버에 연결 정보 설정

아래 항목은 PHP가 실행되는 서버 환경 변수로 설정합니다.

MAIL_IMAP_HOST받은 메일을 확인할 IMAP 호스트 이름
MAIL_IMAP_PORTIMAP 포트. 기본값 993 (TLS)
MAIL_IMAP_SECURITYssl, starttls, none 중 하나. 기본값 ssl; 제공업체 설정과 일치시킵니다.
MAIL_IMAP_USER / MAIL_IMAP_PASSWORDIMAP 계정 이름과 비밀번호 또는 앱 비밀번호
MAIL_SMTP_HOST메일 발신용 SMTP 호스트 이름
MAIL_SMTP_PORTSMTP 제출 포트. 보통 587 (STARTTLS) 또는 465 (TLS)
MAIL_SMTP_SECURITYstarttls 또는 ssl. 기본값 starttls; 포트 및 제공업체 설정과 일치시킵니다.
MAIL_SMTP_USER / MAIL_SMTP_PASSWORDSMTP 계정 이름과 비밀번호 또는 앱 비밀번호
MAIL_FROM_ADDRESS / MAIL_FROM_NAMESMTP 계정에서 발신이 허용된 주소와 메일에 표시할 이름
APP_USERNAME / APP_PASSWORD메일·푸시 화면 접근 계정. 둘 다 설정하고 비밀번호는 16자 이상으로 사용하세요.
PUSH_SERVER_URLGotify 서버의 HTTPS 기본 주소 (예: https://push.netcity.co.kr)
PUSH_APP_TOKENGotify 애플리케이션 토큰. 푸시 메시지 전송에 사용합니다.
PUSH_CLIENT_TOKENGotify 클라이언트 토큰. 푸시 메시지 수신에 사용합니다.
PUSH_APP_ID선택 항목. Gotify 애플리케이션 ID를 설정하면 해당 앱에서 보낸 메시지를 대화에서 구분합니다.
설정 위치와 적용

환경 변수는 Apache 또는 PHP-FPM 등 실제 PHP 실행 환경에 설정하고, 변경 후 해당 서비스를 재시작하세요. 웹 공개 폴더에 비밀번호가 담긴 파일을 두지 말고, 설정 화면·소스 코드·저장소에도 자격 증명을 넣지 마세요. 호스팅 환경에서는 사업자가 제공하는 비밀 환경 변수 관리 방법을 따르세요.

현재 연결 범위: 서버 환경 변수에 설정된 한 계정을 공용으로 연결합니다. 사용자별 로그인 계정·메일함 연결, 다중 계정 관리 및 OAuth 전용 인증은 아직 제공하지 않습니다. 제공업체가 OAuth만 허용한다면 현재 방식으로 연결할 수 없습니다.

PHP IMAP, OpenSSL, DOM 확장이 필요합니다. 파일 첨부를 사용하려면 PHP의 upload_max_filesize를 10MB 이상, post_max_size를 12MB 이상으로 설정하세요. IMAP/SMTP 보안 방식은 서버 설정과 일치해야 합니다. Gotify 토큰은 웹 서버 환경 변수에만 보관하고, 인증서 검증 오류를 해결하려고 TLS 검증을 끄지 마세요.

04

설정 상태와 실제 송수신 검증

설정 확인과 실제 로그인·전송 확인은 별도 단계입니다.

  1. PHP 확장 및 환경 변수: 연결 상태 점검에서 필수 설정 누락을 확인합니다. 이 점검은 자격 증명으로 메일 서버에 로그인하거나 메일을 보내지는 않습니다.
  2. 받기: 메일 화면에 로그인한 뒤 받은편지함을 새로고침해 IMAP 연결과 메일함 접근을 확인합니다.
  3. 보내기: 통제 가능한 본인 주소로 테스트 메일을 보내고, 수신 여부와 스팸함 분류를 확인합니다.
  4. 푸시: 푸시 사용 및 연동 안내를 따라 설정하고, 연결 상태 점검 후 푸시 메뉴에서 테스트 알림을 보냅니다.
  5. 인증·운영: SPF/DKIM/DMARC 결과, TLS 인증서, 발신 IP/PTR, 접근 보호, 백업·보관 정책을 확인합니다.

상태 점검이 정상이어도 호스트 이름, 비밀번호, 네트워크 방화벽, 인증서, DNS가 올바르다는 뜻은 아닙니다. 실제 수신과 테스트 발신까지 확인해야 연결이 완료됩니다.