Skip to content

설치하기

그누보드를 설치할 때는 최신버전 사용을 권장한다. 오래된 버전을 사용한다면 이미 알려진 보안취약점에 노출될 수 있으며, 기능 사용에 제약과 오류를 포함하고 있을 수 있다.

설치 환경

그누보드5를 설치하기 위해서는 아래 조건을 만족해야한다

  • PHP 7.2 이상 권장 (최소 PHP 5.2.17 이상)
  • MySQL 5.0 이상 또는 MySQL 5.0 이상의 기능을 만족하는 MariaDB
  • 리눅스 호환 OS
  • 필수 PHP 확장
    • GD Library 2.0 이상
    • iconv
  • 권장 PHP 확장

권장사항

PHP 7.4 이상, MySQL 5.7(& MariaDB) 사용을 권장한다.

PHP 5 사용을 권장하지 않음

PHP 5 버전은 최종 버전인 PHP 5.6.40을 마지막으로 2018년 12월 지원이 완전히 종료되었다.

환경에 따른 주의 사항

  • Nginx에서는 폴더 및 파일에 대한 접근제한 설정이 적용되지 않아 위험에 노출될 수 있으니 주의해야한다
    • Nginx 사용 시 개발사가 설정을 안내하지 않으니 폴더, 파일 접근제한을 사용자가 알아서 설정해야한다
  • MySQL 8.0.11 이상의 버전에서 MySQL password() 함수의 제거로 인해 오류가 발생할 수 있다
    • 그누보드 5.2.9.3 버전(2015년 출시) 이전부터 운영되어 오던 사이트(DB 데이터)에서 문제가 발생할 수 있으며, 일부 회원이 로그인에 실패하거나 글, 댓글 수정에 문제를 겪을 수 있다
    • 이 문제는 보고되었으나 고쳐지지 않고 있다. 그누보드 이슈 #247

빌더 사용 시 유의할 내용

그누보드 기능을 확장해주는 빌더를 사용할 때는 아래와 같은 사항을 유의해야한다.

  • 그누보드 최신 버전을 지원하는 빌더 선택을 권장
    • 그누보드 업데이트가 제한되므로 보안취약점 및 기능 사용 및 스킨, 플러그인 사용에 제약이 있음
  • 테마와 스킨 선택에 제약이 있음
    • 빌더와 호환되는 테마와 스킨을 사용해야 기능이 온전히 동작할 수도 있음
    • 일반 테마나 스킨 선택 시 기능 및 사용성 문제가 발생할 수 있음

설치 방법

  1. 그누보드 최신 버전 다운로드: https://sir.kr/g5_pds
  2. (S)FTP, SSH 접속 등을 통해 서버에 업로드

Git으로 설치 권장

1~2 과정의 그누보드를 다운로드하여 설치하는 대신 Git을 이용해 설치할 수도 있다.

설치할 폴더에서 코드 내려받기 (뒤에 .은 현재 폴더를 지칭함)

bash
git clone https://github.com/gnuboard/gnuboard5.git .

또는 경로를 지정하여 내려받기 (public_html 폴더명 예시)

bash
git clone https://github.com/gnuboard/gnuboard5.git public_html
  1. 그누보드 파일들을 업로드한 폴더에 data 폴더 생성
  2. 브라우저에서 설치 페이지 접속
  3. 그누보드 약관 동의
  4. DB 정보 및 관리자 정보, 설치 옵션 입력

그누보드 재설치 옵션

회원, 글, 댓글 등의 모든 데이터가 삭제될 수 있으니, 선택에 주의해야 한다. 그누보드 DB 데이터를 삭제하여 초기화할 때만 선택해야 한다.

쇼핑몰설치 옵션

쇼핑몰(영카트) 기능을 사용할 때만 선택해야 한다. 쇼핑몰 기능을 사용하지 않는다면 선택을 해제한 후 설치하면 된다.

쇼핑몰 기능을 사용하지 않는다면, 그누보드 설치 완료 후 영카트 제거를 참고하여 관련된 파일을 삭제하기를 권장한다.

최고관리자 정보 입력

그누보드의 모든 권한을 가지는 계정이다.

최고관리자 계정의 ID의 기본값은 admin이며, 이는 쉽게 공격에 노출될 수 있으니 ID를 적절히 변경하고 비밀번호를 영문 대소문자, 숫자, 특수문자를 조합하여 유추하기 어렵게 설정해야 한다.

  1. 설치가 완료되면 이제 그누보드를 사용할 수 있다.
  2. 초기 설정을 참고하여 그누보드의 기본 설정을 참고하여 주요 설정을 살펴보고 변경해주는 것이 좋다.