기존 메일 호스팅
사업자가 제공하는 IMAP/SMTP 서버 주소, 포트, 보안 방식, 계정 정보를 사용합니다. 서버 관리 부담이 적어 시작할 때 적합합니다.
SETUP GUIDE · IMAP + SMTP
메일 서버 연결 안내
기존 메일 호스팅 또는 직접 운영하는 메일 서버를 안전하게 연결하는 순서입니다. 이 안내는 서버를 자동 설치하거나 설정을 변경하지 않습니다.
이 페이지에서 서버 설치를 실행하지 않습니다
설정 안내
연결 정보는 웹 서버 환경 변수에 직접 설정해야 합니다. 비밀번호를 이 페이지나 브라우저에 입력하지 마세요.
01
메일 서비스 선택
메일을 이미 사용 중이라면 호스팅 사업자의 연결 정보를 먼저 확인하세요.
시작 전 확인: 제공업체에서 앱 비밀번호 또는 전용 계정이 필요한지, 외부 IMAP/SMTP 접속이 허용되는지 확인하세요. 자체 서버는 고정 IP, PTR(역방향 DNS), 포트 25 정책을 먼저 확인해야 합니다. 유동 IP·CGNAT에서 사용할 수 있는 기기 메시지와 PHON 안내는 연결 방식 안내를 확인하세요.
02
도메인과 발신 인증 준비
도메인 DNS는 도메인 사업자 또는 DNS 호스팅 업체에서 설정합니다.
MX도메인으로 들어오는 메일을 수신 서버로 안내합니다. 사용 중인 메일 제공자의 값으로 설정하세요.
SPF도메인에서 메일 발신이 허용된 서버를 지정합니다. 기존 SPF가 있으면 새 레코드를 중복 생성하지 말고 합쳐야 합니다.
DKIM메일 서버가 서명한 공개키를 DNS에 게시합니다. 키와 레코드 값은 메일 제공자 안내를 따르세요.
DMARCSPF/DKIM 인증 결과에 대한 처리 정책과 보고 방법을 정합니다. 모니터링부터 시작해 단계적으로 강화하세요.
TLS / PTR서버 인증서는 IMAP/SMTP 암호화에 사용합니다. 자체 서버는 발신 IP의 PTR과 서버 이름도 사업자 및 수신 서버 요구사항에 맞춰 확인하세요.
DNS 레코드 값은 도메인과 메일 사업자마다 다릅니다. 예시 값을 그대로 복사하지 말고, 현재 사용 중인 업체가 제공하는 정확한 값을 사용하세요.
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 실행 환경에 설정하고, 변경 후 해당 서비스를 재시작하세요. 웹 공개 폴더에 비밀번호가 담긴 파일을 두지 말고, 설정 화면·소스 코드·저장소에도 자격 증명을 넣지 마세요. 호스팅 환경에서는 사업자가 제공하는 비밀 환경 변수 관리 방법을 따르세요.
PHP IMAP, OpenSSL, DOM 확장이 필요합니다. 파일 첨부를 사용하려면 PHP의 upload_max_filesize를 10MB 이상, post_max_size를 12MB 이상으로 설정하세요. IMAP/SMTP 보안 방식은 서버 설정과 일치해야 합니다. Gotify 토큰은 웹 서버 환경 변수에만 보관하고, 인증서 검증 오류를 해결하려고 TLS 검증을 끄지 마세요.
04
설정 상태와 실제 송수신 검증
설정 확인과 실제 로그인·전송 확인은 별도 단계입니다.
- PHP 확장 및 환경 변수: 연결 상태 점검에서 필수 설정 누락을 확인합니다. 이 점검은 자격 증명으로 메일 서버에 로그인하거나 메일을 보내지는 않습니다.
- 받기: 메일 화면에 로그인한 뒤 받은편지함을 새로고침해 IMAP 연결과 메일함 접근을 확인합니다.
- 보내기: 통제 가능한 본인 주소로 테스트 메일을 보내고, 수신 여부와 스팸함 분류를 확인합니다.
- 푸시: 푸시 사용 및 연동 안내를 따라 설정하고, 연결 상태 점검 후 푸시 메뉴에서 테스트 알림을 보냅니다.
- 인증·운영: SPF/DKIM/DMARC 결과, TLS 인증서, 발신 IP/PTR, 접근 보호, 백업·보관 정책을 확인합니다.
상태 점검이 정상이어도 호스트 이름, 비밀번호, 네트워크 방화벽, 인증서, DNS가 올바르다는 뜻은 아닙니다. 실제 수신과 테스트 발신까지 확인해야 연결이 완료됩니다.