디지털 다운로드: 영속성 수정 및 이전 주문에 대한 자동 전달

2026년 9월 13일

오늘 저희는 서버 업데이트 후 일부 디지털 다운로드 파일이 사라지던 버그를 수정했습니다 — 그리고 똑같이 중요하게도, 판매자가 파일을 (재)업로드하는 순간 구매자에게 자동으로 접근 권한이 부여되도록 했습니다.

무슨 일이 있었나

일부 구매자가 주문이 결제 완료되고 다운로드 항목도 존재함에도 불구하고, 내 다운로드에서 다운로드 버튼을 클릭했을 때 “file not found on disk”(디스크에서 파일을 찾을 수 없음) 오류를 보게 되었습니다.

기술적 원인

저희 게임 서비스는 각 지역 VPS에서 Docker 컨테이너로 실행됩니다. 업로드된 다운로드 파일은 /var/lib/erleuchtung/shop-downloads에 기록됩니다 — 이것은 호스트 서버의 영구 폴더로, 컨테이너에 마운트되어야 했습니다.

이 마운트는 개발 환경 설정에는 존재했지만, 업데이트 에이전트가 VPS 노드에 설치하는 배포용 compose 파일에는 없었습니다. 결과적으로 업로드된 파일은 컨테이너 자체의 파일시스템 레이어에 저장되었습니다. 업데이트가 컨테이너를 재생성할 때마다 그 레이어는 폐기되었고 — 파일은 사라지고, 데이터베이스 레코드(PostgreSQL에 저장됨)만 남았습니다.

결과: 더 이상 존재하지 않는 파일을 가리키는 유효한 다운로드 항목이 남게 되었습니다.

수정한 내용

• 모든 노드에서 영구 스토리지. 다운로드 디렉토리가 이제 모든 지역 서버(US, IN, EU2, SG 및 MAAS 스테이징 노드)에서 호스트 스토리지에 올바르게 마운트됩니다. 업로드는 업데이트와 컨테이너 재생성을 견뎌냅니다.
• 업로드 시 자동 백필. 이전에는 다운로드 접근 권한이 결제 시점에만 부여되었고 — 그 시점에 존재하는 파일에만 해당했습니다. 이제 판매자가 상품에 파일을 업로드하면 해당 상품의 결제 완료된 주문을 가진 모든 구매자에게 자동으로 부여되며 즉시 알림이 전송됩니다.
• 자가 치유 다운로드 목록. 「내 다운로드」를 열면 이제 모든 결제 완료 주문에 대해 누락된 접근 권한이 복구됩니다 — 과거 구매도 스스로 치유됩니다.
• 발송 시 권한 부여. 판매자가 주문을 발송됨/배송됨으로 표시하면 첨부 파일이 즉시 부여됩니다 — 디지털 상품은 배송 시 제공되어야 합니다.

판매자가 해야 할 일

이 수정 이전에 업로드되어 업데이트 중 손실된 파일은 복구할 수 없습니다 — 그것들은 폐기된 컨테이너 레이어 안에만 존재했습니다.

이전에 파일을 업로드하셨다면: 상품을 열고, 오래된 다운로드 항목을 삭제한 후 파일을 다시 업로드하세요. 업로드하는 순간 모든 이전 구매자가 자동으로 접근 권한을 되찾습니다 — 수동 작업이 필요 없습니다.

투명성에 대한 참고

일부 사용자가 받은 「발송됨」 알림 이메일에는 실제로 첨부된 적 없는 다운로드 가능 파일에 대한 언급이 있었습니다 — 그 텍스트는 판매자의 발송 메모였으며 파일 전달이 아니었습니다. 이번 릴리스부터 「내 다운로드」의 다운로드 버튼이 유일한 신뢰할 수 있는 기준입니다: 파일이 거기에 나열되어 있다면 서버에 존재하며 다운로드할 수 있습니다.

기다려 주셔서 감사합니다 — 그리고 문제를 신속하게 보고해 주신 커뮤니티 회원들께 특별히 감사드립니다.

— Erleuchtung 팀