그누보드5 메일 안 보내질 때, SMTP Manager V1 무료(코어 수정 없이 설치)

📦 SMTP Manager V1.1.0 — 무료 공개 (2026년 5월)

다운로드 (GitHub Releases): https://github.com/wizardofcode-labs/gnuboard5-smtp-manager/releases

도움말 페이지: https://wizardofcode.notion.site/5-SMTP-Manager-30e0c5ce4548806f9219d18663ab0707

지원 환경: 그누보드5 5.4 이상 / 영카트5 / PHP 7.0 이상 (PHP 8.x 호환)

설치 방식: extend 방식 (코어 파일 수정 없음)

그누보드5 메일이 안 보내지는 이유

그누보드5나 영카트5로 사이트를 운영하다 보면 거의 모든 운영자가 한 번쯤 마주치는 문제가 있습니다.

회원가입 인증메일이 가지 않아 신규 가입이 막히는 상황
비밀번호 찾기 메일이 발송되지 않는 문제
발송된 메일이 모두 스팸함으로 분류되는 현상
네이버 메일에서 “안전하지 않은 메일” 경고가 표시되는 문제
호스팅사가 PHP mail() 함수를 차단하면서 메일 발송 자체가 막히는 경우

원인은 대부분 같습니다.
그누보드5는 기본적으로 PHP mail() 함수로 메일을 발송하는데, 이 방식은 SPF·DKIM 인증을 거치지 않아 최근의 메일 서비스 정책에서는 정상 메일로 인정받기 어렵습니다.
결국 외부 SMTP 서버(Gmail, 네이버, Daum, Google Workspace 등)를 경유해 발송하는 방식으로 전환해야 합니다.

기존 해결 방법의 한계

SIR(sir.kr) QA 게시판에 가보면 /lib/mailer.lib.php 파일을 직접 수정하는 팁이 다수 올라와 있습니다.
하지만 이 방식에는 근본적인 문제가 있습니다.

그누보드 업데이트 시 수정 내용이 원복됩니다. 업데이트할 때 해당 파일이 변경되면 같은 작업을 반복해야 합니다.
SMTP 설정값이 PHP 코드에 하드코딩됩니다. 서버 변경이나 비밀번호 변경 시 FTP로 파일을 직접 열어야 합니다.
발송 로그를 확인할 수 없습니다. 메일이 실제로 발송되었는지, 실패했는지 확인할 방법이 없습니다.
유지보수 시 다른 개발자가 수정 내역을 추적하기 어렵습니다.

SMTP Manager V1을 무료로 공개합니다

이 문제를 근본적으로 해결하기 위해 만든 플러그인이 SMTP Manager입니다.
그동안 유료로 판매해 왔지만, 그누보드/영카트 생태계에 기여하고자 V1 버전을 무료로 전환하여 공개합니다.

핵심 특징

1. extend 방식 — 코어 파일을 수정하지 않습니다
/extend 폴더에 플러그인 파일을 배치하는 그누보드 공식 확장 방식을 사용합니다. mailer.lib.php, common.php 등 코어 파일은 일절 건드리지 않으므로 그누보드 업데이트 시 충돌이 없습니다.

2. PHPMailer 기반의 안정적인 SMTP 발송
검증된 오픈소스 라이브러리 PHPMailer를 활용하여 Gmail, 네이버, Daum, Google Workspace 등 표준 SMTP 서버에 연결합니다.

3. 관리자 페이지에서 모든 설정 관리
SMTP 호스트, 포트, 인증 정보를 코드가 아닌 관리자 화면에서 입력합니다. 서버를 변경하거나 비밀번호를 바꿔도 PHP 파일을 열 필요가 없습니다.

4. 발송 로그 자동 기록
발송된 모든 메일의 수신자, 제목, 발송 시각, 성공/실패 여부가 관리자 화면에 기록됩니다. 문제가 발생했을 때 원인을 즉시 추적할 수 있습니다.

5. FTP 업로드만으로 설치 완료
별도의 컴파일이나 빌드 과정 없이 FTP로 업로드하면 관리자 메뉴에 “SMTP Manager”가 자동으로 추가됩니다.

V1에서 제공하는 기능

SMTP 서버 설정 및 연결 테스트
테스트 메일 발송 기능
발송 로그 확인
Gmail/네이버 앱 비밀번호 설정 안내
관리자 페이지 UI

지원 환경

그누보드5 5.4 이상 / 영카트5
PHP 7.0 이상 (PHP 8.x 호환)
지원 SMTP 서버: Gmail, 네이버, Daum, Google Workspace, 기타 표준 SMTP

오픈소스로 공개합니다 — GitHub Releases

단순히 무료로 배포하는 데 그치지 않고, 소스 코드 전체를 GitHub에 공개합니다.

👉 gnuboard5-smtp-manager (GitHub)

현재 최신 버전은 v1.1.0 (2026년 5월 9일 공개) — 첫 공개 릴리즈입니다.

코드를 직접 검토하고 설치하실 수 있으며, 사용 중 발견하신 버그나 개선 아이디어는 GitHub Issues에 남겨주세요. 가능한 범위에서 반영하겠습니다.

버그 제보: GitHub Issues
기능 요청: GitHub Issues
설치 가이드: 저장소의 README.md 참고
상세 사용법 및 관리자 화면 캡처: 도움말 페이지

그누보드/영카트 생태계에 작게나마 기여하고자 V1은 오픈소스로 유지하며, 캠페인 발송·수신거부·예약 발송 등 고급 기능을 담은 V2는 유료 버전으로 별도 운영합니다.

더 많은 기능이 필요하다면 — V2 (유료)

V1은 시스템 메일(회원가입, 비밀번호 찾기 등) 발송 문제를 해결하는 데 초점이 맞춰진 무료 버전입니다.
만약 다음과 같은 기능이 필요하시다면 유료 버전인 SMTP Manager V2를 검토해 보세요.

관리자 화면에서 직접 작성·발송하는 뉴스레터 / 캠페인 발송 시스템
수신거부 관리 — 정보통신망법 준수, 수신거부 링크 자동 삽입, 거부 회원 자동 제외
예약 발송 — 지정 날짜·시간 자동 발송, Cron 또는 방문자 트리거 방식
발송 한도·속도 자동 제어 — Gmail 500건/일, Workspace 2,000건/일 등 자동 관리
메일 스킨 3종 기본 제공 — Default, Modern, Minimal
개인화 변수 지원 — {이름}, {아이디} 등

👉 SMTP Manager V2 상세 보기

지금 바로 시작하기

GitHub Releases에서 최신 버전(v1.1.0) 다운로드
→ https://github.com/wizardofcode-labs/gnuboard5-smtp-manager/releases
도움말 페이지에서 설치 가이드 확인
→ https://wizardofcode.notion.site/5-SMTP-Manager-30e0c5ce4548806f9219d18663ab0707
그누보드 /extend 폴더에 업로드
관리자 페이지에서 SMTP 정보 입력 후 테스트 메일 발송

설치가 어렵거나 직접 설정할 시간이 부족하시다면, 크몽 설치 대행 서비스도 운영하고 있습니다.
원격으로 1시간 내에 설치·설정·테스트 발송까지 모두 처리해 드립니다.

👉 크몽 설치 대행 서비스 보기

마치며

오랫동안 그누보드/영카트 생태계의 도움을 받아 개발해 온 만큼, V1을 무료로 공개하는 것이 작게나마 기여하는 방법이라고 생각했습니다. 메일 발송 문제로 고생하시는 분들께 도움이 되기를 바랍니다.

설치 중 문제가 있거나 기능 관련 피드백이 있다면 GitHub Issues 또는 댓글로 남겨주세요. V2 개발에도 반영하겠습니다.

개발: K3SOFT / WizardOfCode
웹사이트: https://wizardofcode.kr
카카오톡 채널: https://pf.kakao.com/_mkUxdn