기존 메일 호스팅
사업자가 제공하는 IMAP/SMTP 서버 주소, 포트, 보안 방식, 계정 정보를 사용합니다. 서버 관리 부담이 적어 시작할 때 적합합니다.
SETUP GUIDE · IMAP + SMTP
기존 메일 호스팅 또는 직접 운영하는 메일 서버를 안전하게 연결하는 순서입니다. 이 안내는 서버를 자동 설치하거나 설정을 변경하지 않습니다.
연결 정보는 웹 서버 환경 변수에 직접 설정해야 합니다. 비밀번호를 이 페이지나 브라우저에 입력하지 마세요.
도메인 주소를 새로 만들지, 기존 외부 계정을 연결할지 먼저 구분하세요.
사업자가 제공하는 IMAP/SMTP 서버 주소, 포트, 보안 방식, 계정 정보를 사용합니다. 서버 관리 부담이 적어 시작할 때 적합합니다.
도메인 구입처에서 웹메일을 신청하고 메일함을 만든 뒤, 상품이 IMAP 수신과 SMTP 인증 발신을 허용하면 연결할 수 있습니다. 연결 가능 여부와 DNS 관리 위치를 먼저 확인하세요.
고정 공인 IP가 있고 DNS, 보안 업데이트, 스팸 대응, 백업, IP 평판을 지속적으로 관리할 수 있는 경우에 선택합니다.
주소 만들기와 연결은 별도입니다: webmaster@netcity.co.kr 같은 주소가 필요하면 먼저 도메인 메일 서비스에서 주소·메일함을 생성하고 DNS를 설정해야 합니다. Gmail 등 이미 가진 계정을 이 사이트에서 조회하는 방법과의 차이는 도메인 메일 안내에서 확인하세요.
시작 전 확인: 제공업체에서 앱 비밀번호 또는 전용 계정이 필요한지, IMAP/SMTP와 외부 접속이 허용되는지 확인하세요. 자체 서버는 고정 공인 IP, PTR(역방향 DNS), 포트 25 정책을 먼저 확인해야 합니다. 유동 IP에서 도메인 메일을 사용하는 방법은 유동 IP 메일 연결 가이드를 확인하세요.
직접 운영은 메일 소프트웨어 설치 외에도 네트워크·DNS·보안 운영이 필요합니다.
고정 IP만으로 안정적인 메일 송수신이 보장되지는 않습니다. PTR 설정 권한, ISP의 포트 정책, IP 평판, 수신 사업자의 필터링을 먼저 확인하세요. 메일 서버 운영 경험이 없다면 관리형 외부 메일 호스팅을 사용하는 편이 안전하고 간편할 수 있습니다.
도메인 DNS는 도메인 사업자 또는 DNS 호스팅 업체에서 설정합니다.
DNS 레코드 값은 도메인과 메일 사업자마다 다릅니다. 예시 값을 그대로 복사하지 말고, 현재 사용 중인 업체가 제공하는 정확한 값을 사용하세요.
MX 변경 전 주의: MX는 도메인의 새 수신 메일을 어느 사업자로 전달할지 결정합니다. 기존 메일 서비스를 사용 중이라면 전환 시 메일이 다른 곳으로 전달될 수 있으므로, 메일 이전·공존 계획과 현재 DNS 관리 위치를 확인한 뒤 변경하세요. IMAP/SMTP만 연결하려는 경우 MX 변경이 필요하지 않을 수도 있습니다.
아래 항목은 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 검증을 끄지 마세요.
설정 확인과 실제 로그인·전송 확인은 별도 단계입니다.
상태 점검이 정상이어도 호스트 이름, 비밀번호, 네트워크 방화벽, 인증서, DNS가 올바르다는 뜻은 아닙니다. 실제 수신과 테스트 발신까지 확인해야 연결이 완료됩니다.