설치 화면은 5분이면 끝나요. 실제로 막혔던 DB 연결 오류, 502 오류, 설정이 안 먹는 문제 세 가지를 원인과 함께 정리했어요.
결과부터 보세요
브라우저에서 워드프레스 설치를 끝내고 관리자 화면에 로그인해요. 중간에 막히면 아래 막히는 곳 세 가지를 순서대로 확인하세요.
준비물
- wp-config.php 준비 완료 (12편)
- DB, php-fpm, nginx가 모두 켜져 있는 상태
- 관리자 아이디와 긴 비밀번호
따라 하기
- 설치 화면을 열어요. PC 브라우저에서 폰 IP를 넣어 입력해요. Tailscale 주소를 써도 돼요.
http://192.168.0.23:8080/wp-admin/install.php
- 언어를 한국어로 고르고 계속을 눌러요.
- 사이트 제목을 적어요. 나중에 바꿀 수 있어요.
- 관리자 아이디를 정해요. admin 같은 흔한 이름은 피하세요.
- 비밀번호는 제안되는 긴 값을 써요. 비밀번호 관리자에 저장하세요.
- 검색 엔진 노출은 일단 막아 둬요. 사이트가 완성된 뒤에 풀면 돼요.
- 워드프레스 설치를 눌러요. 성공 화면에서 로그인으로 들어가요.
막히는 곳 1: Error establishing a database connection
워드프레스가 DB에 닿지 못할 때 나와요. 원인은 대부분 두 가지예요.
- DB가 꺼져 있어요. pgrep -a mysqld로 확인하고, 없으면 9편의 켜는 명령을 실행하세요.
- DB_HOST가 소켓 경로를 포함하지 않아요. 12편의 DB_HOST 줄을 다시 확인하세요.
wp 계정으로 직접 접속되는지 보면 원인을 가를 수 있어요. 접속이 되면 wp-config.php의 값이 틀린 거예요.
mariadb -u wp -p wordpress -e "select 1"
막히는 곳 2: 502 Bad Gateway 또는 500
nginx는 켜졌는데 php-fpm이 죽어 있는 경우예요. 로그를 보면 바로 알 수 있어요.
pgrep -a php-fpm
tail -5 $PREFIX/var/log/php-fpm.log
tail -5 $PREFIX/var/log/nginx/error.log
connect() to unix:/data/data/com.termux/files/usr/var/run/php-fpm.sock failed
▲ nginx 오류 로그에 이 문장이 보이면 php-fpm 소켓이 없다는 뜻이에요.
php-fpm을 직접 실행했을 때 Cannot create lock – Permission denied (13)이 나오면 OPcache 문제예요. php.ini에 opcache.enable=0을 넣고 php-fpm을 다시 켜세요.
echo "opcache.enable=0" >> $PREFIX/etc/php/php.ini
pkill -x php-fpm
php-fpm
막히는 곳 3: 설정을 바꿨는데 그대로예요
PHP가 읽지 않는 위치의 php.ini를 고친 경우예요. php –ini의 Loaded Configuration File 줄이 실제로 읽는 파일이에요. none이면 10편처럼 etc/php 폴더 안에 php.ini를 만들어야 해요.
받는 결과: 워드프레스 관리자 화면에 로그인돼요. 다음 글에서 처음 해야 할 설정을 해요.
다음 글 · 14/21워드프레스 첫 설정: 주소, 언어, 보안 기본고유주소, 언어, 기본 정리, 보안 기본값을 맞춰요.
← 이전 글: 워드프레스 파일 올리고 wp-config 만들기
공폰이의 워프월드 전체 목차 (21편)
- 시작하기
- 폰 준비
- 서버 설치
- 워드프레스
- 12. 워드프레스 파일 올리고 wp-config 만들기
- 13. 워드프레스 설치 화면과 막히는 곳 3가지
- 14. 워드프레스 첫 설정: 주소, 언어, 보안 기본
- 도메인 연결
- 운영과 관리