• 1.0.1

    hanyul released this 2026-09-28 17:19:56 +09:00

    1.0.1 d169f57d9d 102 commits

    이메일 수신 서버 1.0.1

    1.0 대비 NAS 배포 설정을 단순화하고 초기 등록 암호 정책을 조정했습니다.

    1.0 대비 변경 사항

    • Compose의 로컬 build 제거. 게시된 레지스트리 이미지를 pull해 실행하며 기본 태그는 1.0.1입니다.
    • 호스트 bind 기본 경로를 Compose 기준 ./app/data, ./app/logs, ./app/backups, ./app/clamav-db, ./app/secrets/master.key로 변경했습니다. 컨테이너 내부 경로는 유지합니다.
    • ClamAV를 stable-debian13-slim으로 변경하고 UID/GID 1000:1000, Docker init 및 임시 디렉터리 권한을 맞췄습니다.
    • 최초 패스키 등록·NAS 복구 암호의 최소 길이를 16자에서 8자로 변경했습니다. UI와 서버 정책을 일치시키고 7자 거부·8자 등록/복구 회귀 시험을 반영했습니다.
    • .env.example을 Compose 배포 설정에 맞추고 app/을 Git·Docker 빌드에서 제외했습니다. 로컬 .env와 비밀값은 릴리즈에 포함되지 않습니다.
    • 프록시 설정·권한·이미지 적용 문서를 갱신했습니다. 비밀값 검사에서 경로 설정 오탐을 제거하고 8자 암호를 검사 대상에 포함했습니다.

    업데이트 시 확인

    기존 .env의 경로 값은 기본값보다 우선합니다. 데이터·마스터키는 자동 이동되지 않으므로 기존 경로를 유지하거나 백업 후 이전하세요. 기존 ClamAV 정의 디렉터리는 UID/GID 1000:1000에 쓰기 권한이 필요합니다.

    docker compose pull
docker compose up -d --no-build

    이미지와 검증

    이미지: git.2ex.dev/hanyul/cloudflare-email-webhook:1.0.1 (Linux amd64)

    고정 참조: git.2ex.dev/hanyul/cloudflare-email-webhook@sha256:c6ca04bba12f1d3f0273a1cd7086700d5c17bf3e8d1095a8349aaefadd38d6ab

    소스 커밋: a34a419e058094f80c223752cbddec452944cd56

    릴리즈 이미지 통합 시험 17개 통과, 건너뜀 0. 강제 종료·재전송·bind mount 재생성·백업 복구, 브라우저 패스키·미리보기·모바일 화면 및 Compose 설정 검증을 통과했습니다. 앱 이미지의 Trivy High/Critical 0건이며 알려진 비밀값의 새 번들·이미지 포함 0건입니다.

    ClamAV stable-debian13-slim 이미지 검사에서는 패키지별 High 55건·Critical 1건(고유 CVE 20개)이 검출됐으며 스캐너의 수정 버전 표기는 모두 비어 있습니다. Critical 항목은 libxml2의 CVE-2026-6653입니다. 이는 취약점 목록 검사 결과이며 실제 악용 가능성을 검증한 결과가 아닙니다. 따라서 전체 이미지 취약점 검증을 통과한 것으로 보지 않으며 운영 전환 전 별도 조치·재검사가 필요합니다.

    실제 NAS·Cloudflare Worker 배포/SMTP 수신은 수행하지 않았습니다. 기존 이력에 노출됐던 웹훅 키는 운영 전환 시 Worker와 함께 교체해야 합니다. ClamAV는 upstream 이미지를 사용하며 자체 레지스트리로 복제하지 않습니다.

    전체 변경 · 운영 절차

    Downloads 2