KPanel에는 브라우저에서 바로 워드프레스 사이트에 명령을 실행할 수 있는 WP-CLI 콘솔이 포함되어 있어, SSH 클라이언트나 서버 로그인 없이도 사용할 수 있습니다. 이 가이드에서는 콘솔을 찾는 위치, 정확히 어떤 명령이 허용되는지와 그 이유, 화면에 내장된 단축 기능, 그리고 콘솔이 실행할 수 없는 작업이 필요할 때 해야 할 일을 다룹니다.
콘솔 열기
- KPanel에 로그인한 뒤 왼쪽 사이드바에서 웹사이트를 클릭하세요.
- 워드프레스 사이트를 클릭하세요.
- WordPress 탭을 연 다음 Console 섹션을 여세요.
입력란에는 이미 고정된 wp이 입력되어 있으므로, 그 뒤에 오는 부분만 입력하면 됩니다. plugin list이지, wp plugin list이 아닙니다. Enter 키를 누르거나 Run을 클릭하세요.
Console은 관리형(managed) 플랜에서 나타나는 섹션 중 하나입니다. 다른 플랜에서는 탭 목록 끝에 대신 +8 on Managed 링크가 표시됩니다. 여기서 설명하는, 원시 명령이 아닌 모든 작업은 KPanel 다른 곳에 동일한 기능의 버튼이 있으므로 아무것도 놓치지 않습니다. 콘솔은 같은 엔진에 더 빠르게 접근하는 방법일 뿐입니다.
명령은 사이트 자체의 시스템 사용자 권한으로, 사이트 디렉터리 내부에서 실행됩니다. 다른 사이트를 보거나 건드릴 수 없습니다.
콘솔에서 실행되는 것과 실행되지 않는 것
콘솔은 허용 목록(allowlist) 방식을 사용합니다. 아래의 명령 접두어만 허용되며, 그 외의 명령은 서버에 도달하기 전에 거부되고 거부된 명령의 이름을 알려주는 메시지가 표시됩니다.
| 영역 | 허용되는 항목 |
|---|---|
| 코어 | core version, core check-update, core update, core is-installed, core verify-checksums |
| 플러그인 | plugin list, plugin update, plugin install, plugin activate, plugin deactivate, plugin status, plugin get, plugin delete, plugin verify-checksums |
| 테마 | theme list, theme update, theme install, theme activate, theme status, theme get, theme delete |
| 사용자 | user list, user get, user create, user update, user set-role, user delete, user reset-password, user add-cap, user remove-cap, user generate |
| 데이터베이스 | db size, db tables, db optimize, db repair, db check |
| 캐시 및 트랜지언트 | cache flush, cache get, cache set, cache add, cache delete, transient get, transient set, transient delete |
| 리라이트 규칙 | rewrite flush, rewrite list, rewrite structure |
| Cron | cron event list, cron event run, cron schedule list |
| 설정 | config get, config list, config has, config shuffle-salts |
| 유지보수 모드 | maintenance-mode activate, maintenance-mode deactivate, maintenance-mode status |
| 읽기 전용 확인 | option get, option list, post list, post get, comment list, comment get |
| 미디어 및 언어 | media regenerate, language core install, language core update |
| 검색 및 치환 | search-replace |
의도적으로 제외된 항목이 포함된 항목보다 더 중요합니다.
eval및shell은 차단됩니다. 임의의 PHP와 임의의 셸 명령을 허용하면 콘솔이 브라우저 탭 안의 루트 프롬프트와 다를 바 없게 됩니다.db import,db export,db drop,db query및db reset은 차단됩니다. 가져오기와 초기화는 확인 절차 없이 데이터베이스를 파괴하며,db query는 제약 없는 SQL 프롬프트입니다. 대신 phpMyAdmin을 사용하세요: phpMyAdmin으로 데이터베이스에 접근하기.config set및config delete은 차단됩니다. 잘못된wp-config.php기록은 사이트를 오프라인으로 만들 수 있습니다. 값은 여기서 확인하고, 변경은 파일 관리자를 통해 하세요.option update및option delete은 차단됩니다. 옵션을 무작정 수정하는 것은 사이트를 복구 불가능한 상태로 만드는 흔한 원인입니다.
콘솔은 어떤 명령에서도 사용자를 위해 백업을 수행하지 않습니다. 백업을 수행하는 것은 빠른 작업 섹션의 버튼뿐입니다. search-replace, core update, plugin update, theme update, db optimize 또는 db repair을 실행하기 전에, 사이트의 백업 페이지에서 직접 백업을 수행하세요. 백업 수행하기를 참고하세요.
콘솔에서 작업하기
이 화면은 한 번에 하나의 명령을 입력받는 것 이상의 기능을 합니다.
사전 설정 버튼. 프롬프트 위에 그룹화된 단축 버튼이 있습니다: 성능(캐시 비우기, 트랜지언트 삭제, 리라이트 규칙 비우기, 자동 로드 확인), 데이터베이스(최적화, 점검, 복구, 크기), 진단(워드프레스 버전, 업데이트 확인, 코어 검증, cron 이벤트), 콘텐츠(플러그인, 테마, 사용자 목록 조회, cron 즉시 실행), 보안(관리자 사용자, 플러그인 체크섬, 솔트 재설정, wp-config) 그리고 유지보수(유지보수 모드 켜기/끄기, 썸네일 재생성, 상태). 클릭 한 번으로 명령이 실행됩니다.
이력. 프롬프트에서 위/아래 화살표 키를 누르면 이 사이트에서 실행한 최근 50개 명령을 탐색할 수 있습니다.
스니펫. 명령 옆의 북마크 아이콘을 클릭하면 이름을 붙여 저장할 수 있어, 매달 사용하는 긴 명령을 다음부터는 클릭 한 번으로 실행할 수 있습니다.
환경 카드. 프롬프트 위에는 사이트의 PHP 버전, 워드프레스 버전, 메모리 한도, 현재 사용 중인 메모리, 업로드 최대치, 실행 시간 제한을 보여주는 카드가 있으며, 지원을 위해 복사 버튼을 누르면 이 모든 정보와 활성화된 플러그인 목록이 클립보드에 복사됩니다. 이를 지원 티켓에 붙여넣으면 한 번의 왕복을 줄일 수 있습니다.
출력 복사. 모든 결과 블록에는 복사 및 지우기 버튼이 있습니다.
명령이 실행되는 동안 출력이 스트리밍되어 돌아오므로, 오래 걸리는 작업도 멈춘 것처럼 보이지 않고 진행 상황이 표시됩니다.
알아두면 좋은 명령
진단
core version
core verify-checksums
plugin verify-checksums --all
plugin list --status=active --format=table
db size --tables
option list --autoload=yes
verify-checksums은 코어 파일과 플러그인 파일을 공식 배포본과 비교하여 수정된 부분을 보고합니다. 변조가 의심되는 사이트에서 가장 먼저 해볼 수 있는 가장 빠른 점검입니다.
option list --autoload=yes은 워드프레스가 모든 요청마다 불러오는 옵션을 모두 나열합니다. 비대해진 자동 로드 테이블은 눈에 띄는 이유 없이 사이트가 느려지는 가장 흔한 원인 중 하나입니다.
유지 관리
cache flush
transient delete --all
rewrite flush
db optimize
cron event list
cron event run --due-now
사용자
user list --role=administrator --format=table
user create jo jo@example.com --role=editor
user update 4 --user_pass='a-long-unique-password'
여기에 입력하는 모든 내용은 비밀번호를 포함해 계정의 활동 로그에 기록됩니다. 이 방법으로 설정한 비밀번호는 로그인한 후 변경하세요. 계정 복구에 대한 전체 내용은 분실한 워드프레스 관리자 비밀번호 재설정하기에서 확인할 수 있습니다.
검색 및 치환
search-replace 'http://old-domain.co.nz' 'https://old-domain.co.nz' --all-tables --dry-run
항상 먼저 드라이런(dry run)을 실행하세요. 원시 SQL 치환이 워드프레스 데이터베이스를 손상시키는 이유를 포함한 전체 안내는 검색 및 치환 실행하기에서 확인할 수 있습니다.
콘솔인가, 빠른 작업인가?
둘 다 내부적으로는 같은 WP-CLI를 사용합니다. 다음 기준으로 선택하세요.
| 작업 | 더 나은 방법 |
|---|---|
| 캐시 비우기, 플러그인 업데이트, 미디어 재생성 | 빠른 작업, 클릭 한 번으로 먼저 백업까지 수행 |
| 테이블별 미리보기가 있는 검색 및 치환 | 빠른 작업, Search & Replace 카드 |
| 특정 플래그가 필요한 모든 작업 | 콘솔 |
| 목록 조회, 점검, 진단 | 콘솔 |
| 밀린 cron 이벤트 하나 실행하기 | 콘솔 |
wp-config.php 편집 또는 데이터베이스 가져오기 | 둘 다 아님. 파일 관리자나 phpMyAdmin을 사용하세요 |
허용 목록 이상이 필요할 때
제약 없는 WP-CLI가 필요하다면 SSH로 접속하여 사이트 디렉터리에서 wp을 직접 실행하세요. SSH는 키 인증만 사용하므로, 먼저 사이트의 설정에서 SSH 키 탭으로 이동해 공개 키를 추가하세요. 정확한 호스트, 포트, 사용자 이름을 포함한 연결 정보는 같은 화면에 표시됩니다. SSH 키 추가하기와 SFTP로 연결하기를 참고하세요.
문제 해결
"'x y' is not in the allowed command list." 해당 명령이 허용 목록에 없습니다. 위의 표에서 가장 가까운 허용 명령을 확인하거나 SSH를 사용하세요.
"No results returned. Check that WP-CLI is available." 명령은 실행되었지만 아무것도 출력하지 않았습니다. 보통 일치하는 결과가 없는 쿼리에서 나타나는 정상적인 동작입니다.
명령이 시간 초과됩니다. 콘솔 명령은 60초로 제한됩니다. 대용량 미디어 라이브러리 재생성과 같은 장시간 작업은 더 긴 제한 시간을 사용하는 빠른 작업에서 실행하거나 SSH를 통해 실행해야 합니다.
아무것도 실행되지 않고 버튼이 비활성화되어 있습니다. 이 사이트에 대한 귀하의 KapsuleHost 계정 역할이 읽기 전용으로 설정되어 있습니다. 계정 소유자에게 권한 상향을 요청하세요.