워드프레스 최대 업로드 파일 크기 수정 방법 (Portainer 사용)

Portainer를 설치해서 Docker 이미지로 워드프레스를 구축을 했을 때 최대 업로드 파일 크기가 2MB밖에 안 되는 문제가 있는 것을 발견했습니다. 최대 업로드 파일 크기 세팅은 보통 php.ini를 수정하면 됩니다. 번거롭고 귀찮지만 못할 작업은 아닙니다. 기존의 php.ini 파일을 찾아서 수정만 해주면 되니까요.

Synology NAS에 Portainer 설치 방법

Synology NAS에 Portainer 설치 방법

하지만 이걸 수정하기 힘든 경우가 있죠. 이번 Docker 이미지로 워드프레스를 설치한 경우에는 별도로 php.ini 파일이 생성되어 있지 않아 수동으로 php.ini를 생성해서 만들어줘야 하고 서버도 한번 재부팅을 해야 합니다. 하지만 좀 더 쉬운 방법이 있습니다. 여기서는 그 방법을 알려드리겠습니다.

업로드가 안 되는 문제 발견

테마를 업로드해서 나만의 사이트를 꾸며보려고 하는데 이게 업로드가 안 됐습니다. 링크가 만료되었습니다. 다시 해보세요.라는 메시지만 뜹니다.

링크가 만료되었습니다?

다시 해보세요. 부분의 링크를 클릭해 보면 예기치 않은 오류가 발생했다고 합니다. 서버의 구성 문제일 수 있다는 말도 보입니다.

워드프레스에서 예상하지 않은 오류 발생

최대 업로드 파일 크기가 2MB?!

혹시 다른 업로드도 안되나 싶어 이미지를 업로드해 보려고 워드프레스의 미디어 라이브러리 페이지로 가보니 아래처럼 최대 업로드 파일 크기가 2MB라고 안내해주고 있었습니다.

최대 업로드 파일 크기 2MB

여기의 값은 php의 최대 파일 업로드 세팅의 값이 표시됩니다. 즉, 이 웹서버의 php에 세팅된 최대 업로드 용량이 2MB 밖에 안된다는 이야기입니다.

이걸 수정해 줘야 원활하게 파일을 업로드할 수 있습니다.

최대 업로드 파일 크기 수정

저는 지난번에 Portainer를 사용해서 NAS에 워드프레스를 설치했습니다. 이때 Docker 이미지로 워드프레스가 설치되었는데요. 이걸 기준으로 설명드리겠습니다. 다른 경우도 크게 차이는 없습니다.

NAS에 설치한 Portainer로 워드프레스 설치하기

NAS에 설치한 Portainer로 워드프레스 설치하기

위에서 설명했던 것처럼 Docker이미지로 워드프레스를 설치했을 때 php.ini 파일을 새로 생성해서 php 세팅을 해주는 것은 번거로운 작업입니다. 서버 재부팅도 필요한 작업입니다. 그러니 여기서는 간단하게 수정해 보도록 하겠습니다.

우리가 수정해야 할 파일은 .htaccess 파일입니다. wp-config.php 파일이 있는 디렉토리에서 작업하면 됩니다.

콘솔로 접속해서 웹 페이지가 있는 위치로 들어가 줍니다. 저는 Portainer에서 기본적으로 제공하는 웹 콘솔로 접근했습니다.

wordpress 컨테이너에 콘솔 접속

워드프레스가 설치되어 있는 사이트의 루트 디렉토리로 이동해서. htaccess 파일이 있는지 확인합니다. 저는 root로 로그인하니 해당 디렉토리가 root의 홈으로 설정되어 있었습니다.

ls -altr

wordpress가 설치된 루트 디렉토리

이 서버에는 vi 편집기가 없습니다. 설치하는 것도 귀찮고 해서 echo를 사용해서 파일을 수정하겠습니다.
cat 명령어로 기존 파일 내용을 확인해 줍니다.

cat .htaccess

.htaccess의 모습

그리고 아래 명령어로 업로드 용량을 늘리는 설정을 추가합니다. 그대로 복사해서 붙여 넣으시면 됩니다.

echo '
php_value upload_max_filesize 512M
php_value post_max_size 512M
php_value max_execution_time 300
php_value max_input_time 300' >> .htaccess

이름만 봐도 대충 어떤 내용인지 감이 오시죠?

• upload_max_filesize: 업로드 시 최대 파일 크기
• post_max_size: Post: 방식으로 넘기는 데이터의 최대 크기
• max_excution_time: 작업 처리 최대 제한 시간
• max_input_time: php 엔진이 데이터를 업로드받는 시간

최대 업로드 용량을 512MB로 늘렸습니다. 그리고 업로드할 때 시간이 더 걸릴 테니 최대 처리 시간도 300초로 늘렸습니다.

.htaccess에 설정을 추가하는 명렁 실행

그리고 다시 확인해 보면 아래와 같이 추가된 모습을 확인할 수 있습니다.

cat .htaccess

.htaccess에 최대 업로드 파일 크기 설정이 추가된 모습

최대 업로드 파일 크기 수정 결과 확인

이제 워드프레스 관리자 페이지로 돌아가서 미디어 라이브러리로 이동합니다.
새로 추가를 클릭해서 최대 업로드 용량이 수정된 것을 확인할 수 있습니다.

512 MB로 수정된 모습

이제 테마도 정상적으로 업로드될 것입니다.
외모 - 테마로 이동한 뒤 새로 추가 버튼을 클릭해서 테마를 추가해 보면 아래처럼 정상적으로 업로드가 되는 것을 확인할 수 있습니다.

테마 설치 완료

마치며...

워드프레스를 설치해서 직접 사이트를 구축하다 보니 별의 별게 다 튀어나오네요. 이번에는 php의 최대 업로드 파일 크기 설정이 제대로 안되어 있어서 테마를 업로드하는데 문제가 있었습니다. 하지만 최대 업로드 파일 크기 설정을 .htaccess에 추가하는 방식으로 간단하게 해결할 수 있었습니다.

아래는 Synology NAS에 Docker를 이용해서 워드프레스 사이트를 구축하는 방법입니다.

Synology NAS에 Portainer 설치 방법

Synology NAS에 Portainer 설치 방법

NAS에 설치한 Portainer로 워드프레스 설치하기

NAS에 설치한 Portainer로 워드프레스 설치하기