설치

TubePress는 일반적인 PHP 애플리케이션처럼 설치됩니다. 파일을 업로드하고, 브라우저에서 도메인에 접속한 다음, 간단한 웹 마법사를 따라가기만 하면 됩니다. 명령줄도, 빌드 단계도 필요 없습니다.

약 5분이면 충분합니다. 시작하기 전에 서버가 요구 사항을 충족하는지 확인하고 데이터베이스 정보를 준비해 두세요.

TubePress 다운로드

다운로드 페이지에서 최신 버전을 받으세요. 완전한 편집 가능한 PHP 소스가 담긴 하나의 작은 ZIP 파일입니다 — 라이선스 키도, ionCube도 필요 없습니다.

서버에 업로드

ZIP 파일의 압축을 풀고 FTP/SFTP 또는 호스팅 제공업체의 파일 관리자를 통해 서버에 업로드하세요. 반드시 지켜야 할 규칙이 하나 있습니다. 웹 루트는 프로젝트 루트가 아닌 public/ 디렉터리를 가리켜야 합니다. 그 외의 모든 것 — config/, src/, storage/, themes/, plugins/ — 은 문서 루트 한 단계 위에 위치하며 직접 제공되지 않습니다.

웹 설치 프로그램 실행

브라우저에서 도메인에 접속하세요. config/installed.php 마커가 아직 존재하지 않기 때문에 TubePress가 바로 설정 마법사로 이동시킵니다. 설정 마법사는 여섯 단계로 구성됩니다:

1. 환영. 짧은 소개 화면입니다 — 클릭하여 시작하세요.
2. 시스템 검사. PHP 버전, 확장 기능, 쓰기 가능한 폴더를 확인합니다. 필수 검사가 모두 통과되면 자동으로 다음 단계로 넘어갑니다. 실패한 항목이 있으면 각 항목이 수정 방법과 함께 확장됩니다.
3. 데이터베이스. 데이터베이스 호스트, 이름, 사용자, 비밀번호를 입력하세요. TubePress가 연결하고 가능하면 데이터베이스를 생성하거나(공유 호스팅에서는 기존 데이터베이스 사용), 모든 SQL 마이그레이션을 실행하고 config/database.php를 작성합니다. 호스트 필드는 host:port 또는 소켓 경로도 허용합니다.
4. 관리자. 관리자 계정을 생성하세요 — 사용자 이름(3–50자), 유효한 이메일, 최소 8자 이상의 비밀번호가 필요합니다.
5. 설정. 사이트 이름을 지정하세요(설명은 선택 사항입니다). 사이트 URL은 자동 감지되며 페이지당 동영상 수는 기본값이 24입니다 — 나중에 모두 수정할 수 있습니다.
6. 완료. TubePress가 기본 페이지, 설정, SEO 기본값을 생성하고 설치 마커를 작성한 다음 새 관리자 패널 링크를 제공합니다.

파일 권한

웹 서버 사용자(주로 www-data)는 세 위치를 소유하고 쓸 수 있어야 합니다: config/(설정 저장용), storage/(로그, 임시 파일, 백업용), public/uploads/(미디어용). 시스템 검사에서 쓰기가 불가능한 항목을 표시합니다.

# Give the web-server user ownership
chown -R www-data:www-data config storage public/uploads

# Directories 755, files 644
find config storage public/uploads -type d -exec chmod 755 {} \;
find config storage public/uploads -type f -exec chmod 644 {} \;

서버에서 쓰기 가능해야 하는 경로는 이 세 가지뿐입니다. 나머지 트리는 읽기 전용으로 유지할 수 있습니다.

Apache와 Nginx

둘 다 완전히 지원되며 설치 중에 자동으로 감지됩니다.

• Apache — AllowOverride All로 설정하여 제공된 .htaccess 파일이 깔끔한 URL을 처리하고 민감한 폴더에 대한 접근을 차단할 수 있도록 하세요. 설치가 완료되면 TubePress가 public/themes와 public/templates 심볼릭 링크를 생성하여 테마 에셋을 올바르게 해석합니다.
• Nginx — 표준 try_files … /index.php?$query_string 규칙을 추가하고, /themes/와 /templates/를 프로젝트 폴더로 별칭을 설정하고, config/, src/, storage/ 경로를 deny하세요. 전체 코드 조각은 요구 사항에 있습니다.

로컬 개발 (localhost)

TubePress는 특별한 설정 없이 일반 HTTP localhost 환경에서 실행됩니다 — 설치 프로그램, 세션, 로그인 모두 HTTPS 없이 작동합니다. 두 가지 간단한 옵션이 있습니다:

• 로컬 웹 서버 (프로덕션과 가장 유사) — 위와 동일하게 Apache 또는 Nginx가 public/ 폴더를 가리키도록 설정하세요.
• PHP 내장 서버 (설정 불필요) — 프로젝트 루트에서 아래 명령어를 실행한 다음 http://localhost:8000을 여세요.

php -S localhost:8000 -t public public/router.php

번들로 제공되는 router.php가 깔끔한 URL을 제공하며, 프론트 컨트롤러가 테마와 관리자 에셋을 직접 제공합니다 — 에셋 별칭을 구성하지 않아도 스타일링이 즉시 작동합니다.

설치 후

방금 생성한 계정으로 /admin에 로그인하고 사이트를 설정하기 시작하세요. 첫 번째 단계 가이드에서 사이트 정체성, 브랜딩, 첫 번째 동영상, 출시 체크리스트를 안내합니다. 관리자 로그인을 조기에 강화하는 것도 중요합니다 — 보안을 참조하세요.

다음 단계