phpbb 도커 컴포즈 설치 및 초기세팅 방법
## phpBB 도커 컴포즈 설치 및 초기 세팅 방법
phpBB를 Docker Compose로 설치하고 초기 세팅하는 방법을 단계별로 정리합니다. 아래 예시는 MariaDB를 데이터베이스로 사용하며, 로컬 개발 환경 기준입니다.
1. 프로젝트 폴더 생성 및 이동
mkdir phpbb-docker
cd phpbb-docker2. docker-compose.yml 파일 작성
아래 예시를 docker-compose.yml 파일로 저장합니다.
version: '3.8'
services:
phpbb:
build: .
container_name: phpbb
restart: unless-stopped
ports:
- "8080:80"
volumes:
- phpbb-data:/var/www/html/phpbb
depends_on:
- mariadb
environment:
- MYSQL_HOST=mariadb
- MYSQL_USER=myphpbb_user
- MYSQL_PASSWORD=MySuperStrongPassword12345
- MYSQL_DATABASE=myphpbb_db
mariadb:
image: mariadb:10.11
container_name: phpbb-mariadb
restart: unless-stopped
environment:
MYSQL_ROOT_PASSWORD: rootpassword
MYSQL_DATABASE: myphpbb_db
MYSQL_USER: myphpbb_user
MYSQL_PASSWORD: MySuperStrongPassword12345
volumes:
- db-data:/var/lib/mysql
volumes:
phpbb-data:
db-data:phpbb서비스는 웹서버와 phpBB를 실행합니다.mariadb서비스는 데이터베이스를 제공합니다.- 환경 변수는 원하는 값으로 수정 가능합니다[1].
3. Dockerfile 작성 (phpBB 설치용)
phpBB 공식 이미지를 사용할 수도 있지만, 직접 설치하려면 아래와 같이 Dockerfile을 작성할 수 있습니다.
FROM php:8.2-apache
RUN apt-get update && \
apt-get install -y libpng-dev libjpeg-dev libfreetype6-dev libzip-dev unzip && \
docker-php-ext-install mysqli gd zip
WORKDIR /var/www/html
# phpBB 최신 버전 다운로드 및 압축 해제 (예시)
RUN curl -L https://download.phpbb.com/pub/release/3.3/3.3.12/phpBB-3.3.12.zip -o phpbb.zip && \
unzip phpbb.zip && \
mv phpBB phpbb && \
rm phpbb.zip
# 권한 설정
RUN chown -R www-data:www-data /var/www/html/phpbb- phpBB 공식 배포판 경로는 최신 버전에 맞게 수정하세요.
4. 컨테이너 빌드 및 실행
docker-compose up -d --build- 컨테이너가 백그라운드에서 실행됩니다[1].
5. phpBB 설치 마법사 접속
브라우저에서 아래 주소로 접속합니다.
http://localhost:8080/phpbb/install- 설치 마법사에서 데이터베이스 정보는 docker-compose.yml에 입력한 환경 변수와 동일하게 입력합니다[1].
6. 설치 완료 후 install 폴더 삭제
보안상 설치가 끝나면 install 폴더를 반드시 삭제해야 합니다.
docker exec -it phpbb rm -rf /var/www/html/phpbb/install- 이 과정을 거치지 않으면 phpBB가 정상적으로 동작하지 않습니다[1].
7. 초기화 및 재설치(선택 사항)
모든 데이터와 볼륨을 삭제하고 초기화하려면 다음 명령을 사용합니다.
docker-compose down -v- 모든 데이터가 삭제되니 주의하세요[1].
참고 및 추가 팁
- 데이터와 설정을 유지하려면
volumes를 반드시 지정하세요. - MariaDB 대신 MySQL도 사용 가능합니다.
- 실제 운영 환경에서는 phpBB 공식 이미지를 사용하는 방법도 있습니다.
- 워드프레스 등 다른 PHP 기반 앱 설치와 구조가 유사합니다[2].
이 과정을 따라하면 phpBB의 도커 컴포즈 기반 설치와 초기 세팅을 손쉽게 완료할 수 있습니다.
인용:
[1] Docker file & compose for phpBB3 | Just Some Techie Notes! https://techienotes.blog/2025/01/31/docker-file-compose-for-phpbb3/
[2] [도커] Docker compose로 워드프레스 설치하기 - 인생 코딩 https://life-coding.tistory.com/75
[3] [Docker] Docker Compose PHP 개발환경 구성하기 https://velog.io/@youngrong0312/Docker-Docker-Compose-PHP-개발환경-구성하기
[4] [Docker] 도커 컴포즈를 활용한 PHP 및 MYSQL 기반 게시판 https://lkimas.tistory.com/entry/도커-컴포즈를-활용한-PHP-및-MYSQL-기반-게시판
[5] docker-compose 로컬 PHP 개발 환경 구성하기 https://dev-tak.tistory.com/18
[6] Docker 설치 및 Docker-Compose 설치 - Tei's Tech Note https://teichae.tistory.com/entry/Docker-설치-및-Docker-Compose-설치
[7] Docker App - php 설치 (compose) https://mkdir-chandler.tistory.com/335
[8] phpbb in docker https://www.phpbb.com/community/viewtopic.php?t=2589706
[9] [Docker] PHP, MySQL, phpMyAdmin Docker 배포 방법 https://guanjo.tistory.com/63
[10] 4. Docker PHP 환경 설정하기 (php.ini) - 서버엔지니어공략집 https://93it-serverengineer.co.kr/16
