TubePress 업데이트
원클릭 업데이트, 수동 업데이트, 서명된 릴리스 및 PHP 버전 가드를 다룹니다.
TubePress는 WordPress처럼 업데이트됩니다: 관리자 패널에서 클릭 한 번으로 서명된 릴리스를 가져와 검증하고, 백업하고, 코어를 교체하며 데이터베이스 마이그레이션을 실행합니다. 테마, 플러그인, 미디어 및 설정은 그대로 유지됩니다.
이 페이지에서는 업데이트가 무엇을 변경하는지, 어떻게 적용하는지, 그리고 안전하게 유지하는 방법을 자세히 설명합니다.
업데이트 작동 방식
릴리스는 tubepress.io에서 서명된 패키지로 배포됩니다. TubePress가 파일 하나라도 건드리기 전에 모든 패키지는 두 번 검증됩니다:
- SHA-256 체크섬 — 불일치 시 업데이트가 중단됩니다; 그리고
- Ed25519 서명 — 유효한 서명 없이는 코어 설치를 거부하므로 변조되거나 서명되지 않은 코어 패키지는 즉시 거부됩니다.
업데이트는 고정된 코어만 교체합니다. 구체적으로:
src/, sql/, templates/admin/, templates/install/ 및 config/app.php.themes/, plugins/, public/uploads/의 업로드된 미디어, 데이터베이스 콘텐츠, 그리고 설정(config/database.php 포함).파일을 교체하기 직전에 TubePress는 현재 코어를 storage/backups/에 복사하고 데이터베이스 백업을 수행합니다. 데이터베이스 백업을 생성할 수 없는 경우 데이터 손실 위험을 방지하기 위해 코어 업데이트가 중단됩니다. 파일은 원자적으로 교체되고, sql/의 새 번호 매기기 마이그레이션이 자동으로 실행되며, 결과는 검토하거나 롤백할 수 있는 업데이트 로그에 기록됩니다.
원클릭 업데이트
관리자 → 업데이트(/admin/updates)로 이동하세요(관리자 액세스 필요). 화면에는 현재 버전과 코어, 플러그인 및 테마의 사용 가능한 업데이트가 표시됩니다. 업데이트 확인을 클릭하면 tubepress.io에서 즉시 재조회합니다.
항목을 클릭하여 적용하면 TubePress가 다운로드, 검증, 백업, 교체 및 마이그레이션을 수행하고 결과를 기록합니다. 이후 문제가 발생하면 방금 만든 백업으로 롤백할 수 있습니다.
자동 업데이트
자동으로 관리하고 싶으신가요? auto_update_enabled 설정을 활성화하세요(기본값은 비활성화). 활성화하면 백그라운드 pseudo-cron 작업이 주기적으로 확인하고 하루에 최대 한 번 보류 중인 업데이트를 적용합니다. 안전을 위해 의도적으로 보수적으로 동작합니다:
- 코어 및 무료 플러그인은 자동으로 업데이트됩니다;
- 테마는 항상 수동으로 업데이트하도록 남겨집니다, 따라서 귀하의 커스터마이징이 감시 없이 덮어쓰이는 일은 없습니다; 그리고
- 유료 항목은 건너뜁니다 — 마켓플레이스에서 구매가 필요합니다.
스케줄러는 다른 곳에서도 사용되는 동일한 내장 pseudo-cron입니다 — 유지 관리를 참조하세요.
수동 업데이트
원클릭 업데이터는 서명을 검증하고, 백업을 만들고, 데이터베이스 마이그레이션을 실행하는 유일한 방법이므로 권장 경로입니다. 패널이 tubepress.io에 실제로 접근할 수 없는 경우(방화벽 또는 에어갭 호스트), 직접 업데이트할 수 있습니다:
- 먼저 백업하세요. 전체 파일 및 데이터베이스 백업을 수행하세요 — 백업을 참조하세요.
- 공식 릴리스를 받으세요. 다운로드 페이지 또는 계정에서 서명된 ZIP을 다운로드하세요.
- 코어만 교체하세요. 새 릴리스에서
src/,sql/,templates/admin/,templates/install/및config/app.php를 덮어쓰세요.themes/,plugins/,public/uploads/및config/database.php는 그대로 두세요. - 새 마이그레이션을 적용하세요.
sql/의 새 번호 매기기 파일을 데이터베이스에 적용하세요 — 이는 내장 업데이터가 일반적으로 수행하는 단계입니다.
PHP 버전 가드
TubePress는 애플리케이션이 부팅되기 전에 모든 진입점에서 실행되는 작은 파싱-안전 게이트(config/php-guard.php)를 제공합니다. 이는 의도적으로 구식 PHP 스타일로 작성되어 어떤 버전에서도 파싱되므로, 사이트가 필수 8.2보다 오래된 PHP로 이동되거나 다운그레이드되면 방문자는 원시 치명적 오류 대신 깔끔한 “PHP 업그레이드 필요” 페이지를 보게 됩니다.
이는 업데이트와 관련하여 중요합니다: 새 릴리스는 더 새로운 PHP 문법을 사용할 수 있으므로 업데이트 전후에 호스트가 PHP 8.2 이상(8.4 권장)을 실행하는지 확인하세요. 자세한 내용은 유지 관리에서 확인하세요.
업데이트 전에
업데이트는 안전하고 되돌릴 수 있도록 설계되었지만, 백업은 여전히 안전장치입니다:
- 파일 및 데이터베이스 백업 — 업데이터가 자체 백업을 만들지만 본인의 사본도 보관하세요. 백업을 참조하세요.
- PHP 확인 — 8.2+ (이상적으로는 8.4)를 사용 중인지 확인하세요.
- 커스터마이징 확인 — 테마 및 플러그인 변경 사항은 보존되지만 빠른 목록을 확인하는 것도 나쁘지 않습니다.
- 조용한 시간에 업데이트하세요 — 교체는 거의 즉각적이지만 만일을 위해 트래픽이 낮을 때 선택하세요.