NAS Docker 앱 배포 환경 변수 경고 수정

docs/deploy.md

@@ -179,9 +179,13 @@ cp .env.example .env.production
 # Docker 네트워크 대역이 NAS 기존 컨테이너와 겹치면 DOCKER_SUBNET을 다른 사설 대역으로 변경
 # Docker 내부 앱에서 PostgreSQL에 접근할 때는 sori-studio-db:5432 사용
 
-# Docker 빌드 및 실행
+# Docker CLI 빌드 및 실행
 docker compose --env-file .env.production up -d --build
 
+# UGREEN NAS Docker 앱처럼 --env-file 옵션을 넣기 어려운 GUI 배포에서는
+# docker-compose.yml과 .env.production을 같은 프로젝트 위치에 두고 Compose 빌드를 실행한다.
+# 앱과 DB 컨테이너는 env_file 설정으로 .env.production을 직접 읽는다.
+
 # 운영 DB 마이그레이션 상태 확인
 sh scripts/migrate-production-db.sh status
 

docs/update.md

@@ -1,5 +1,10 @@
 # 업데이트 이력
 
+## v1.12.12
+
+- UGREEN NAS Docker 앱 배포에서 `--env-file` 없이 Compose를 실행해도 PostgreSQL 환경 변수 치환 경고가 뜨지 않도록 DB 서비스 중복 환경 변수 선언 제거.
+- NAS Docker 앱 GUI 배포 시 `.env.production` 배치 기준 문서화.
+
 ## v1.12.11
 
 - CSP Report-Only 차단 출처 정규화에서 빈 값과 특수 scheme을 `unknown`과 분리.