그누보드·영카트 설치 경로 변경 및 루트 디렉토리 이동 가이드
페이지 정보

본문
하위 폴더(g5, yc5)에 설치된 그누보드와 영카트를 루트 디렉토리로 옮겨 도메인 주소만으로 바로 접속하고 관련 오류를 해결하는 방법을 안내합니다.
그누보드·영카트 루트 디렉토리 이동 및 설정 방법
도메인 주소만 입력했을 때 /g5 또는 /yc5 하위 폴더 경로를 붙이지 않고 곧바로 사이트에 접속되도록 설정하려면 FTP를 통해 설치 파일을 루트 디렉토리로 이동해야 합니다.
1. FTP 파일 이동 절차
- FTP 프로그램 상에서 g5 또는 yc5 폴더 내부로 진입합니다.
- 단축키
Ctrl + A를 누르거나 마우스로 전체 폴더와 파일을 선택합니다. - 마우스 왼쪽 버튼을 누른 채로 루트 디렉토리(서버에 따라
www등일 수 있으며, g5 상위 디렉토리)로 드래그하여 이동시킵니다. - 파일 이동이 완료된 후 기존의
g5폴더는 삭제해도 무방합니다. 단, 서버에 다른 폴더가 많을 경우 드래그 시 다른 위치로 잘못 이동하지 않도록 유의해야 합니다.
2. 이동 후 필수 조치
- 파일을 루트로 이동한 후 관리자 페이지에 접속하여 환경설정 > 캐시파일 일괄삭제를 한 번 클릭해 줍니다.
- 루트 디렉토리로 이동한 후에는
config.php파일 내의G5_PATH,G5_URL등의 절대 경로 설정값이 현재의 루트 경로와 일치하는지 확인해야 합니다. 경로가 다를 경우 사이트 접속 오류가 발생할 수 있으므로, 필요시 해당 값을 루트 경로에 맞게 수정하십시오.
파일 루트 이동 후 게시판 링크 404 오류 원인과 조치
하위 폴더(g5, yc5 등)에 설치된 그누보드 파일을 루트 디렉토리로 이동한 후 초기 화면은 정상적으로 표시되나 게시판 링크를 클릭했을 때 페이지를 찾을 수 없다는 오류(The requested URL /notice was not found on this server)가 발생하는 원인은 관리자 페이지에 등록된 메뉴 및 게시판의 링크 경로가 이전 하위 폴더 경로 기준으로 설정되어 있기 때문입니다.
확인 및 조치 방법
- 관리자 페이지 메뉴 링크 확인: 관리자 페이지의 메뉴 관리 페이지로 이동하여 설정된 링크 경로가 올바른지 확인해야 합니다.
- 스킨 설정 점검: 게시판의 스킨 설정 상태를 함께 점검합니다.
범위 및 한계: 루트 디렉토리 이동 작업 시 파일은 정상적으로 옮겨지더라도 데이터베이스나 관리자 메뉴에 하위 폴더 경로가 남아 있는 경우 링크 깨짐 현상이 발생할 수 있습니다. 관리자 메뉴 설정에서 경로를 올바르게 수정해야 합니다.
루트 디렉토리 이동 후.htaccess 파일 수정
그누보드 파일을 하위 폴더에서 루트 디렉토리로 이동한 후, 아파치(Apache) 서버 환경에서는 루트 디렉토리에 위치한 .htaccess 파일을 수정하여 하위 폴더 경로 지정을 해제하고 정상적으로 루트 연결을 유지해야 합니다.
파일을 루트로 이동한 후 아파치 서버 환경에서는 .htaccess 파일 내의 RewriteBase 설정을 확인해야 합니다. 기존에 하위 폴더(예: /g5/)로 설정되어 있던 RewriteBase 값을 루트 경로인 RewriteBase /로 수정해야 정상적인 링크 연결이 유지됩니다.
루트 디렉토리 이동 후 관리자 페이지 조치 방법
그누보드나 영카트를 하위 폴더에서 루트 디렉토리로 이동한 후, 사이트 구동이나 화면 반영에 문제가 발생할 때 관리자 페이지에서 실행해야 하는 기본 조치는 다음과 같습니다.
캐시 파일 일괄삭제
- 이동 위치: 관리자 페이지 > 환경설정 > 캐시파일 일괄삭제
- 실행 방법: 해당 메뉴를 클릭하여 캐시 파일을 일괄 삭제합니다.
- 적용 목적: 파일 이동 후 발생할 수 있는 시각적 오류와 설정 반영 문제를 해결하는 데 도움을 줍니다.
상황별 판단 및 행동 가이드
| 내 상황 | 우선할 판단 | 다음 행동 |
|---|---|---|
하위 폴더(g5, yc5)에 설치되어 도메인 뒤에 경로를 붙여야만 접속되는 상태 | FTP를 이용한 루트 디렉토리 파일 전체 이동 실행 | g5/yc5 폴더 내부로 진입하여 전체 선택(Ctrl + A) 후 상위 루트 디렉토리로 드래그하여 이동 후 기존 하위 폴더 삭제 |
| 루트로 파일을 옮긴 후 메인 화면은 뜨나 게시판 링크 클릭 시 404 오류가 발생하는 상태 | 관리자 페이지 내 링크 및 메뉴 설정 경로 확인 | 관리자 페이지의 환경설정에서 캐시파일 일괄삭제를 실행하고, 메뉴 관리 및 스킨 설정에서 이전 하위 폴더 경로가 남아있는지 체크 후 수정 |
| 파일 이동 후 아파치 서버 환경에서 주소 리디렉션이나 링크 처리에 문제가 생기는 상태 | 루트 디렉토리의 .htaccess 파일 설정 점검 | 루트에 위치한 .htaccess 파일의 Rewrite 규칙 및 경로 설정이 루트 환경에 맞게 적용되었는지 확인 후 수정 |
실전 FAQ
Q. FTP로 파일을 루트 디렉토리에 모두 옮겼는데 기존 g5 폴더를 바로 삭제해도 데이터가 유실되지 않나요?
- 예외 및 대안: 파일을 올바르게 드래그하여 루트 디렉토리로 이동시켰다면 기존
g5하위 폴더는 삭제해도 무방합니다. 단, 서버 내에 다른 폴더들이 혼재되어 있어 드래그 도중 다른 경로로 잘못 이동될 수 있으므로 이동 완료 상태를 먼저 확인해야 합니다.
Q. 루트 디렉토리 이동 후 관리자 메뉴나 게시판 링크에서 페이지를 찾을 수 없다는 오류가 발생할 때 어디를 점검해야 하나요?
- 막히는 지점 및 조치: 화면은 정상적으로 출력되나 게시판 링크에서 404 오류가 발생하는 것은 관리자 페이지에 등록된 링크 경로가 이전 하위 폴더(
g5/yc5)를 가리키고 있기 때문입니다. 관리자 페이지의 메뉴 관리 및 게시판 관리에서 설정된 링크와 스킨 지정 상태를 점검하여 올바른 루트 경로로 수정해야 합니다.
함께 보면 좋은 글
참고자료
기타 참고자료
- sir.kr — 그누보드5를 /g5/ 폴더에 설치했는데요. / 루트폴더로 이동하는 방법 좀 알려주세요~^^ - SIR - 개발자 커뮤니티
- gnustudy.com — 도메인 주소 끝에 g5 또는 yc5 제거하기 - 그누보드팁
- sir.kr — g5 디렉토리에 그누보드 설치 - SIR - 개발자 커뮤니티
- sir.kr — 그누보드 g5url, g5path 경로 지정하는 방법... - SIR - 개발자 커뮤니티
- sir.kr — 그누보드 최신버전 (5.0.36) 살펴보기 - config.php - SIR - 개발자 커뮤니티
- sir.kr — 그누보드 설치한 폴더 경로 변경하는 법 - SIR - 개발자 커뮤니티
- sir.kr — htaccess 설정 방법 - SIR - 개발자 커뮤니티
- 이전글그누보드 반응형 사이트에서 이미지맵(Image Map)이 깨질 때 해결하는 방법 26.09.24
- 다음글그누보드 관리자 페이지 회원 완전 삭제 기능 추가 및 목록 출력 개수 조절 가이드 26.09.23
댓글목록
등록된 댓글이 없습니다.