회원 로그인
JusQ 1.0 설치 가이드
처음 설치하는 분도 순서대로 진행할 수 있도록 서버 준비부터 설치 완료 확인까지 정리했습니다.
Linux 권장PHP 7.4 이상MySQL 5.7 이상HTTPS 권장
1. 설치 전 준비사항
웹 서버Apache 2.4 이상을 권장합니다. Nginx 또는 IIS에서는 주소 재작성 규칙을 서버 환경에 맞게 설정해야 합니다.
PHPPHP 7.4 이상을 권장하며 8.x 환경을 지원합니다. mysqli, mbstring, json, curl, gd, zip 확장을 준비해 주세요.
데이터베이스MySQL 5.7/8.x 또는 호환되는 MariaDB와 빈 데이터베이스가 필요합니다. 문자셋은 utf8mb4를 권장합니다.
접속 정보도메인, FTP/SFTP 또는 SSH 정보, DB 호스트·이름·사용자·비밀번호를 설치 전에 준비해 주세요.
기존 사이트가 있는 위치에는 바로 덮어쓰지 마세요. 먼저 파일과 데이터베이스를 백업하거나 빈 폴더에서 설치하는 것을 권장합니다.
2. 데이터베이스 준비
호스팅 관리 화면이나 phpMyAdmin에서 JusQ가 사용할 빈 데이터베이스와 전용 사용자를 만듭니다. 설치 화면에는 다음 정보가 필요합니다.
| DB 호스트 | 일반적으로 localhost이며 호스팅 업체가 별도 주소를 제공할 수 있습니다. |
|---|---|
| DB 이름 | JusQ가 테이블을 생성할 빈 데이터베이스 이름 |
| 사용자 / 비밀번호 | 해당 데이터베이스에 생성·수정 권한이 있는 전용 계정 |
| 테이블 접두어 | 기본값 jus. 하나의 DB에 여러 사이트를 설치할 때는 서로 다르게 지정합니다. |
보안을 위해 MySQL의
root 계정보다는 해당 데이터베이스에만 권한을 가진 전용 계정을 사용하는 것이 좋습니다.3. 파일 업로드와 권한 설정
- 배포파일 압축 해제
ZIP 또는 TAR.GZ 파일을 내려받아 원하는 웹 루트에 압축을 풉니다. 도메인의 DocumentRoot가 이 폴더를 가리키는지 확인합니다. - 웹 서버가 필요한 폴더에 쓸 수 있도록 설정
Ubuntu와 Apache 환경에서는 설치 폴더의 소유권을 웹 서버 사용자에게 맞추는 방식이 가장 간단합니다.sudo chown -R www-data:www-data /var/www/html/jusq sudo find /var/www/html/jusq -type d -exec chmod 755 {} \; sudo find /var/www/html/jusq -type f -exec chmod 644 {} \; - 설치 페이지 열기
브라우저에서 연결한 도메인 또는 설치 경로로 접속하면 JusQ Installer가 자동으로 시작됩니다.
전체 폴더를
777 또는 707로 열어 두는 방식은 권장하지 않습니다. 서버마다 웹 서버 사용자가 다를 수 있으므로 호스팅 환경에서는 업체 안내에 따라 쓰기 권한을 설정하세요.4. JusQ Installer 진행
- 라이선스
라이선스 내용을 확인하고 동의합니다. - 데이터베이스 정보
DB 호스트, 이름, 사용자, 비밀번호와 테이블 접두어를 입력한 후 연결을 확인합니다. - 관리자 정보
관리자 이름과 아이디, 이메일을 입력합니다. 비밀번호는 12자 이상으로 설정하고 다른 서비스와 중복 사용하지 마세요. - 사이트 생성
사이트 명칭과 기본 패키지를 선택한 뒤 설치를 시작합니다. 설치 중에는 창을 닫거나 새로고침하지 마세요.
5. 설치 완료 후 확인
- 메인 페이지와 관리자 페이지에 정상적으로 접속되는지 확인합니다.
- 관리자에서 사이트, 메뉴, 페이지와 게시판을 생성해 저장 여부를 점검합니다.
- 이미지 및 첨부파일 업로드가 정상적으로 작동하는지 확인합니다.
- 실서비스 도메인은 HTTPS 인증서를 적용하고 HTTP 접속을 HTTPS로 전환합니다.
- 설치가 끝난 뒤 파일과 데이터베이스를 한 번 백업합니다.
6. 설치가 진행되지 않을 때
| 설치 화면이 계속 멈춤 | DB 접속정보, PHP 오류 로그, 디스크 여유 공간과 파일 쓰기 권한을 확인합니다. |
|---|---|
| DB 연결 실패 | DB 호스트·포트·이름을 다시 확인하고 해당 사용자에게 테이블 생성 권한이 있는지 점검합니다. |
| 파일 생성/업로드 실패 | 웹 서버 사용자가 설치 폴더와 첨부파일 저장 폴더에 쓸 수 있는지 확인합니다. |
| 설치 후 화면 오류 | 도메인의 DocumentRoot, Apache rewrite 모듈과 .htaccess 허용 설정을 확인합니다. |
JusQ 1.0 배포파일과 체크섬ZIP 다운로드 SHA-256 확인


8
1