그누보드5를 쓸 때 파일질라로 할 일

그누보드5(영카트5 포함)는 설치부터 디자인 수정, 백업까지 FTP로 서버 폴더를 만질 일이 많은 프로그램입니다. 그누보드 공식 매뉴얼도 설치 안내에서 "FTP 프로그램으로는 파일질라를 권해 드립니다"라고 적어 두었어요.

그런데 접속하고 나면 adm, bbs, data, theme, skin… 폴더가 스무 개 가까이 보여서 "어디를 건드려도 되는 거지?" 하고 멈칫하게 됩니다. 이 글은 폴더마다 무엇이 들어 있고, 파일질라로 어디에서 무엇을 하면 되는지를 차례로 정리했어요.

💡 결론부터: 파일질라로 할 일은 세 군데뿐입니다.

1. 설치할 때 — config.php가 있는 곳에 data 폴더를 만들고 권한을 707로 (공식 매뉴얼·설치 프로그램 기준)
2. 디자인 고칠 때 — theme(테마)·skin(스킨) 폴더의 파일을 먼저 내려받아 백업한 뒤 고치기
3. 백업할 때 — data 폴더를 통째로 내려받기. 단, 게시글·회원 정보가 든 데이터베이스(DB)는 FTP로 받을 수 없으니 따로 백업

나머지 폴더(adm, bbs, lib, plugin 등)는 그누보드 프로그램 본체입니다. 고칠 일도, 지울 일도 없어요.

🙋 폴더가 많아서 겁먹을 필요 없어요. 대부분은 "건드리지 않는 폴더"입니다. 아래 지도에서 손대는 곳만 기억해 두면 됩니다.

이 글은 그누보드(영카트) 5.6.40(2026년 9월 20일 GitHub 공식 배포)과 파일질라 클라이언트 3.71.1 한국어판을 기준으로 썼습니다. 그누보드 5.4.6부터는 쇼핑몰 영카트가 그누보드에 포함되어 배포됩니다(공식 소스 version.php 주석).

준비물

• 그누보드5가 올라갈 웹 호스팅(또는 서버)의 FTP 접속 정보 — 호스트·사용자명·비밀번호·포트
• 파일질라로 서버에 한 번 접속해 본 경험 → 아직이라면 빠른 연결로 첫 접속하기
• 새로 설치한다면: 공식 배포처에서 받은 그누보드5 압축 파일 (GitHub Releases 또는 sir.kr 자료실)

그누보드5 폴더 지도 — 어디를 만지고, 어디는 두나

파일질라 오른쪽 원격 사이트(Remote site) 칸에서 그누보드5가 설치된 폴더를 열면 이렇게 보입니다. config.php와 common.php가 있는 이 폴더가 그누보드의 루트(맨 위) 폴더예요.

사진을 누르면 크게 볼 수 있어요

1. 11. data — 첨부파일·설정이 쌓이는 폴더 (707 권한)
2. 22. skin·theme — 디자인을 고칠 때 손대는 곳
3. 33. config.php — 그누보드 기본 설정 (DB 정보는 data/dbconfig.php)

data 폴더는 설치 전에 직접 만드는 폴더예요. 연습용 서버에 공식 배포판을 올린 예시 화면이에요. 웹 루트 이름(public_html·www·html)은 호스팅마다 달라요.

🙋 "두세요"는 "지우거나 고치지 말라"는 뜻이에요. 파일질라로 열어 보는 것만으로는 아무 일도 일어나지 않습니다. 목록을 구경하거나 폴더를 더블클릭해 들어가 보는 건 전혀 괜찮아요.

data 폴더 안에는 무엇이 있나

설치가 끝나면 설치 프로그램이 data 폴더 안에 필요한 하위 폴더와 파일을 자동으로 만듭니다(공식 소스 install/install_db.php).

⚠️ dbconfig.php는 지우지도, 내려받은 파일을 남에게 보내지도 마세요. DB 비밀번호가 들어 있는 파일입니다. 지우면 사이트가 DB에 연결하지 못하고 설치 안내 화면만 나옵니다.

1단계 — (새로 설치할 때) 압축을 풀어 웹 루트에 올리기

그누보드 공식 README는 이렇게 안내합니다. "압축을 푼 디렉터리의 파일과 하위 디렉터리를 FTP, SFTP 등의 방법으로 웹 서버의 서비스 경로에 업로드" 하라고요.

1. 내려받은 압축 파일을 내 PC에서 먼저 풉니다. 압축 파일(.zip)째 올리는 게 아니에요.
2. 파일질라 왼쪽 로컬 사이트(Local site)에서 압축을 푼 폴더로 들어가, config.php·common.php가 보이는 곳까지 엽니다.
3. 오른쪽 원격 사이트에서 호스팅의 웹 루트(홈페이지 주소로 열리는 폴더)로 들어갑니다. 이름은 호스팅마다 달라요.
   • 카페24: www → 카페24 접속 방법
   • 닷홈: html → 닷홈 접속 방법
   • 호스팅어: public_html → 호스팅어 접속 방법
   • 그 밖의 호스팅: 호스팅사 안내에서 웹 루트 폴더 이름을 확인하세요
4. 왼쪽에서 파일과 폴더를 모두 선택해 오른쪽으로 끌어다 놓습니다(또는 오른쪽 클릭 → [업로드](Upload)). → 업로드·다운로드 자세히

사진을 누르면 크게 볼 수 있어요

1. 11. 압축 푼 그누보드5 파일·폴더 전체 선택
2. 22. 원격 = 웹 루트 (여기서는 /public_html)

연습용 서버에 공식 배포판을 올린 예시 화면이에요. 웹 루트 이름(public_html·www·html)은 호스팅마다 달라요.

• 파일이 많아서 시간이 좀 걸립니다. 아래 전송 대기열이 다 빌 때까지 기다리세요. 중간에 실패한 파일이 있으면 [전송 실패](Failed transfers) 탭에서 다시 보낼 수 있어요 → 전송 대기열과 실패한 전송
• 하위 폴더에 올려도 됩니다. 공식 매뉴얼 예시처럼 g5 폴더를 만들어 올리면 사이트 주소가 도메인/g5가 되고, 웹 루트(www 등)에 바로 올리면 도메인만으로 열립니다.
• 공식 README에 따르면 *.patch.zip 파일은 이미 설치된 사이트를 업데이트하는 패치라서 새로 설치할 때는 쓰지 않습니다. 새로 설치할 땐 이름에 patch가 없는 압축 파일을 받으세요.

⚠️ 이미 그누보드가 돌아가는 사이트에 다시 설치하지 마세요. 공식 README는 "기존 사이트에 재설치하면 데이터가 삭제될 수 있습니다"라고 경고합니다. 꼭 해야 한다면 파일과 DB를 먼저 백업하세요.

2단계 — data 폴더 만들기

그누보드 공식 저장소에는 data 폴더가 들어 있지 않습니다. 설치할 때 직접 만들어야 해요. 만들지 않고 브라우저로 사이트에 들어가면 설치 화면이 "루트 디렉토리에 아래로 data 디렉토리를 생성하여 주십시오."라고 안내합니다.

1. 오른쪽 원격 사이트에서 config.php가 있는 폴더(1단계에서 올린 곳)에 있는지 확인합니다.
2. 목록의 빈 곳을 오른쪽 클릭 → [디렉터리 만들기](Create directory)를 누릅니다.
3. "생성할 디렉터리 명을 입력해주세요:" 창이 뜨면 폴더 이름을 data로 바꾸고 [확인]을 누릅니다.

• 이름은 소문자 data 그대로 쓰세요. 그누보드는 이 이름(data)으로 폴더를 찾습니다(공식 소스 config.php). 리눅스 서버는 대소문자를 구분해서 Data나 DATA는 다른 폴더가 돼요.
• adm, bbs 같은 폴더와 같은 줄(같은 높이)에 있어야 합니다. 다른 폴더 안에 만들면 안 돼요.

3단계 — data 폴더 권한을 707로 바꾸기

그누보드 공식 매뉴얼은 "data 디렉토리의 퍼미션을 707 로 설정합니다."라고 안내합니다. 설치 프로그램도 data 폴더에 쓸 수 없으면 "data 디렉토리의 퍼미션을 707로 변경하여 주십시오."라고 알려 줘요. 퍼미션(permission)은 권한이라는 뜻입니다.

1. 방금 만든 data 폴더를 오른쪽 클릭 → [파일 권한](File permissions...)을 누릅니다.
2. [파일 속성 바꾸기](Change file attributes) 창이 열립니다.
3. 창 아래쪽 Chmod 칸(지금 권한이 00755처럼 숫자로 들어 있는 칸)을 지우고 707을 입력합니다. 그누보드 공식 매뉴얼에서 "숫자 값"이라고 부르는 칸이 바로 여기예요.
4. [확인]을 누릅니다.

사진을 누르면 크게 볼 수 있어요

1. 11. Chmod 칸에 707
2. 22. 하위 디렉터리로 이동 — 체크하지 않음

숫자 세 자리는 순서대로 소유자 · 그룹 · 공개 권한입니다. 707은 이런 뜻이에요.

• 왜 707인가요? 공식 README 표현으로는 data 폴더를 "웹 서버가 쓸 수 있도록" 하기 위해서입니다. 그누보드가 첨부파일·세션·설정 파일을 이 폴더에 직접 써야 하거든요.
• 체크 상자로 해도 됩니다. 숫자를 넣는 대신 위 표처럼 소유자·공개의 읽기·쓰기·실행을 모두 켜고 그룹은 모두 끄면 707과 같아요.
• 적용되면 오른쪽 목록의 [권한](Permissions) 칸에서 바뀐 권한을 확인할 수 있어요.
• 권한 바꾸기 자체가 처음이라면 → 파일 권한(chmod) 바꾸기

🙋 설치 화면이 707이 아니라 705로 바꾸라고 하나요? 그누보드 설치 프로그램은 서버에서 PHP가 돌아가는 방식(CGI 방식)에 따라 705로 안내하기도 합니다(공식 소스 install/install.inc.php). 이럴 땐 화면에 나온 숫자대로 바꾸세요.

윈도우 서버라면 설치 프로그램이 이 권한 검사를 하지 않습니다. data 폴더만 만들면 돼요.

⚠️ 777까지 올릴 필요는 없어요. 공식 매뉴얼과 설치 프로그램이 요구하는 값은 707(또는 705)입니다. 권한은 필요한 만큼만 여는 게 안전합니다.

4단계 — 브라우저에서 설치를 마치고, 파일질라로 확인하기

권한을 바꿨으면 브라우저에서 사이트 주소로 들어가 설치를 이어 갑니다. 공식 README 순서로는 라이선스 동의 → MySQL(MariaDB) 접속 정보와 관리자 정보 입력 → 설치 완료 후 로그인입니다. DB 접속 정보는 호스팅사 관리 화면에서 확인하세요.

설치가 끝나면 파일질라로 돌아와 확인해 보세요.

1. 오른쪽 원격 사이트에서 data 폴더로 들어갑니다.
2. [보기](View) 메뉴의 [새로 고침](Refresh) 또는 F5를 누릅니다.
3. dbconfig.php와 cache, editor, file, session 같은 폴더가 새로 생겼으면 설치가 제대로 된 것입니다.

사진을 누르면 크게 볼 수 있어요

1. 11. 설치할 때 생기는 폴더들 (file = 게시판 첨부파일)
2. 22. dbconfig.php — DB 접속 정보, 지우거나 남에게 보내지 않기

설치 뒤 예시 화면이에요(폴더 이름은 그누보드 설치 프로그램 기준).

• 이 하위 폴더들은 설치 프로그램이 권한 755로, dbconfig.php는 644로 만듭니다(공식 소스 config.php의 기본값). 직접 바꿀 필요 없어요.
• 설치 중에 "…디렉토리를 생성하거나 쓸 수 없습니다. data 디렉토리 권한을 확인해 주십시오." 같은 문구가 나오면 3단계의 707 권한이 제대로 들어갔는지 다시 확인하세요.

5단계 — 테마·스킨 고치기: 고칠 파일 찾기와 백업

디자인을 바꾸는 파일은 대부분 theme 또는 skin 폴더에 있습니다. 어느 쪽을 고칠지는 관리자 화면에서 무엇을 골라 두었는지에 따라 달라요(공식 소스 lib/common.lib.php의 스킨 경로 규칙).

"종류"는 board(게시판), latest(최신글), member(회원), outlogin(로그인 상자), search(검색) 같은 폴더 이름이에요.

고치기 전에 꼭 백업하기

1. 고칠 파일(또는 스킨 폴더 통째로)을 오른쪽 클릭 → [다운로드](Download)로 내 PC에 받아 둡니다.
2. 받은 파일은 "원본" 폴더에 따로 보관합니다. 고치다 화면이 깨지면 이 파일을 다시 올리면 원래대로 돌아와요.
3. 그다음에 고칩니다. 서버 파일을 바로 고치려면 오른쪽 클릭 → [보기/편집](View/Edit) → 서버 파일 바로 편집하기

사진을 누르면 크게 볼 수 있어요

1. 11. 고칠 파일 (예: theme/basic/head.php)
2. 22. 다운로드(D) — 고치기 전에 먼저 받아 백업
3. 33. 보기/편집(V) — 서버 파일을 바로 고치기

⚠️ [보기/편집]으로 저장하고 [예]를 누르면 서버 원본이 바로 바뀝니다. 방문자가 보는 사이트에 즉시 반영되니, 백업 없이 고치지 마세요.

⚠️ extend 폴더에는 "복사본"을 두지 마세요. 그누보드는 extend 폴더 안에서 이름이 .php로 끝나는 파일을 모두 매 페이지마다 자동으로 불러옵니다(공식 소스 common.php). user.config - 복사본.php처럼 백업용 사본을 남겨 두면 그 파일까지 실행돼요. extend 파일의 백업은 내 PC에 보관하세요.

🙋 새 버전으로 업데이트할 때 주의할 점 — 새 버전 파일을 올리면 같은 이름의 파일은 파일질라가 [대상 파일이 이미 존재함](Target file already exists) 창을 띄우고 덮어쓸지 묻습니다. theme/basic처럼 기본 폴더를 직접 고쳐 썼다면 새 파일로 덮어써질 수 있으니 먼저 백업해 두세요. 공식 README에 따르면 DB 변경이 들어간 버전은 파일을 올린 뒤 관리자 메뉴의 환경설정 → DB업그레이드에서 실행해야 합니다.

6단계 — 백업: data 폴더는 파일질라로, DB는 따로

사이트를 옮기거나 만일에 대비해 백업할 때, 파일질라로 받아야 하는 핵심은 data 폴더입니다. 첨부파일·에디터 이미지·회원 이미지·상품 이미지(영카트)가 모두 여기 들어 있어요.

1. 오른쪽 원격 사이트에서 data 폴더를 오른쪽 클릭 → [다운로드].
2. 직접 고친 theme, skin, extend 파일이 있다면 그것도 함께 받아 둡니다.
3. 서버에 따라 data/.htaccess처럼 점(.)으로 시작하는 파일이 목록에 안 보일 수 있어요. 이럴 땐 [서버](Server) 메뉴 → [숨김 파일 강제 표시](Force showing hidden files)를 켜고 다시 확인하세요.

⚠️ 게시글·회원 정보·주문 내역은 파일이 아니라 데이터베이스(DB)에 있습니다. FTP는 서버의 파일만 주고받을 수 있어서, 파일질라로는 DB를 백업할 수 없어요. 공식 README도 재설치 전 "파일과 데이터베이스를 백업"하라고 둘을 따로 말합니다. DB 백업은 호스팅사가 안내하는 방법으로 따로 받아 두세요.

🙋 data/file 안 파일 이름이 알아볼 수 없는 영문·숫자인데, 망가진 건가요? 아니요, 정상입니다. 그누보드는 첨부파일을 원래 이름 대신 무작위 영문·숫자 이름(+ 원래 확장자)으로 저장하고, 원래 파일 이름은 DB에 기록합니다(공식 소스 bbs/write_update.php). 그래서 data 폴더와 DB를 같은 시점에 함께 백업해야 나중에 게시글과 첨부파일의 짝이 맞아요.

영카트(쇼핑몰)를 쓴다면 더 알아 둘 것

• 쇼핑몰 기능 파일은 shop, 모바일 쇼핑몰은 mobile/shop, 테마의 쇼핑몰 디자인은 theme/테마이름/shop 폴더에 있습니다.
• 상품 이미지는 data/item에 저장됩니다. 백업할 때 data 폴더를 통째로 받으면 함께 들어옵니다.
• 공식 저장소의 perms.sh 파일은 본인확인(KCP·OKName)과 KCP 전자결제의 실행 파일 권한을 755로 바꾸는 스크립트입니다. 이 기능을 쓰는데 서버에서 명령을 실행할 수 없다면, 같은 파일(예: plugin/kcpcert/bin/ct_cli, shop/kcp/bin/pp_cli)을 파일질라 [파일 권한]에서 755로 바꾸면 스크립트와 같은 결과가 됩니다.

자주 하는 실수

자주 묻는 질문

Q. data 폴더를 통째로 지우고 새로 만들면 안 되나요? 안 됩니다. 첨부파일·이미지와 DB 접속 설정(dbconfig.php)이 모두 사라집니다. 권한만 바꾸려면 폴더를 지우지 말고 [파일 권한]만 다시 설정하세요.

Q. data 안의 하위 폴더(file, editor 등)도 707로 바꿔야 하나요? 공식 매뉴얼이 707로 안내하는 건 data 폴더입니다. 안의 하위 폴더는 설치 프로그램이 알아서 만들어요. 폴더 권한 창의 [하위 디렉터리로 이동](Recurse into subdirectories)을 켜서 한꺼번에 바꿀 필요는 없습니다.

Q. 어느 폴더가 내 사이트의 루트인지 모르겠어요. config.php와 common.php, 그리고 adm·bbs·theme 폴더가 한곳에 보이는 폴더가 그누보드의 루트입니다. data 폴더도 바로 그 자리에 있어야 해요.

Q. 지금 설치된 그누보드 버전은 어디서 보나요? 루트의 version.php에 적혀 있습니다(공식 README). 파일질라로 내려받아 메모장으로 열어 보면 G5_GNUBOARD_VER 옆에 버전 번호가 있어요.

참고한 공식 문서

• 그누보드5 공식 저장소 README: https://github.com/gnuboard/gnuboard5
• 그누보드(영카트) 5.6.40 공식 배포(GitHub Releases): https://github.com/gnuboard/gnuboard5/releases
• 그누보드5 공식 소스 — 설치 프로그램 권한 검사: https://github.com/gnuboard/gnuboard5/blob/master/install/install.inc.php
• 그누보드5 공식 소스 — 설치 시 data 하위 폴더·.htaccess 생성: https://github.com/gnuboard/gnuboard5/blob/master/install/install_db.php
• 그누보드5 공식 소스 — 폴더 이름·기본 권한 설정: https://github.com/gnuboard/gnuboard5/blob/master/config.php
• 그누보드5 공식 소스 — dbconfig.php 확인·extend 자동 불러오기: https://github.com/gnuboard/gnuboard5/blob/master/common.php
• 그누보드5 공식 소스 — 스킨 경로 규칙: https://github.com/gnuboard/gnuboard5/blob/master/lib/common.lib.php
• 그누보드5 공식 소스 — 첨부파일 저장 이름: https://github.com/gnuboard/gnuboard5/blob/master/bbs/write_update.php
• 그누보드5 공식 소스 — 실행 파일 권한 스크립트: https://github.com/gnuboard/gnuboard5/blob/master/perms.sh
• 그누보드5 공식 매뉴얼 (sir.kr): https://sir.kr/manuals/g5/1
• 그누보드5 공식 매뉴얼 — 그누보드5 설치하기: https://sir.kr/manuals/g5/2
• 그누보드5 공식 매뉴얼 — 테마설정: https://sir.kr/manuals/g5/24
• FileZilla Wiki — Other Features (Chmod): https://wiki.filezilla-project.org/Other_Features

이 글의 일부는 FileZilla 위키(GFDL)를 참고해 한국어로 새로 썼습니다. 파일질라 화면 문구는 3.71.1 한국어판으로 확인했습니다.

요약

한눈에 정리

1. 1data 폴더 707

   config.php 옆에 소문자 data 폴더를 만들고 [파일 권한]에서 707.

2. 2고치기 전에 내려받기

   theme·skin 파일은 PC에 백업한 뒤 고쳐요.

3. 3백업은 data + DB

   data 폴더는 파일질라로, DB는 FTP로 안 되니 따로.

최종 수정 2026-09-25