그누보드5 (Gnuboard5) 설치 방법 정리

서버 사용시 가볍고 빠르게 커뮤니티 사이트를 구축해야 하는 경우가 많습니다.

그누보드5(Gnuboard5)는 국내에서 가장 많이 사용하는 PHP 기반 게시판 솔루션 중 하나로,
커뮤니티 / 기업 홈페이지 / 쇼핑몰 / 고객센터 형태까지 다양하게 활용 가능합니다.

이번 글에서는 아래 환경 기준으로 실제 설치 과정을 정리합니다.

 

---

 

1. 테스트 환경

항목	내용
OS	Ubuntu 24.04.3 LTS
Web Server	Apache 2.4.58
PHP	PHP 8.29
DB	MariaDB 10.6.23

---

2. 설치

   2.1 그누보드 파일 다운로드

공식 홈페이지에서 다운로드: gnuboard5.6.24.tar.gz 다운로드 후 FTP 또는 SFTP로 서버에 업로드합니다.

  2.2 wget으로 서버에서 직접 다운로드

# 서버 접속 후
wget https://github.com/gnuboard/gnuboard5/archive/refs/tags/v5.6.24.tar.gz -O gnuboard5.6.24.tar.gz

 

   2.3 압축 해제

tar -xvf gnuboard5.6.24.tar.gz

  2.4 웹 디렉토리로 이동

# 예시 Ubuntu Apache 기본 /var/www/html

mv gnuboard5-5.6.24 /var/www/html/gnuboard5

 

* 서버 환경 및 사용자 설정에 따라 실제 웹 루트 경로는 다를 수 있습니다.
* Nginx, Apache 가상호스트(VirtualHost) 설정 등에 따라 별도 경로를 사용하는 경우도 있습니다.

 

 

2.5 권한 설정
그누보드는 설치 과정에서 data 디렉토리에 파일 업로드 및 설정 저장이 필요합니다.

     2.5.1 data 디렉토리가 없는 경우
 

웹 브라우저 접속 시 아래와 같은 메시지가 출력될 수 있습니다.

다음 파일을 찾을 수 없습니다. data/dbconfig.php

 

#위와 같은 경우 data 디렉토리를 생성합니다.

cd /var/www/html/gnuboard5
mkdir data
chmod 707 data

   
      2.5.2 data 디렉토리가 이미 있는 경우

cd /var/www/html/gnuboard5
chmod 707 data
chmod 707 config.php

 

data 디렉토리 생성 후 웹 브라우저에서 새로 고침

  2.6 정보 입력

 

항목	설명
Host	localhost
User	DB 계정
Password	DB 비밀번호
DB	데이터베이스명
TABLE 접두사	기본 g5_
관리자 ID	admin 등
관리자 비밀번호	직접 설정
관리자 이메일	관리자 메일 주소

* 관리자 정보는 이후 그누보드가 설치 된 홈페이지의 관리자 페이지 접속시 사용할 정보입니다.
 환경 및 사용자 설정에 따라 입력 정보는 다를 수 있습니다.

---

3. 확인

#도메인 접속
http://도메인주소

#관리자 페이지 
http://도메인주소/adm

도메인 입력 후 설치 확인

---

4. 유의사항
  4.1 Apache + PHP 모듈 확인
Ubuntu 환경에서는 PHP 모듈이 부족하면 설치 과정에서 오류가 발생할 수 있습니다.

#권장 패키지 설치

apt update

apt install -y \
php php-mysql php-gd php-mbstring php-xml \
php-curl php-zip unzip

  4.2 data 디렉토리 권한 문제

#가장 흔한 원인입니다.

chmod 707 data

#확인 필요합니다.

  4.3 PHP 버전 문제

#구형 그누보드는 최신 PHP에서 오류가 발생할 수 있습니다.

php -v

# 버전 확인 중요

---

5. 마무리
그누보드5는 비교적 간단하게 설치 가능하며, 기업 홈페이지, 커뮤니티, 쇼핑몰 등 다양한 형태로 활용하기 좋습니다.

실제 운영 환경에서는 아래 내용을 함께 구성하는 것을 권장합니다.

	항목
1	PHP 보안 설정
2	파일 업로드 제한
3	Apache 보안 설정
4	SSL 적용
5	백업 정책