변경 기록

업데이트는 설치 폴더에서 sudo ./install.sh update — 바뀐 점을 보여 주고, 업데이트 직전에 백업하며, 안 되면 저절로 원래 버전으로 돌아갑니다.

0.9.5 2026-09-29

새 버전 알림을 기본으로 켬 — 하루 한 번 소개 사이트 https://mailer.rousme.com/latest.json 을 확인 (보내는 정보 없음). 끄려면 mailer.env 에 UPDATE_CHECK_URL=off
소개 웹사이트 https://mailer.rousme.com (가이드·변경 기록)

광고 메일 보내는 시각 설정 AD_HOURS (mailer.env, 기본 8-21, off 면 제한 없음 — 전자우편은 법의 야간 광고 별도 동의 예외)

사전 점검: 서버 DNS 가 시간 초과되면 그 오류 문구를 PTR 이름으로 보여 주던 것
안내 문구: 새 서버로 옮긴 뒤 SPF 의 ip4 도 새 IP 로, 비밀번호 보는 명령에 sudo·"이 폴더에서", 이미지 받기 실패 때 docker login 대신 토큰 입력 안내
가이드: 처음 보는 사람 검토 두 번 반영 (MX 를 이 서버로 두면 답장이 사라짐, 실서버 첫 발송 확인 체크, 복원 때 설치값 선택, 용어 추가, 587 로 보내면 발송 제외·하루 한도·광고 검사가 적용되지 않음, 새 서버로 옮길 때 버전 맞추기, 연동 가이드의 야간 광고 설명 등)
설치 끝 화면: 이미 DMARC 가 있으면 rua 에 이 서버 주소를 더하라고 안내, 명령 예에 sudo
복원: 설치값 질문에 "새 서버로 옮기는 중이면 N"

광고를 밤에도 보내려면 업데이트 뒤 mailer.env 에 AD_HOURS=off 를 넣고 sudo ./install.sh (기본은 지금처럼 8~21시)
0.9.2 에서 올리면 설치 폴더의 install.sh·compose.yaml 도 0.9.3 것으로 바뀝니다 (이전 것은 .versions/0.9.2/)

관리 화면 [도움말] 탭: 설치·DNS 와 인증·IP 예열·법 준수·사용법·운영과 문제 해결·발송 API 연동 가이드 (목차·검색, [설치 확인] 표 등에서 바로가기)
사용권 계약(초안)·제3자 구성 요소 고지 — 화면 아래 링크, 이미지 안 /srv/licenses/ 에 라이선스 원문
배포 묶음 mailer-kit-<버전>.tar.gz (풀면 mailer-kit/ 설치 폴더, 가이드 PDF 포함)
sudo ./install.sh update·rollback 이 설치 폴더의 install.sh·compose.yaml 도 그 버전 것으로 바꿈 (이전 것은 .versions/<버전>/)

새로 설치할 때 비공개 이미지를 받지 못하면(토큰 없음) 같은 버전 이미지가 서버에 있어도 소스 빌드로 넘어가던 것 — 판매자 토큰으로 잠깐 로그인해 받고, 못 받으면 이미 있는 이미지로 띄움

0.9.1 이하에서 올릴 때는 새 install.sh 가 아직 없으므로 업데이트 뒤 설치 파일은 그대로입니다. 배포 묶음의 install.sh·compose.yaml 로 한 번 바꿔 주세요 (판매자)

새로 설치할 때 MAILER_VERSION=latest 면 그때의 최신 릴리스 번호로 바꿔 적어 고정 (구매자 서버가 뜻하지 않게 바뀌지 않게)

DB 형식이 바뀝니다 (스키마 1 → 2). sudo ./install.sh rollback 으로 0.9.0 에 되돌리면 DB 는 업데이트 직전 백업으로 돌아갑니다

설치: install.sh 사전 점검·설정 질문·Docker 설치·이미지 받기·DNS 안내, HTTPS 자동(caddy), [설치 확인] 탭(DNS·인증서·버전)
로그인·권한: 여러 계정(관리자·발송 담당·보기 전용), 활동 기록, sudo ./install.sh password
발송: 테스트/실서버 모드, 웹 대량 발송(첨부·속도 제한·하루 한도·발송 제외 목록), 메일 서비스별 집계, DMARC 보고서, James 설정 변경
발송 API: API 키, 한 통씩 보내기·결과 조회·중복 방지(Idempotency-Key), 템플릿, 거래성/광고 규칙, 연동 가이드
주소록: 엑셀 CSV 가져오기·내보내기, 그룹, 광고 수신 동의 기록, 그룹 발송 개인화, 주소록 API, 2년 수신 동의 확인 안내, 광고 8~21시
버전 표시: 화면 위쪽·[설치 확인]·sudo ./install.sh status
백업: 매일 03:30 자동·sudo ./install.sh backup·[백업] 탭(관리자, 비밀번호로 암호화해 내려받기)
복원: sudo ./install.sh restore <파일> (같은 서버 되돌리기·새 서버로 옮기기, 실패하면 저절로 원래대로)
업데이트: sudo ./install.sh update [버전]·sudo ./install.sh rollback (업데이트 직전 백업, 안 되면 저절로 되돌림), 새 버전 알림(UPDATE_CHECK_URL)

구매자 서버는 mailer.env 의 MAILER_VERSION 을 정확한 버전(예: 0.9.0)으로 고정한다 (edge·latest 는 판매자 시험용)