사용자 가이드

설치하기

Zittme를 설치하는 과정을 안내합니다. 환경은 크게 둘로 나뉩니다.

웹 호스팅: 호스팅 업체에 가입해서 쓰는 환경. DB와 웹서버가 이미 준비되어 있어 파일만 올리면 됩니다.
개인 서버(VPS): 서버를 직접 운영하는 환경. 웹서버·DB를 직접 준비합니다.

자신의 환경에 맞는 쪽만 따라가면 됩니다. 설치 마법사부터는 두 환경이 같습니다.

설치 환경

항목	요구 사항
PHP	7.4 이상 (8.2 이상 권장)
데이터베이스	MySQL 5.7 이상 또는 MariaDB 10.6 이상 (utf8mb4)
웹서버	nginx 또는 Apache
필수 PHP 확장	curl, gd, iconv 또는 mbstring, json, openssl, PDO_MySQL, SimpleXML, Zend OPcache
권장 PHP 확장	apcu(성능), exif(이미지 자동 회전), fileinfo(첨부 보안 검사), intl, zip
PHP 설정	`session.auto_start=off`, `memory_limit` 128MB 이상, `upload_max_filesize` 10MB 이상

국내 웹 호스팅(카페24, 닷홈, 가비아 등)의 PHP 호스팅 상품이면 대부분 충족합니다. 가입 시 PHP 버전을 고를 수 있다면 8.2 이상을 선택하세요. 어차피 설치 마법사의 환경 확인 단계에서 부족한 항목을 짚어 줍니다.

배포본 내려받기 (공통)

zitt.me 릴리즈 페이지에서 최신 배포본을 내려받습니다. 현재 베타 기간에는 테스터로 등록된 회원만 내려받을 수 있습니다.

---

A. 웹 호스팅에 설치하기

A-1. DB 정보 확인

웹 호스팅은 가입할 때 DB가 함께 만들어집니다. 호스팅 관리 페이지(내 서비스 관리 등)에서 아래 값을 확인해 두세요. 설치 마법사에서 그대로 입력합니다.

DB 호스트 (보통 localhost)
DB 이름
DB 사용자 이름
DB 비밀번호 (가입 시 정한 값)

A-2. 파일 올리기

내려받은 배포본의 압축을 내 컴퓨터에서 먼저 풀고, FTP 프로그램(FileZilla 등)으로 호스팅의 웹 루트에 올립니다. 웹 루트 폴더 이름은 업체마다 다릅니다 (www, public_html, html 등).

파일이 수만 개라 FTP 업로드에 시간이 걸리고, FTP 프로그램은 파일 수천 개를 올릴 때 일부를 빠뜨리는 경우가 있습니다. 업체가 압축 해제 기능(웹 파일관리자)을 제공하면 tgz/zip을 올린 뒤 서버에서 푸는 쪽이 빠르고 안전합니다.
업로드 후 index.php 가 웹 루트 바로 아래에 있는지 확인하세요. zittme/index.php 처럼 한 단계 안에 들어가 있으면 폴더 안의 내용물을 웹 루트로 옮겨야 합니다. 이때 .htaccess 같은 숨김 파일도 함께 옮겨야 합니다.
웹 루트에 files 폴더를 만들고 파일관리자에서 권한을 707(또는 777)로 설정하세요. 사이트의 모든 업로드·캐시가 이 폴더에 저장됩니다.

A-3. 접속

브라우저로 내 도메인(또는 호스팅이 준 임시 주소)에 접속하면 설치 마법사가 시작됩니다. 아래 "설치 마법사" 절로 이동하세요.

대부분의 웹 호스팅은 Apache라서 배포본에 든 .htaccess 가 짧은 주소를 자동으로 처리합니다. 별도 설정이 필요 없습니다.

---

B. 개인 서버(VPS)에 설치하기

셸(SSH) 접속이 가능한 서버 기준입니다.

B-1. 파일 올리기

tar xzf zittme-0.0.01.tgz -C /var/www/mysite
mkdir -p /var/www/mysite/files
chown -R www-data:www-data /var/www/mysite

웹서버 계정(위 예시는 www-data)이 files 폴더를 쓸 수 있어야 설치가 진행됩니다. 사이트의 모든 업로드·캐시·설정이 이 폴더에 저장됩니다.

B-2. 데이터베이스 만들기

CREATE DATABASE mysite DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'mysite'@'localhost' IDENTIFIED BY '비밀번호';
GRANT ALL PRIVILEGES ON mysite.* TO 'mysite'@'localhost';
FLUSH PRIVILEGES;

B-3. 웹서버 설정 (nginx)

Zittme는 nginx 설정 도우미를 제공합니다.

설치 마법사의 환경 확인 화면: 서버 환경을 감지해 맞춤 설정과 적용 명령을 만들어 줍니다.
배포본의 common/scripts/setup-nginx.sh: 한 번에 적용하는 스크립트입니다.
설정 예시: common/manual/server_config/zittme-nginx.conf

Apache라면 배포본의 .htaccess 가 처리하므로 mod_rewrite 만 켜져 있으면 됩니다.

---

설치 마법사 (공통)

브라우저로 사이트 주소에 접속하면 설치 마법사가 시작됩니다. 화면 위 단계 표시를 따라 진행합니다.

환경 확인: 서버가 요구 사항을 충족하는지 자동 점검합니다. 문제가 있으면 항목별로 안내가 나옵니다.
라이선스 동의: Zittme는 GPL v2 자유 소프트웨어입니다.
DB 정보 입력: 웹 호스팅은 A-1에서 확인한 값을, 개인 서버는 B-2에서 만든 값을 넣습니다.
관리자 계정 생성: 사이트 최고관리자의 이메일·비밀번호를 정합니다.

설치가 끝나면 기본 메뉴(홈·게시판)와 함께 사이트가 열리고, 기본 에디터는 zittEditor로 설정됩니다.

설치 직후 확인할 것

관리자 접속: 사이트주소/admin
시스템 설정 > 기본 설정: 사이트 제목·기본 언어·시간대
관리자 화면 설정: 관리 메뉴 위치(상단·좌측·우측), 관리자 로고 등록
파일 업로드 확인: 게시판에 글을 하나 쓰고 이미지를 첨부해 봅니다. 실패하면 files/ 폴더의 쓰기 권한을 확인하세요. 웹 호스팅은 파일관리자에서 권한을 707 또는 755로 조정할 수 있습니다.

업데이트

관리자 대시보드에 새 버전 안내가 뜨면 릴리즈 페이지에서 새 배포본을 받아 덮어씁니다. 덮어쓴 뒤 관리자에 접속하면 필요한 DB 변경이 자동으로 적용됩니다. 업데이트 전에는 항상 files/ 와 DB를 백업하세요.