BOARD 문제 해결

서버 이전 후 CSS·이미지 깨짐 및 관리자 접근 불가 해결 방법

페이지 정보

작성자 최고관리자
댓글 0건 조회 3회 작성일 26-10-31 15:24

본문

서버를 옮긴 후 스타일시트나 이미지가 깨지고 관리자 페이지에 접근할 수 없을 때, 가상 폴더 환경과 config.php 파일의 도메인 상수(G5_DOMAIN) 설정 원인을 파악하고 해결하는 방법을 안내합니다.

서버 이전 후 CSS·이미지 깨짐 및 관리자 접근 불가 원인

서버를 이전한 후 CSS와 이미지가 깨지고 관리자 페이지나 로그인에 접근하지 못하는 현상은 주로 다음과 같은 원인으로 발생합니다.

가상 폴더 구조로 인한 경로 오류: 호스팅 서버의 상위 폴더 가상 폴더 세팅 구조 때문에 그누보드 상수 경로가 잘못 설정되어 절대/상대 경로 계산에 문제가 생길 수 있습니다.
동적 도메인 처리 및 상수 미고정: config.php 파일에서 G5_DOMAIN 등의 고정 도메인 설정이 누락되어 현재 주소가 동적으로 처리되거나, 메뉴 이동 시 호스팅사에서 제공하는 2차 도메인 또는 모바일 도메인으로 임의로 변경되면서 세션 및 로그인 오류가 발생합니다.

G5_DOMAIN 상수 설정 방법

서버 이전이나 호스팅 서버의 가상 폴더 구조로 인해 이미지와 CSS 경로가 깨지고, 관리자 페이지 접근이나 로그인이 되지 않을 때는 config.php 파일에서 도메인 경로를 직접 고정하여 해결할 수 있습니다.

1. 설정 파일 위치 및 확인

그누보드 설치 경로 내의 config.php 파일을 엽니다. 이 파일에서 G5_DOMAIN 상수를 찾아 현재 사용하는 정확한 도메인 주소를 입력해야 합니다.

2. G5_DOMAIN 및 관련 상수 설정 예시

보안서버를 사용하지 않는 경우, 아래와 같이 주소를 직접 입력하여 고정 주소로 사용하도록 설정합니다.

define('G5_DOMAIN', 'http://www.domain.com/gnuboard5');
define('G5_HTTPS_DOMAIN', '');
define('G5_COOKIE_DOMAIN', '');

주의 사항: 주소 뒤에 슬래시(/)를 붙이지 않도록 주의하며, 포트 번호가 있는 경우 https://www.domain.com:443/gnuboard5와 같이 포트 번호를 포함하여 입력합니다.

3. 적용 후 확인 사항

웹 브라우저에서 사이트에 접속하여 CSS와 이미지 파일이 정상적으로 로드되는지 확인합니다.
사이트 내 여러 메뉴로 이동했을 때 호스팅사 2차 도메인이나 모바일 도메인으로 임의로 변경되지 않고 설정한 대표 도메인으로 유지되는지 확인합니다.
관리자 페이지 접근 및 로그인 상태가 정상적으로 유지되는지 점검합니다.

메뉴 이동 시 도메인 변경 및 로그인 풀림 현상 확인 사항

그누보드5 환경에서 메뉴를 이동할 때 도메인이 호스팅 2차 도메인이나 모바일 도메인(m.youdie.net 등)으로 임의로 바뀌면서 로그인이 풀리는 현상이 발생할 때는 config.php 파일의 도메인 관련 상수 설정을 확인해야 합니다.

1. 확인 및 설정 위치

그누보드 설치 경로 내 config.php 파일을 엽니다.
파일 내에서 G5_DOMAIN, G5_HTTPS_DOMAIN, G5_COOKIE_DOMAIN 설정 항목을 확인합니다.

2. 점검 항목 및 조치 방법

G5_DOMAIN 설정: define('G5_DOMAIN', '');과 같이 비어 있는 경우 현재 주소가 동적으로 처리되어 에디터 이미지 첨부나 메뉴 이동 시 주소가 뒤죽박죽될 수 있습니다. define('G5_DOMAIN', 'http://www.domain.com/gnuboard5'); 형식으로 사용할 대표 주소를 직접 지정하여 고정해야 합니다.
G5COOKIEDOMAIN 설정: www.domain.com과 domain.com 같이 서브도메인이 다를 경우 쿠키를 공유하지 못해 로그인이 풀릴 수 있습니다. 쿠키를 공유하려면 define('G5_COOKIE_DOMAIN', '.domain.com');과 같이 도메인 앞에 점(.)을 포함하여 입력되어 있는지 확인합니다. 만약 포워딩 도메인이나 다른 도메인 충돌로 인해 로그인이 안 된다면 해당 설정 값을 점검하거나 필요에 따라 조정해야 합니다.

3. 다음 행동

config.php 수정 전 원본 파일을 백업한 뒤 도메인 주소를 올바르게 입력합니다.
수정 후 웹브라우저에서 사이트의 여러 메뉴로 이동했을 때 도메인이 임의로 변경되지 않고 고정되는지, 로그인 세션이 유지되는지 확인합니다.

서버 이전 후 경로 및 도메인 설정 오류 확인 및 대처

서버 환경이나 PHP 버전 차이로 인해 사이트 접속이나 관리자 페이지 이용이 불가능할 때는 설정 파일과 서버 환경을 순차적으로 점검해야 합니다.

1. PHP 버전 차이 확인

사이트 이전 전후의 PHP 버전이 다를 경우 오류가 발생할 수 있습니다 (예: 기존 PHP 5.4.16에서 PHP 7.4 환경으로 변경된 사례).
호스팅 환경 또는 APM 버전 차이가 있는지 체크합니다.
PHP 버전 환경을 맞추거나 호환성을 검토합니다.

2. G5_DOMAIN 상수 및 경로 확인

config.php 파일에서 G5_DOMAIN 설정이 비어 있거나 올바르지 않은 경우 현재 주소가 동적으로 처리되어 에디터 이미지 첨부 경로가 뒤죽박죽되거나 마이그레이션 시 문제가 발생할 수 있습니다.
config.php 파일에 대표 주소를 직접 고정하여 정의합니다.
- 예시: define('G5_DOMAIN', 'http://www.domain.com/gnuboard5');
쿠키 공유 도메인 설정(G5_COOKIE_DOMAIN)이나 보안서버 도메인 설정에 불필요한 값이 들어가 있거나 도메인 불일치가 발생하는지 확인합니다.

3. 가상 폴더 구조 점검

호스팅 서버의 상위 폴더 가상 폴더 구조로 인해 상대/절대 경로 오류가 발생할 수 있습니다.
SSH 등으로 서버 상태를 살펴 실제 경로와 웹에서의 절대 경로를 확인합니다.

상황별 판단 및 대응 가이드

내 상황	선택 기준	다음 행동
서버 이전 후 CSS·이미지 깨짐 및 관리자 접근 불가	호스팅 서버 가상 폴더 구조 확인 및 `config.php` 상수 설정 누락	`config.php` 파일에 `define('G5_DOMAIN', 'http://www.domain.com/gnuboard5');`와 같이 실제 도메인을 고정 입력
메뉴 이동 시 호스팅 2차 도메인으로 변경되며 로그인 풀림	쿠키 공유 도메인 설정(`G5_COOKIE_DOMAIN`) 불일치	`config.php`에서 `G5_COOKIE_DOMAIN`을 `.domain.com` 형식으로 설정하여 서브도메인 간 쿠키 공유 확인
이전 전후 서버 간 PHP 버전 차이 발생	PHP 버전 불일치로 인한 시스템 오류 가능성	호스팅 환경의 PHP 버전을 이전 서버와 동일하게 맞추거나 호환성 점검

실전 FAQ

Q. config.php 수정 후에도 로그인이 계속 풀립니다.

G5_COOKIE_DOMAIN 설정이 비어 있거나 잘못되었을 수 있습니다. www.domain.com과 domain.com처럼 서브도메인이 다를 경우 쿠키가 공유되지 않으므로, .domain.com과 같이 입력하여 쿠키 공유 범위를 지정하세요.

Q. 가상 폴더 구조로 인해 절대 경로가 꼬이는 경우 어떻게 확인하나요?

SSH 접속이 가능하다면 cd.. 명령을 통해 최상위 경로까지 접근하여 실제 서버 경로와 웹에서 인식하는 절대 경로가 일치하는지 확인해야 합니다. 호스팅사마다 가상 폴더 세팅이 다를 수 있으므로, 경로가 불일치할 경우 G5_DOMAIN을 고정하여 강제로 경로를 지정하는 것이 대안입니다.

참고자료

기타 참고자료

다음글그누보드 이미지맵 하이라이트 적용 시 이미지 중앙 정렬 무효화 문제 해결 방법 26.10.31

댓글목록

등록된 댓글이 없습니다.