2025년 6월 9일369 views

wordpress docker 컨테이너에서 이미지 파일을 이동할 수 없습니다. 파일권한 문제

작성자

nuuthang

Comments

포스트 내용에 대한 의견이나 질문을 남길 수 있습니다. 답글과 좋아요는 로그인한 사용자 기준으로 기록됩니다.

새 댓글은 아래에서 바로 등록됩니다.

댓글 작성과 반응 기능은 로그인 후 사용할 수 있습니다.로그인하러 가기

첫 번째 댓글을 남겨보세요.

현재 글을 기준으로 앞뒤 글을 바로 이동해서 볼 수 있습니다.

Nf_conntrack 이란? System Netfilter connection tracker utilization

📚 Linux 네트워크 연결 추적 문제 해결 마스터 청사진💡 상황 해독현재 상태: 컴퓨터가 "누가 누구와 연결되어 있는지" 기록하는 메모장이 가득 차서 새로운 인터넷 연결을 받을 수 없는 상황이었으나, 메모장 크기를 4배로 늘려서 해결 완료핵심 쟁점:디시인사이드 트

Docker WordPress 권한 문제 마스터 청사진

📚 Docker WordPress 권한 문제 마스터 청사진💡 상황 해독현재 상태: WordPress 사이트는 접속되지만 템플릿 다운로드, 이미지 업로드, 플러그인 설치 등 파일을 만지는 모든 작업이 "권한 없음" 오류로 막혀있는 상황핵심 쟁점:"WP_Filesyst

댓글 0

이전 글과 다음 글

📚 Docker 워드프레스 파일 권한 문제 마스터 청사진

💡 상황 해독

현재 상태: 워드프레스에서 이미지를 업로드하려고 하는데 "파일을 content/uploads/2025/06으로 이동할 수 없습니다"라는 오류가 나타남. 웹 브라우저에서는 200 응답이 뜨지만 실제로는 파일이 저장되지 않는 상황

핵심 쟁점:

Docker 컨테이너 내부의 워드프레스는 www-data 사용자로 실행됨

호스트에서 마운트된 파일들은 일반 사용자(ds) 소유

권한 불일치로 인해 파일 쓰기 작업이 실패

예상 vs 현실: 파일 업로드가 성공적으로 완료될 것으로 기대했지만, 실제로는 권한 부족으로 파일이 저장되지 않음

영향 범위: 이미지 업로드뿐만 아니라 플러그인 설치, 테마 업데이트, 백업 파일 생성 등 모든 파일 쓰기 작업이 영향받음

🔍 원인 투시

근본 원인: Docker 컨테이너와 호스트 시스템 간의 사용자 권한 불일치. 컨테이너 내부의 워드프레스는 www-data(UID 33)로 실행되지만, 호스트의 파일들은 일반 사용자 소유로 되어 있어 쓰기 권한이 없음

연결 고리: 호스트 → 볼륨 마운트 → 컨테이너 내부로 파일이 연결되지만, 소유권은 호스트 사용자 그대로 유지 → 컨테이너 내부의 www-data 사용자가 파일에 접근할 수 없음 → 업로드 실패

일상 비유:

아파트 열쇠를 가진 사람(호스트 사용자)이 방을 빌려주었는데, 세입자(www-data)에게는 열쇠를 주지 않은 상황

도서관에서 책을 읽을 수는 있지만 메모를 쓸 수 없는 상황과 유사

숨겨진 요소: HTTP 200 응답은 서버가 요청을 받았다는 의미일 뿐, 실제 파일 처리 성공을 보장하지 않음

🛠️ 해결 설계도

즉시 해결: 컨테이너 내부에서 권한 수정

핵심 행동: Docker 컨테이너에 접속하여 파일 소유권을 www-data로 변경

실행 가이드:

bash

1단계: 실행 중인 컨테이너 확인

docker ps

2단계: 컨테이너에 접속

docker exec -it <컨테이너명> bash

3단계: 권한 수정

chown -R www-data:www-data /var/www/html/wp-content/uploads/

chmod -R 755 /var/www/html/wp-content/uploads/

4단계: 컨테이너에서 나가기

exit

성공 지표: 워드프레스에서 이미지 업로드가 정상적으로 작동함

주의사항: 컨테이너를 재시작하면 권한이 초기화될 수 있음

근본적 해결: docker-compose.yml 수정

핵심 행동: 컨테이너 실행 시 올바른 사용자 권한으로 시작하도록 설정

실행 가이드:

text

변경 전 (docker-compose.yml)

wordpress:

image: wordpress:latest

volumes:

- ./:/var/www/html

변경 후

wordpress:

image: wordpress:latest

user: "33:33" # www-data의 UID:GID

volumes:

- ./:/var/www/html

핵심 변화 설명

user: "33:33" 설정으로 컨테이너가 처음부터 www-data 권한으로 실행됨

성공 지표: 컨테이너 재시작 후에도 파일 업로드가 정상 작동

주의사항: 기존 파일들의 권한도 함께 수정해야 함

예방적 해결: 호스트에서 권한 사전 설정

핵심 행동: 컨테이너 시작 전에 호스트에서 올바른 권한 설정

실행 가이드:

bash

컨테이너 중지

docker-compose down

호스트에서 권한 변경 (33:33은 www-data의 UID:GID)

sudo chown -R 33:33 ~/docker-volumes/wp-duswn2/wp-content/

sudo chmod -R 755 ~/docker-volumes/wp-duswn2/wp-content/

컨테이너 재시작

docker-compose up -d

성공 지표: 처음부터 모든 파일 작업이 정상적으로 수행됨

주의사항: sudo 권한이 필요하며, 호스트에서 파일 편집 시 권한 문제가 발생할 수 있음

🧠 핵심 개념 해부

Docker 볼륨 마운트: 두 세계를 연결하는 다리

5살에게 설명한다면: 컴퓨터 안의 가상 컴퓨터(Docker)와 진짜 컴퓨터가 같은 폴더를 공유하는 것

실생활 예시: 집(호스트)과 사무실(컨테이너)에서 같은 USB 드라이브를 사용하는 것과 유사

숨겨진 중요성: 데이터 영속성과 개발 편의성을 동시에 제공하는 핵심 기능

오해와 진실: 단순히 폴더를 공유하는 것이 아니라, 권한과 소유권도 함께 고려해야 함

www-data 사용자: 웹서버의 실행 주체

5살에게 설명한다면: 웹사이트를 운영하는 전용 직원의 이름

실생활 예시: 은행에서 고객 업무를 처리하는 창구 직원과 유사

숨겨진 중요성: 보안을 위해 제한된 권한만 가지도록 설계된 시스템 사용자

오해와 진실: 일반 사용자가 아닌 시스템이 만든 특수 사용자로, UID 33번을 가짐

파일 권한 시스템: 디지털 세계의 출입 통제

5살에게 설명한다면: 파일마다 "누가 읽을 수 있고, 누가 쓸 수 있는지" 정하는 규칙

실생활 예시: 집 열쇠, 사무실 출입카드와 같은 접근 권한 시스템