개요
라이믹스는 멀티도메인을 지원하므로 도메인을 처리하는 방법이 XE 1.x와 다릅니다. 아래의 순서를 따르면 대부분의 경우 DB나 설정 파일을 직접 수정할 필요가 없습니다.
변경 전 도메인이 old.example.com, 변경 후 도메인이 new.example.com이라고 가정합니다.
사전 준비
- 설치 파일과 DB를 백업하고 현재 도메인 설정을 기록한다.
- 새 도메인의 DNS가 같은 서버를 가리키고, 웹서버의 가상 호스트와 HTTPS 인증서가 새 도메인을 처리하는지 확인한다. 라이믹스의 도메인 등록은 DNS·웹서버·인증서 설정을 대신하지 않는다.
- 외부 로그인·결제·메일 등 도메인에 의존하는 서비스가 있다면 콜백 URL과 허용 도메인의 변경 필요 여부도 확인한다.
도메인 변경 전
old.example.com으로 접속하여 관리자 화면에서 "시스템 설정" 메뉴에 들어갑니다.- "새 도메인 추가"를 클릭하고,
new.example.com을 추가합니다. 모든 설정은old.example.com과 동일하게 합니다. - "시스템 설정" 화면으로 돌아와서 "등록되지 않은 도메인 처리" 옵션을 "메인 화면 표시"로 변경한 후 저장합니다. 원래 설정이 "메인 화면 표시"였다면 변경하지 않아도 됩니다.
도메인 변경 후
new.example.com으로 접속하여 관리자 화면에서 "시스템 설정" 메뉴에 들어갑니다.new.example.com수정 화면으로 들어가서 "기본 도메인"을 선택한 후 저장합니다.- 새 도메인에서 로그인·글쓰기·첨부파일이 정상 동작하는지 확인한 뒤, 기존 도메인을 더 이상 사용하지 않을 경우 라이믹스의 기존 도메인 등록을 삭제합니다. 이전 주소에서 새 주소로 보내는 리다이렉트는 웹서버·CDN 등의 별도 설정으로 관리합니다.
- "시스템 설정" 화면으로 돌아와서 "등록되지 않은 도메인 처리" 옵션을 원래대로 돌려놓습니다. 원래 설정이 "메인 화면 표시"였다면 변경하지 않아도 됩니다.
도메인 변경 전에 설정을 변경하지 못한 경우
도메인 변경 전에 설정을 미리 바꿔 놓지 않으면 기존 도메인으로 계속 리다이렉트될 수 있습니다. 관리자 화면에 접근할 수 없어 정상 절차를 진행할 수 없다면, 먼저 DB를 백업하고 테이블 접두사·현재 등록 값을 확인한 뒤 공식 매뉴얼의 복구 쿼리를 적용합니다.
UPDATE rx_domains SET domain = 'new.example.com' WHERE domain = 'old.example.com';
사용하시는 테이블 접두사(rx_)에 따라 적절히 응용하십시오.
쿼리 실행 후에는 설치 경로의 files/cache 아래 캐시를 정리하여 기존 도메인 정보가 남지 않도록 합니다. 정확한 설치 경로를 확인하고, 첨부파일·설정이 있는 files 전체를 삭제하지 않습니다.
설정 파일
라이믹스는 XE 1.x와 달리 도메인 변경시 db.config.php 또는 config.php 파일에서 "기본 URL"을 직접 수정할 필요가 없고, 수정하더라도 의미가 없습니다.
기본 URL이라는 개념 자체를 사용하지 않습니다. 설정 파일에 남아 있는 URL은 XE 1.x 방식에 의존하는 일부 자료를 위한 호환성을 위한 것이며, 코어에서 참조하지 않습니다.
단, "등록되지 않은 도메인 처리" 옵션이 잘못되어 기존 도메인으로 계속 리다이렉트되는 경우 files/config/config.php에서 unregistered_domain_action 설정을 display로 바꾸어 주면 도움이 될 수 있습니다.
접근 복구 후에는 임시로 바꾼 미등록 도메인 처리 설정을 원래 운영 정책으로 돌려놓습니다.
변경 후 확인
- 기본 도메인과 HTTPS 이동이 정상인지 확인합니다.
- 로그인·쿠키·외부 로그인 콜백과 주요 기능을 확인합니다.
- 본문에 직접 입력한 절대 URL, 외부 서비스 설정 등은 별도로 점검합니다.
같이 보기
출처
라이믹스 공식 매뉴얼의 도메인 변경을 바탕으로 DNS·HTTPS 사전 준비와 변경 후 점검을 보완하였습니다. 공식 매뉴얼은 CC BY-SA 4.0으로 배포됩니다.