워드프레스는 방대한 플러그인 생태계를 통해 기능을 확장하는 것이 특징입니다. 일반적으로는 워드프레스 관리자 페이지에서 쉽게 플러그인을 검색하고 설치하지만, 때로는 네트워크 문제, 서버 제한, 대용량 파일 등 다양한 이유로 FTP를 이용한 수동 설치가 필요할 수 있습니다. 특히 초보자에게는 FTP를 통한 설치 과정이 다소 복잡하게 느껴질 수 있으므로, 이 글에서는 가장 기본적인 FTP 접속 도구인 파일질라(FileZilla)를 활용한 워드프레스 플러그인 수동 설치 방법을 단계별로 상세히 안내해 드립니다.
📚 함께 읽으면 좋은 글
워드프레스 플러그인 FTP 수동 설치가 필요한 이유 확인하기
대부분의 워드프레스 사용자들은 관리자 대시보드의 ‘플러그인 > 새로 추가’ 기능을 통해 간편하게 플러그인을 설치합니다. 하지만 다음과 같은 상황에서는 FTP를 이용한 수동 설치가 불가피합니다.
- 서버 메모리 또는 파일 업로드 제한: 호스팅 환경에 따라 PHP 메모리 제한(Memory Limit)이나 파일 업로드 크기 제한(Upload Max Filesize) 때문에 대용량 플러그인 설치 파일 업로드에 실패할 수 있습니다.
- 보안 문제 및 네트워크 오류: 특정 서버 환경이나 방화벽 설정으로 인해 관리자 페이지에서의 설치 과정이 차단되거나, 설치 파일 다운로드 중 오류가 발생할 수 있습니다.
- 유료 플러그인 설치: 워드프레스 공식 디렉토리가 아닌 외부 마켓플레이스에서 구매한 유료 플러그인은 ZIP 파일 형태로 제공되므로, 이를 직접 FTP로 업로드해야 합니다.
- 사이트 접속 불가 시: 플러그인 충돌 등의 이유로 워드프레스 관리자 페이지에 아예 접속이 안 될 때, 해당 플러그인을 비활성화하거나 삭제하기 위해 FTP 접근이 필수적입니다.
이러한 상황에서는 FTP 클라이언트 프로그램을 사용하여 서버의 파일 시스템에 직접 접근하는 것이 가장 확실하고 안정적인 해결책이 됩니다.
파일질라를 이용한 FTP 접속 및 플러그인 파일 준비 보기
플러그인을 수동으로 설치하기 위해서는 먼저 FTP 접속 정보가 필요합니다. 이 정보는 일반적으로 워드프레스가 설치된 호스팅 서비스를 신청할 때 제공받습니다.
FTP 접속 정보 준비 및 파일질라 설정 확인하기
FTP 접속에 필요한 정보는 다음과 같습니다. 호스팅사 관리 페이지에서 확인하거나 문의해야 합니다.
- 호스트 (Host): FTP 서버 주소 (IP 주소 또는 도메인 주소)
- 사용자명 (Username): FTP 계정 아이디
- 비밀번호 (Password): FTP 계정 비밀번호
- 포트 (Port): 기본값은 21 (SFTP/SSH는 22, 호스팅사에 따라 다름)
파일질라를 실행한 후 상단 메뉴의 ‘파일 > 사이트 관리자’에서 위 정보를 입력하고 접속하면 됩니다. 성공적으로 접속하면 화면의 오른쪽(원격 사이트)에 워드프레스가 설치된 서버의 파일 목록이 나타납니다.
플러그인 파일 다운로드 및 압축 해제 확인하기
FTP로 업로드하기 위해서는 플러그인 파일이 필요합니다. 워드프레스 공식 디렉토리에서 다운로드하거나 구매한 ZIP 파일을 준비합니다.
- 다운로드한 플러그인 ZIP 파일을 PC의 원하는 위치에 저장합니다.
- 반드시 해당 ZIP 파일의 압축을 미리 풀어야 합니다. 플러그인 폴더는 일반적으로
plugin-name과 같은 형태이며, 이 폴더 안에 핵심 PHP 파일(plugin-name.php등)이 들어있어야 합니다. - 주의: 압축을 풀었을 때
plugin-name.zip안에 또 다른plugin-name폴더가 있는 이중 폴더 구조가 아닌지 확인합니다. FTP로 업로드해야 하는 것은 실제 플러그인 파일들이 들어있는 가장 안쪽의 폴더입니다.
FTP로 워드프레스 플러그인 폴더 업로드 상세 더보기
준비된 플러그인 폴더를 FTP를 통해 워드프레스 설치 경로의 올바른 위치에 업로드하는 단계입니다. 이 과정이 수동 설치의 핵심입니다.
업로드 대상 경로 확인하기
워드프레스의 모든 플러그인은 서버 내의 특정 폴더에 위치해야 합니다. FTP 클라이언트(파일질라)를 통해 원격 사이트(서버)에서 다음 경로를 찾습니다.
/wp-content/plugins/
이 plugins 폴더는 워드프레스 설치 경로(보통 public_html 또는 www) 바로 아래의 wp-content 폴더 내에 있습니다. 이 경로 내에 플러그인의 폴더를 업로드해야 워드프레스가 해당 플러그인을 인식할 수 있습니다.
플러그인 폴더 업로드 진행 확인하기
- 파일질라의 왼쪽(로컬 사이트)에서 미리 압축을 풀어둔 플러그인 폴더(예:
contact-form-7)를 찾습니다. - 오른쪽(원격 사이트)에서
/wp-content/plugins/경로를 열어둡니다. - 로컬 사이트의 플러그인 폴더를 마우스로 드래그하여 원격 사이트의
plugins폴더로 옮기거나, 우클릭 후 ‘업로드’를 선택합니다. - 업로드가 완료되면
plugins폴더 안에 새로운 플러그인 폴더가 생성되었는지 확인합니다. 이 과정이 완료되면 플러그인 파일들은 서버에 완전히 설치된 것입니다.
설치된 플러그인 워드프레스 관리자에서 활성화 보기
FTP를 통해 파일을 서버에 올리는 것은 설치 과정의 대부분이지만, 실제로 워드프레스가 해당 기능을 사용하도록 하려면 관리자 페이지에서 활성화해야 합니다.
워드프레스 대시보드 접속 확인하기
FTP 업로드가 완료되면 워드프레스 관리자 페이지([의심스러운 링크 삭제됨])에 접속합니다.
플러그인 활성화 및 오류 해결 상세 더보기
‘플러그인 > 설치된 플러그인’ 메뉴로 이동합니다. 목록을 살펴보면 방금 FTP로 업로드한 플러그인이 비활성화된 상태로 나타나는 것을 확인할 수 있습니다.
- 플러그인 이름 아래의 ‘활성화’ 링크를 클릭하여 플러그인을 작동시킵니다.
- 활성화에 성공하면 플러그인 기능이 워드프레스에 적용됩니다.
- 만약 활성화 시 치명적인 오류(Fatal Error)가 발생한다면, 플러그인 폴더 구조가 잘못되었거나(이중 폴더), 워드프레스 버전 또는 PHP 버전과의 호환성 문제일 수 있습니다. 이 경우 해당 플러그인 폴더를 FTP로 다시 삭제하여 사이트를 복구하고, 올바른 파일을 다시 업로드하거나 플러그인 개발자에게 문의해야 합니다.
FTP 수동 설치 시 발생 가능한 일반적인 오류 및 해결 방법 확인하기
FTP를 이용한 수동 설치 과정 중 몇 가지 일반적인 오류가 발생할 수 있습니다. 2024년 및 2025년 현재까지도 초보자들이 가장 자주 겪는 문제와 그 해결 방법을 정리했습니다.
오류1: 플러그인 설치 후 활성화 목록에 표시되지 않는 문제 해결하기
원인: 가장 흔한 원인은 플러그인 폴더 경로가 잘못된 경우입니다. 예를 들어, wp-content/plugins/플러그인명/플러그인명/ 와 같이 이중 폴더 구조로 업로드되었거나, 플러그인 파일 자체가 plugins 폴더 바로 아래에 있지 않은 경우입니다.
해결: FTP를 통해 wp-content/plugins/ 경로로 이동하여, 실제 플러그인의 메인 PHP 파일(plugin-name.php)이 들어있는 폴더를 바로 plugins 폴더 아래에 위치하도록 수정합니다.
오류2: 업로드 중 연결 끊김 또는 권한 오류 해결하기
원인: 대용량 플러그인을 업로드할 때 발생하는 서버 시간 초과(Timeout) 문제 또는 FTP 계정의 파일 쓰기 권한(Permission) 부족 문제입니다.
해결: 파일질라 설정에서 전송 시간 초과(Timeout) 값을 늘리거나(일반적으로 ‘편집 > 설정 > 연결’에서 조정 가능), 호스팅사에 연락하여 FTP 계정의 쓰기 권한을 확인하고 필요하면 수정 요청합니다.
오류3: 2025년 최신 워드프레스 버전에서의 호환성 문제 해결하기
원인: 워드프레스가 지속적으로 업데이트되면서 구 버전의 플러그인이 최신 워드프레스 코어와 충돌하는 경우가 있습니다. 특히 2024년 이후 워드프레스의 큰 변화에 맞춰 업데이트되지 않은 플러그인에서 자주 발생합니다.
해결: 플러그인 공식 페이지나 마켓플레이스에서 해당 플러그인이 사용자의 워드프레스 버전과 호환되는지 확인합니다. 되도록이면 최근 1년 이내에 업데이트 기록이 있는 플러그인을 사용하는 것이 안전합니다.
| 문제 유형 | 주요 원인 | FTP 해결 조치 |
|---|---|---|
| 관리자 활성화 목록 누락 | 잘못된 폴더 경로 (이중 폴더) | /plugins/ 아래에 메인 PHP 파일이 있는 폴더가 오도록 재배치 |
| 업로드 중 연결 끊김 | FTP 서버 타임아웃 | 파일질라 설정에서 시간 초과 값 증가 |
| Fatal Error 발생 | 호환성 문제 또는 코드 충돌 | 해당 플러그인 폴더를 즉시 삭제하여 사이트 복구 |
📌 추가로 참고할 만한 글
자주 묻는 질문 (FAQ)
Q1. FTP로 플러그인을 설치하면 보안상 더 취약한가요?
A. 아닙니다. FTP를 통한 설치는 단순히 파일을 서버에 올리는 방식일 뿐이며, 관리자 페이지를 통한 설치와 보안상의 차이는 없습니다. 중요한 것은 다운로드한 플러그인 파일 자체가 신뢰할 수 있는 출처(공식 디렉토리 또는 유명 마켓플레이스)의 파일이어야 한다는 점입니다.
Q2. 플러그인을 FTP로 삭제하려면 어떻게 해야 하나요?
A. FTP 클라이언트(파일질라)를 통해 /wp-content/plugins/ 경로로 접속합니다. 삭제하고 싶은 플러그인의 폴더(예: contact-form-7)를 찾아서 통째로 삭제하면 됩니다. 이 작업은 플러그인을 비활성화하는 것 이상의 영구적인 삭제 조치이므로 신중하게 진행해야 합니다.
Q3. ZIP 파일을 압축 해제하지 않고 plugins 폴더에 바로 업로드해도 되나요?
A. 안 됩니다. 워드프레스는 plugins 폴더 내의 폴더를 플러그인으로 인식합니다. ZIP 파일 형태는 관리자 페이지 업로드 기능에서만 자동 압축 해제가 지원됩니다. FTP 수동 설치 시에는 반드시 PC에서 ZIP 파일을 압축 해제한 후, 그 결과로 나온 폴더를 통째로 /wp-content/plugins/ 경로에 업로드해야 합니다.