피드 가져오기 (MRSS, RSS, CSV, JSON)
외부 피드를 연결하여 예약된 일정에 따라 새 동영상을 자동으로 가져옵니다.
피드 가져오기(흔히 그래버(grabbers)라고도 함)는 라이브러리를 자동으로 계속 성장시킵니다. 원격 피드를 한 번 구독하면 TubePress가 일정에 따라 이를 확인하고 새 동영상을 가져오며 이미 확인한 항목은 건너뜁니다.
가져오기 화면의 탭에 있습니다 — /admin/import를 열고 피드(Feeds)로 전환하세요(/admin/feeds URL이 해당 위치로 리디렉션됩니다). 일회성 파일 업로드와 달리 피드는 소스가 더 많이 게시함에 따라 사이트를 계속 보충합니다.
피드 가져오기의 기능
각 소스는 피드 URL과 몇 가지 설정으로 구성됩니다. 일정에 따라 TubePress가 피드를 가져오고 모든 항목을 정규화하여 새 항목을 대기열에 추가하며, 두 번째 단계에서 대기 중인 항목이 동영상으로 전환됩니다. 미디어 저장 방법을 선택할 수 있습니다:
- 임베드(Embed) — 플레이어 링크를 저장합니다. 빠르고 저장 공간을 사용하지 않으며 동영상은 소스에서 스트리밍됩니다.
- 다운로드(Download) — 실제 파일을 스토리지 또는 CDN으로 가져와서 렌디션으로 트랜스코딩합니다.
소스별로 동영상 유형(스트레이트, 게이 또는 헨타이)과 새 동영상을 자동 게시할지 검토를 위한 초안으로 보류할지 여부도 설정합니다.
지원되는 피드 형식
네 가지 형식이 지원되며, 감지 및 미리보기(Detect & Preview) 버튼으로 자동 감지됩니다:
| 형식 | 매핑 | 비고 |
|---|---|---|
| MRSS | 자동 | Media RSS — 가장 풍부한 옵션으로, 필드가 자동으로 매핑됩니다. |
| RSS | 자동 | 표준 RSS 항목. |
| CSV | 수동 | URL에서 제공되는 CSV로, 열을 직접 매핑합니다. |
| JSON | 수동 | URL에서 제공되는 JSON 배열로, 키를 직접 매핑합니다. |
피드 소스 추가
- 피드 탭을 엽니다.
/admin/import로 이동하여 피드(Feeds)를 선택한 다음 피드 소스 추가(Add Feed Source)를 클릭합니다. - 피드 URL을 입력합니다.
http://또는https://로 시작해야 합니다. 감지 및 미리보기(Detect & Preview)를 클릭하여 형식을 자동 감지하고 첫 번째 항목을 미리 봅니다. - 이름을 지정하고 유형을 확인합니다. 소스에 이름을 부여하고 감지된 형식(MRSS, RSS, CSV 또는 JSON)과 동영상 유형을 확인합니다.
- 모드를 선택합니다. 플레이어 링크를 저장하려면 임베드(Embed)를, 파일을 가져와 트랜스코딩하려면 다운로드(Download)를 선택합니다.
- 필요한 경우 열을 매핑합니다. MRSS와 RSS는 자동으로 매핑됩니다. CSV/JSON의 경우 각 열을 해당 필드로 드래그합니다.
- 일정과 옵션을 설정합니다. 새로 고침 간격, 중복 규칙, 자동 게시 여부, 크롤링할 페이지 수를 선택합니다.
- 저장합니다. 지금 가져오기(Fetch now)를 사용하여 즉시 가져오거나 일정이 실행되도록 두세요. 대기열 실행(Run queue)은 보류 중인 항목을 즉시 처리합니다.
필드 매핑
피드는 항목을 가져오기 도구가 사용하는 동일한 표준 필드로 정규화합니다. MRSS/RSS의 경우 이 과정이 자동으로 이루어지며, CSV/JSON의 경우 열을 다음에 매핑합니다:
embed_url을 매핑하지 않은 경우 video_url 하나가 임베드 링크로도 사용되므로 최소 피드에는 제목과 URL 하나만 있으면 됩니다.일정 & 자동화
feed_import라는 백그라운드 작업이 의사-cron에서 약 30초마다 실행됩니다 — 시스템 crontab이 필요 없습니다. 각 소스는 자체 간격이 경과한 경우에만 가져옵니다:
- 수동 전용 — 자동 가져오기 안 됨; 지금 가져오기(Fetch now)를 사용하세요.
- 15분마다, 매시간, 6시간마다 또는 매일.
동일한 작업이 가져오기 대기열도 비웁니다 — 임베드 항목은 여러 개씩, 다운로드는 한 번에 하나씩 처리되므로 큰 파일이 나머지를 차단하지 않습니다. 최대 페이지(Max pages) 설정(1–50)은 단일 가져오기가 페이지가 나뉜 피드를 얼마나 깊이 크롤링할지 제한합니다.
중복 제거 & 필터
중복 제거는 자동으로 작동하며 두 수준에서 이루어집니다:
- 소스별. 각 항목의
guid가 기억되므로 재가져오기 시 진정으로 새 항목만 대기열에 추가됩니다(이미 확인한 항목은 카운트되고 건너뜁니다). - 사이트 전체. 다운로드 모드에서 항목의 ID가 동영상에 저장되므로 두 피드에서 동일한 클립이 도착해도 두 번 다운로드되지 않습니다.
중복 시(On duplicate) 옵션은 항목이 이미 존재할 때 수행할 작업을 결정합니다: 건너뛰기(Skip)(권장) 또는 기존 항목 업데이트(Update existing).
피드 문제 해결
- "피드 형식을 인식할 수 없습니다." URL이 유효한 MRSS/RSS/CSV/JSON을 반환하지 않았습니다. 브라우저에서 열어 HTML 페이지가 아닌 원시 피드가 표시되는지 확인하세요.
- 항목이 "가져오는 중"에 멈춤. 약 30분 후 자동으로 복구되어 재시도됩니다. 일시적인 실패는 실패로 표시되기 전에 최대 세 번 재시도됩니다.
- 실패한 항목. 소스에 대해 실패한 모든 항목을 다시 대기열에 넣으려면 재처리(Reprocess)를 사용하세요. 각 소스는 마지막 상태와 메시지를 표시합니다.
- 다운로드 모드 실패. 다운로드에는 직접 동영상 URL(시청 페이지 아님)이 필요합니다. 비공개 또는 내부 호스트는 차단되며 파일당 5 GB 한도가 있습니다.
- 아무것도 가져오지 않음. 일정이 수동 전용(Manual only)이 아닌지, 소스가 활성화되어 있는지, cron을 구동하기 위한 트래픽이 사이트에 들어오고 있는지 확인하세요.