주시 편집 토론 문서 역사

라이믹스/설치

< 라이믹스
넘겨주기 : 라이믹스/매뉴얼/라이믹스 설치
-
“

라이믹스는 PHP로 만들어져 있습니다.
PHP는 국내외 대부분의 웹호스팅 서버에서 간단히 업로드하거나 압축을 풀기만 하면 별도의 서버 설정 없이 곧바로 사용이 가능하다는 장점이 있기 때문에, 전세계적으로 가장 많이 사용되는 CMS들은 대부분 PHP로 만들어져 있습니다.

”
 

목표[편집 / 원본 편집]

라이믹스를 설치해보자.

필수사양[편집 / 원본 편집]

아파치, PHP, MySQL과 같은 필수 설치요소는 LAMP 문서 등을 확인하자.

나머지 필요한 PHP 확장기능들과 퍼미션, php.ini 설정은 라이믹스/매뉴얼/설치 환경 문서를 확인하자.

요약하면 PHP 7.4 이상(8.2 이상 권장), MySQL 5.7 이상 또는 MariaDB 10.6 이상이 필요하다.[1]

설치 방법 선택[편집 / 원본 편집]

공식 매뉴얼은 세 가지 방법을 안내한다.[2]

방법 필요 조건 특징
정식 버전 압축 파일 FTP/SFTP만 있으면 됨 가장 무난하다. 대부분의 웹호스팅에서 사용 가능
Development Snapshot FTP/SFTP만 있으면 됨 개발 중인 최신 코드. 정식 버전보다 빠르게 수정이 반영되지만 안정성은 낮다
git SSH 접속과 git 사용 가능 이후 업데이트가 가장 편하다. 브랜치 선택도 가능

운영 중인 사이트라면 정식 버전을 쓰는 것이 좋다. Development Snapshot은 정식 버전에 아직 반영되지 않은 수정이 필요할 때 선택하되, 자주 업데이트할 각오를 해야 한다.[2]

브랜치[편집 / 원본 편집]

git으로 설치할 경우 브랜치를 고를 수 있다. 2026년 8월 기준 공식 저장소의 브랜치는 다음과 같다.[3]

브랜치 설명
master 기본 브랜치. 최신 정식 버전이 반영된다. 특별한 이유가 없다면 이것을 쓰자
v2.2 다음 버전인 2.2를 준비하는 브랜치. 개발 중이므로 운영 사이트에는 적합하지 않다
v2.1 2.1 버전대 유지보수 브랜치
v2.0 2.0 버전대 유지보수 브랜치
v1.9 1.9 버전대 유지보수 브랜치. 이미 지원이 종료되었다
※ 과거에는 develop과 next 브랜치를 사용했으나 현재는 존재하지 않는다. next는 2.0 준비용으로 쓰이던 브랜치로, 자세한 내용은 라이믹스/Next 라이믹스 문서를 참고하자.
※ 2.1.36을 기점으로 2.1은 긴급 보안 패치 외에는 업데이트되지 않으며, 개발의 초점이 2.2로 옮겨졌다.[4]

파일 다운로드[편집 / 원본 편집]

압축 파일로 다운로드[편집 / 원본 편집]

공식 홈페이지에서 최신 정식 버전 또는 Development Snapshot을 내려받는다. 두 가지 방법이 있다.[2]

  • 로컬에서 압축을 풀고 전체 파일을 FTP/SFTP로 업로드
  • 압축 파일을 업로드한 뒤 SSH로 접속해 서버에서 압축 해제

서버에서 압축을 푸는 편이 훨씬 빠르고 안전하다. FTP 프로그램은 파일이 수천 개에 달할 경우 일부를 누락하는 경우가 있으므로, 로컬에서 풀어 올렸다면 업로드가 온전히 끝났는지 확인해야 한다.[2]

서버에서 압축을 풀면 rhymix 폴더가 생기므로 그 안의 내용을 상위 폴더로 옮겨야 한다. 이때 .htaccess 같은 숨김 파일이 빠지지 않도록 주의해야 한다.[2]

git으로 다운로드(추천)[편집 / 원본 편집]

대부분의 웹호스팅이나 VPS에서는 git을 지원하기 때문에 git을 사용하면 다운로드 및 업그레이드가 수월하다.

git으로 다운로드를 받으면, 브랜치도 선택이 가능하기 때문에 권장합니다. 브랜치 선택은 git clone -b 브랜치명 https://github.com/rhymix/rhymix 입니다.

웹 호스팅[편집 / 원본 편집]

웹 호스팅에서는 public_html 과 같은 폴더에 파일을 넣어 사용하는 식인데, git clone는 폴더 생성 후 폴더 안에 다운로드를 받는 방식이라 "example.com/rx" 이런 형식으로 사용해야 하기 때문에, 루트 폴더로 이동하는 방식으로 설명합니다. 

user@server:/public_html # git clone https://github.com/rhymix/rhymix rx
user@server:/public_html # cd rx
user@server:/public_html/rx # cp -r * ../
user@server:/public_html/rx # cd ..
user@server:/public_html # rm -rf rx
user@server:/public_html # mkdir files
user@server:/public_html # chmod -R 707 files

rx 폴더에 다운로드 받은 뒤, rx 폴더 안에 있는 모든 파일(폴더)들을 상위 폴더로 복사 후, rx 폴더로 이동하는 방식으로 진행합니다.

※ cp -r *는 .git, .htaccess 같은 숨김 파일을 복사하지 않는다. .htaccess는 짧은주소 사용에 필요하므로 cp -r rx/.htaccess ./ 처럼 따로 옮기거나, cp -a rx/. ./를 사용하자.

가상서버[편집 / 원본 편집]

/var/www/html을 라이믹스가 설치할 폴더로 설정합니다. 

root@gaon:~ # cd /var/www
root@gaon:/var/www # git clone https://github.com/rhymix/rhymix html
root@gaon:/var/www # cd html
root@gaon:/var/www/html # mkdir files
root@gaon:/var/www/html # chmod -R 707 files

git clone 이후 files 폴더를 생성 후 권한을 줍니다.

files 폴더에는 첨부파일이나 각종 설정 파일들이 생성되는 곳입니다.

files 폴더 권한[편집 / 원본 편집]

files 폴더에는 첨부파일, 설정 파일, 캐시가 저장되므로 웹서버가 쓸 수 있어야 한다. 퍼미션은 707 또는 777로 설정한다.

가능하면 707을 먼저 시도하자. 777은 같은 서버의 다른 사용자도 파일을 읽고 쓸 수 있게 되므로, 707로 동작한다면 굳이 777을 줄 이유가 없다. 

root@gaon:/var/www/html # chmod -R 707 files

설치 경로에 쓰기 권한이 있으면 설치 과정에서 files 폴더가 자동으로 생성된다. 최근에는 PHP 실행 권한을 FTP 계정과 일치시켜 두는 호스팅이 많아 별도 설정이 필요 없는 경우도 있다.[2]

웹 설치[편집 / 원본 편집]

파일을 올린 뒤 브라우저로 설치 경로에 접속하면 설치 마법사가 시작된다. 과정은 네 단계이다.[2]

  1. 사용권 동의 — GPL 라이선스에 동의해야 다음으로 넘어간다. 언어는 화면 하단에서 언제든 바꿀 수 있다.
  2. 설치 환경 확인 — PHP 버전과 필수 모듈, 퍼미션을 점검한다. mod_rewrite는 선택 사항이므로 없어도 설치는 진행된다.
  3. DB 정보 입력 — 데이터베이스 종류와 접속 정보를 입력한다. 대개 localhost에 포트는 3306이다. 테이블 접두사는 rx 또는 xe를 권장한다.
  4. 관리자 계정 생성 — 최고관리자 계정과 사용 가능한 이메일 주소를 입력한다. 표준 시간대는 국내 사이트라면 Asia/Seoul을 선택한다. SSL 사용 여부와 사이트 잠금도 이 단계에서 설정할 수 있다.

설치에는 10~30초 정도 걸린다. 완료되면 화면의 설정 아이콘을 통해 관리자 페이지로 들어갈 수 있다.[2]

※ XE는 설치 언어 선택과 FTP 정보 입력을 포함해 여덟 단계를 거쳤다. 두 설치 과정의 차이는 라이믹스/XE와의 차이점 문서에 정리되어 있다.

설치 후[편집 / 원본 편집]

  • 짧은주소 — Apache는 mod_rewrite와 .htaccess가 있어야 하고, nginx는 rewrite 설정을 직접 넣어야 한다.
  • 크론 — 메일 발송이나 푸시 알림의 비동기 처리(Queue)를 쓰려면 크론 설정이 필요하다. 웹호스팅 환경이라면 웹크론을 따로 걸어야 한다. 불필요한 데이터를 지우는 정리 스크립트도 함께 등록해 두면 좋다. 라이믹스/매뉴얼/Crontab 설정 방법 문서를 참고하자.
  • 캐시 — apcu가 설치되어 있으면 관리자 화면에서 캐시로 지정해 성능을 올릴 수 있다.
  • 업데이트 — 라이믹스는 보안 패치가 잦으므로 설치 직후 최신 버전인지 확인하자. 방법은 라이믹스/매뉴얼/라이믹스 업데이트 문서를 참고하자.

문제 해결[편집 / 원본 편집]

  • HTTP 500 오류 / BaseObject 오류 — 서드파티 자료가 PHP 7.2부터 사라진 Object 클래스를 쓰는 경우이다. 해결 방법은 설치 환경 문서를 참고하자.
  • 첨부파일 업로드 실패 — files 폴더 퍼미션을 확인하자.
  • 화면이 깨지거나 일부 파일이 없다는 오류 — FTP 업로드 중 파일이 누락되었을 가능성이 크다. 서버에서 압축을 푸는 방식으로 다시 시도하자.
  • 짧은주소만 404 — .htaccess가 업로드되지 않았을 가능성이 크다. 숨김 파일이 포함되었는지 확인하자.
  • XE에서 넘어오는 경우라면 라이믹스/XE에서 넘어오기 문서를 참고하자. 새로 설치하는 것과 절차가 다르다.

같이 보기[편집 / 원본 편집]

각주[편집 / 원본 편집]

  1. ↑ 설치 환경 - 라이믹스 매뉴얼
  2. ↑ 2.0 2.1 2.2 2.3 2.4 2.5 2.6 2.7 라이믹스 설치 - 라이믹스 매뉴얼
  3. ↑ rhymix/rhymix - GitHub
  4. ↑ Rhymix 2.1.36 Release Notes
원본 주소 "https://www.gaonwiki.com/w/index.php?title=라이믹스/설치&oldid=108228"

최근 바뀜

더 보기