개요
Kliqqi는 Twitter나 Facebook 스타일의 온라인 소셜 미디어 커뮤니티를 빠르게 세팅할 수 있는 소셜 커뮤니티 콘텐츠 관리 시스템(CMS)입니다. 이 가이드는 Ubuntu 서버에 Kliqqi를 설치해 관리자 대시보드와 공개 사이트를 운영하는 전체 흐름을 안내합니다.
중요: 서버에 루트 접근 권한 또는 sudo 권한이 있어야 합니다. PHP, Apache, MySQL이 설치되어 있어야 합니다.
사전 준비
다음 소프트웨어가 설치되어 실행 중인지 확인하세요:
- Apache2
- PHP — 최소 5.4 이상
- MySQL — 최소 5.1 이상
짧은 용어 정의: CMS는 콘텐츠 관리 시스템을 의미합니다. Kliqqi는 PHP와 MySQL 기반입니다.
중요: 운영 환경에서는 PHP와 MySQL의 최신 지원 버전을 사용하는 것이 권장됩니다. 여기서는 최소 요구사항을 기준으로 설치 절차를 설명합니다.
Kliqqi용 데이터베이스 생성
서버에서 MySQL에 접속하여 Kliqqi용 데이터베이스를 만듭니다. 예:
mysql -u root -p
CREATE DATABASE kliqqi;데이터베이스가 생성되면 사용자와 권한을 추가합니다.
GRANT ALL PRIVILEGES ON `kliqqi`.* TO 'kliqquser'@'localhost' IDENTIFIED BY 'your_secure_password';
FLUSH PRIVILEGES;‘your_secure_password’ 부분을 안전한 비밀번호로 바꾸세요.
MySQL 콘솔에서 나갈 때는 다음을 사용합니다:
exitKliqqi 설치 파일 다운로드 및 배치
Kliqqi의 안정 버전은 공식 다운로드 페이지에서 확인할 수 있습니다. 서버에서 wget으로 다운로드하고 압축을 풉니다.
wget -c https://www.kliqqi.com/download/2268/-O Kliqqi1112017.zip
unzip Kliqqi1112017.zip이미지: Kliqqi 다운로드 스크린샷
압축을 푼 디렉터리를 Apache 웹 루트로 이동시키고 소유권을 웹서버 사용자로 설정합니다.
sudo mv Kliqqi1112017 /var/www/kliqqi
sudo chown -R www-data:www-data /var/www/kliqqiNote: 웹 루트 경로는 배포 환경에 따라 /var/www/html 등이 될 수 있습니다. 환경에 맞게 조정하세요.
Apache 가상호스트 설정 — HTTP 전용
새 사이트 구성을 /etc/apache2/sites-available/kliqqi.conf 파일로 생성합니다. 예시 내용:
ServerName kliqqi.exampleserver.xyz
DocumentRoot /var/www/kliqqi
Options -Indexes +FollowSymLinks +MultiViews
AllowOverride All
Require all granted
ErrorLog ${APACHE_LOG_DIR}/kliqqi.exampleserver.xyz-error.log
CustomLog ${APACHE_LOG_DIR}/kliqqi.exampleserver.xyz-access.log combined
이미지: Apache 가상호스트 구성 예시 스크린샷
ServerName은 실제 도메인으로 바꾸세요. 설정 후 사이트 활성화 및 Apache 재시작:
sudo a2ensite kliqqi
sudo service apache2 reload중요: 운영환경에서는 반드시 HTTPS를 구성하세요. 이 문서 뒤쪽 보안 섹션에서 HTTPS 설정 권고를 다룹니다.
설치 마법사 사용
브라우저에서 설치 URL로 이동합니다:
http://kliqqi-도메인/install/install.php
언어 선택 화면이 나타납니다. 설치 과정은 다음 흐름을 따릅니다:
- 언어 선택
- 데이터베이스 설정 입력 (앞에서 만든 DB/사용자 정보)
- 데이터베이스 연결 검사 및 구성파일 업데이트
- 스키마 생성 및 관리자 계정 설정
- 설치 완료 후 대시보드 로그인
이미지: 설치 언어 선택 화면
데이터베이스 정보 입력 화면 예시:
설치 진행 중 스키마 생성과 관리자 계정 입력 화면이 나옵니다.
설치가 끝나면 관리자 대시보드로 로그인합니다.
관리자 패널에서 사이트 설정을 변경하고, 사용자 관리, 그룹 생성, 포스트 관리 등을 할 수 있습니다.
프론트엔드 예시 — 첫 글 작성, 그룹 탐색, 프로필 보기 등 기본 기능을 확인하세요.
운영 시 고려사항 및 보안 강화를 위한 권장 사항
- HTTPS 필수: Let’s Encrypt 같은 CA로 SSL/TLS 인증서를 발급받아 HTTPS를 구성하세요.
- 파일 권한: 업로드 디렉터리와 구성파일 권한을 최소 권한 원칙으로 설정하세요.
- 데이터베이스 계정: 애플리케이션 전용 계정을 사용하고 루트 계정 사용을 피하세요.
- 정기 백업: 정기적인 데이터베이스 및 업로드 파일 백업 정책을 수립하세요.
- 패치 관리: 서버 OS, PHP, Apache, MySQL, Kliqqi 소스의 보안 업데이트를 주기적으로 적용하세요.
보안 하드닝 체크리스트:
- SSH: 루트 직접 로그인 비활성화, 키 기반 인증 사용
- 방화벽: 필요한 포트(80, 443, SSH 등)만 허용
- 모니터링: 로그 감시 및 침입 탐지 시스템 도입
문제 해결 가이드(트러블슈팅)
- 데이터베이스 연결 실패: DB 이름, 사용자, 비밀번호, 호스트 값을 다시 확인하고 MySQL 서비스 상태 확인
- 권한 오류(403): Apache 가상호스트의 DocumentRoot와 Directory 권한, AllowOverride 설정을 확인
- 500 내부 서버 오류: Apache 에러 로그와 PHP 오류 로그 확인
체크 명령 예시:
sudo tail -n 200 /var/log/apache2/error.log
sudo systemctl status mysql역할별 체크리스트
운영자(시스템 관리자):
- 서버 패치 및 보안 설정
- 백업 스케줄 관리
- 로그 및 모니터링 설정
콘텐츠 관리자(커뮤니티 매니저):
- 초기 카테고리 및 그룹 구성
- 이용 약관, 커뮤니티 규칙 설정
- 사용자 신고 처리 프로세스 수립
개발자/테마 편집자:
- 커스텀 테마 테스트 환경 구성
- 코드 변경 시 버전 관리(Git) 사용
- 성능 최적화(캐시, 이미지 최적화)
마이그레이션 및 업그레이드 팁
- 업그레이드 전 전체 백업 수행
- 커스터마이징된 파일 목록을 기록하고, 업그레이드 후 충돌 여부를 확인
- 스테이징 환경에서 먼저 업그레이드 테스트
간단한 운영 방법론(파일럿→확장)
- 파일럿 단계: 제한된 사용자 그룹으로 기본 기능 검증
- 운영 설정: 인증, 규칙, 신고 시스템 정비
- 확장 단계: 사용자 증가에 맞춘 성능 튜닝 및 로드밸런싱 고려
핵심 수치 요약
- 권장 PHP 버전: 가능한 최신 안정화 버전 사용
- 최소 요구사항: PHP ≥ 5.4, MySQL ≥ 5.1
- 백업 주기: 최소 하루 1회 권장(활성 커뮤니티는 더 자주)
1줄 용어집
- CMS: 콘텐츠 관리 시스템
- DocumentRoot: 웹서버에서 공개되는 루트 디렉터리
자주 묻는 질문
Kliqqi를 설치하려면 어떤 권한이 필요합니까?
서버의 sudo 권한(또는 루트 권한)과 웹서버 재시작 권한이 필요합니다. MySQL에 데이터베이스 생성 권한도 필요합니다.
HTTPS 설정은 어떻게 하나요?
Let’s Encrypt로 무료 인증서를 발급받아 Certbot으로 자동 갱신 설정을 권장합니다.
설치 중 데이터베이스 연결 오류가 발생하면?
DB 사용자, 비밀번호, 데이터베이스 이름, 호스트(localhost) 값을 다시 확인하고 MySQL 서비스 실행 여부를 점검하세요.
요약
Kliqqi는 빠르게 소셜 커뮤니티를 세팅할 수 있는 오픈소스 솔루션입니다. 이 문서에서는 Ubuntu에서의 설치 절차, Apache 설정, 설치 마법사 사용법과 운영·보안 체크리스트, 트러블슈팅 팁을 제공했습니다. 설치 전 백업과 테스트 환경에서의 검증을 권장합니다.
중요: 공개 서비스 환경에서는 반드시 HTTPS를 적용하고 정기적인 보안 점검을 수행하세요.
