Ghost Email 설정 가이드

Tom Cha

Nov 18, 2024 — 4 min read

다음은 Ghost에 이메일 발송 기능을 설정하는 방법을 안내합니다. 이메일 발송은 사용자 가입 확인, 비밀번호 재설정 등과 같은 알림을 처리하는 데 필수적입니다.

이메일을 자체 호스팅을 하기에는 여러 문제가 발생할 수 있기에 여기서는 fastcomet이라는 호스팅업체에서 호스팅할 때 제공되는 이메일을 사용한다는 가정하에 작성하였습니다. (Ghost는 호스팅업체가 아닌 자체 서버에서 작동하는 것 가정)

1. SMTP 설정 준비

Ghost는 자체 이메일 서버를 포함하지 않으므로 외부 SMTP 서버를 사용해야 합니다. SMTP 설정은 Ghost의 설정 파일(config.production.json)에서 지정됩니다.

필요한 정보

SMTP 호스트 (SMTP Server): 이메일 제공자의 SMTP 서버 주소.
SMTP 포트 (SMTP Port):
- 일반 포트: 587 (STARTTLS)
- 암호화된 포트: 465 (SSL/TLS)
SMTP 사용자명 (SMTP Username): 이메일 계정 주소 (예: info@yourdomain.com).
SMTP 비밀번호 (SMTP Password): 이메일 계정 비밀번호.
보안 방식: true (SSL/TLS 사용) 또는 false (암호화 미사용).

2. SMTP 설정 파일 수정

Ghost 설정 파일에 SMTP 정보를 추가합니다. Ghost 설치 경로에서 작업해야 합니다.

설정 파일 열기

Ghost 설치 디렉토리로 이동:

cd /var/www/ghost

설정 파일 편집:

nano config.production.json

SMTP 설정 추가

SMTP 정보를 다음과 같이 입력합니다:

예: Gmail SMTP 설정

"mail": {
  "transport": "SMTP",
  "options": {
    "service": "Gmail",
    "auth": {
      "user": "your-email@gmail.com",
      "pass": "your-email-password"
    }
  }
}

예: FastComet SMTP 설정

"mail": {
  "transport": "SMTP",
  "options": {
    "host": "mail.yourdomain.com",
    "port": 465,
    "secure": true,
    "auth": {
      "user": "info@yourdomain.com",
      "pass": "your-email-password"
    }
  }
}

예: SendGrid SMTP 설정

"mail": {
  "transport": "SMTP",
  "options": {
    "host": "smtp.sendgrid.net",
    "port": 587,
    "secure": false,
    "auth": {
      "user": "apikey",
      "pass": "your-sendgrid-api-key"
    }
  }
}

파일 저장 및 종료

저장: Ctrl + O → Enter.
종료: Ctrl + X.

3. 설정 적용

설정을 저장한 후 Ghost 서버를 재시작해야 변경 사항이 적용됩니다.

서버 재시작:

ghost restart

설정이 올바르게 적용되었는지 테스트:

Ghost 관리자 페이지에서 **"Settings → Email Newsletter"**로 이동.
"Test email" 버튼을 클릭하여 테스트 이메일을 보냅니다.

4. 웹메일 서비스 접속

FastComet과 같은 호스팅 서비스를 사용하는 경우, 웹메일 서비스에서 이메일 계정을 생성해야 합니다.

FastComet에서 이메일 계정 생성

FastComet의 cPanel에 로그인.
Email Accounts 섹션으로 이동.
새 이메일 계정 생성:
- 예: info@yourdomain.com.
생성 후 SMTP 설정 정보를 확인하여 Ghost 설정에 적용.

5. 이메일 발송 문제 해결

1) 이메일 발송 실패

원인: SMTP 설정 오류 또는 포트/보안 설정 문제.
해결: config.production.json의 SMTP 정보를 확인하고 포트와 보안 설정을 정확히 입력하세요.

2) 스팸 메일로 처리됨

원인: DNS 레코드(SPF, DKIM, DMARC) 설정 누락.
해결: FastComet 또는 도메인 관리자 페이지에서 아래 레코드를 추가:
- SPF: v=spf1 include:your-smtp-provider.com ~all
- DKIM: 제공된 DKIM 키 추가.
- DMARC: v=DMARC1; p=none; rua=mailto:admin@yourdomain.com.

6. 외부 이메일 클라이언트 연결 (선택 사항)

Ghost가 아닌 Gmail, Outlook 등에서 FastComet 이메일을 사용하려면 아래 정보를 사용하세요:

수신 메일 서버 (IMAP/POP3):
- IMAP: mail.yourdomain.com, 포트 993 (SSL)
- POP3: mail.yourdomain.com, 포트 995 (SSL)
발신 메일 서버 (SMTP):
- SMTP: mail.yourdomain.com, 포트 465 (SSL) 또는 587 (TLS).

7. 참고 SMTP 서비스

Gmail: 개인용 및 소규모 테스트에 적합.
SendGrid: 대량 이메일 발송에 최적화.
FastComet: 호스팅 제공자의 SMTP 서버 사용.

참고

문제가 해결되지 않으면 Ghost 로그 파일(/var/www/ghost/content/logs/) 또는 SMTP 서버의 에러 로그를 확인