Przejdź do treści
TubePress — bezpłatny, samodzielnie hostowany & aktywnie utrzymywany
Importowanie treści

Import z kanałów (MRSS, RSS, CSV, JSON)

Podłącz zewnętrzne kanały i automatycznie pobieraj nowe filmy według harmonogramu.

Import kanałów (zwany niekiedy grabberami) sprawia, że Twoja biblioteka rośnie sama z siebie. Subskrybujesz zdalny kanał raz, a TubePress sprawdza go według harmonogramu, pobiera nowe filmy i pomija te, które już widział.

Dostępny jest jako zakładka na ekranie importu — otwórz /admin/import i przejdź do Kanały (URL /admin/feeds tam przekierowuje). W odróżnieniu od jednorazowego przesyłania pliku, kanał na bieżąco uzupełnia witrynę, gdy źródło publikuje nowe treści.

Jak działa import kanałów

Każde źródło to adres URL kanału wraz z kilkoma ustawieniami. Zgodnie z harmonogramem TubePress pobiera kanał, normalizuje każdy wpis i kolejkuje nowe; drugi etap przekształca te elementy w kolejce w filmy. Wybierasz sposób przechowywania mediów:

  • Embed — przechowuje link do odtwarzacza. Szybki, nie zajmuje miejsca, a wideo jest strumieniowane ze źródła.
  • Download — pobiera rzeczywisty plik do Twojego storage lub CDN i transkoduje go do wybranych formatów.

Dla każdego źródła ustawiasz również typ wideo (straight, gay lub hentai) oraz to, czy nowe filmy są automatycznie publikowane, czy wstrzymywane jako wersje robocze do przeglądu.

Obsługiwane formaty kanałów

Obsługiwane są cztery formaty, wykrywane automatycznie przez przycisk Wykryj i podgląd:

FormatMapowanieUwagi
MRSSAutomatyczneMedia RSS — najbogatsza opcja; pola mapują się automatycznie.
RSSAutomatyczneStandardowe elementy RSS.
CSVRęcznePlik CSV dostępny pod adresem URL; samodzielnie mapujesz kolumny.
JSONRęczneTablica JSON dostępna pod adresem URL; samodzielnie mapujesz klucze.
Automatyczne a ręczne. MRSS i RSS są rozpoznawane automatycznie. CSV i JSON są formatami ogólnymi, więc mapujesz ich kolumny raz — patrz Mapowanie pól poniżej.

Dodawanie źródła kanału

  1. Otwórz zakładkę Kanały. Przejdź do /admin/import, wybierz Kanały, a następnie Dodaj źródło kanału.
  2. Wprowadź adres URL kanału. Musi zaczynać się od http:// lub https://. Kliknij Wykryj i podgląd, aby automatycznie wykryć format i wyświetlić podgląd pierwszych wpisów.
  3. Nazwij je i potwierdź typ. Nadaj źródłu nazwę i sprawdź wykryty format (MRSS, RSS, CSV lub JSON) oraz typ wideo.
  4. Wybierz tryb. Embed, aby przechowywać linki do odtwarzacza, lub Download, aby pobierać i transkodować pliki.
  5. Mapuj kolumny w razie potrzeby. MRSS i RSS mapują się same; dla CSV/JSON przeciągnij każdą kolumnę na odpowiednie pole.
  6. Ustaw harmonogram i opcje. Wybierz interwał odświeżania, regułę duplikowania, automatyczne publikowanie oraz liczbę stron do przeszukiwania.
  7. Zapisz. Użyj Pobierz teraz, aby pobrać natychmiast, lub pozwól działać harmonogramowi. Uruchom kolejkę przetwarza oczekujące elementy na żądanie.

Mapowanie pól

Kanały normalizują wpisy do tych samych kanonicznych pól, których używa importer. W przypadku MRSS/RSS jest to automatyczne; dla CSV/JSON mapujesz kolumny na:

title
Wymagane. Wpisy bez tytułu są pomijane.
video_url
Bezpośredni plik do pobrania — używany w trybie Download.
embed_url
Adres URL odtwarzacza — używany w trybie Embed.
guid
Unikalny identyfikator używany do deduplikacji.
thumbnail, description, duration, published_at, views
Opcjonalne metadane wideo.
categories, tags, performers, channels
Nazwy rozdzielone przecinkami, tworzone jeśli nie istnieją.
Jeden URL wystarczy. W trybie Embed pojedynczy video_url służy jednocześnie jako link osadzenia, jeśli nie zmapowałeś embed_url, więc minimalny kanał potrzebuje tylko tytułu i jednego adresu URL.

Harmonogram i automatyzacja

Zadanie działające w tle o nazwie feed_import uruchamia się na pseudo-cronie mniej więcej co 30 sekund — nie jest potrzebny systemowy crontab. Każde źródło jest pobierane dopiero po upływie własnego interwału:

  • Tylko ręcznie — nigdy nie pobierane automatycznie; użyj Pobierz teraz.
  • Co 15 minut, co godzinę, co 6 godzin lub codziennie.

To samo zadanie opróżnia również kolejkę importu — przetwarza kilka elementów osadzania naraz, a pobierania — po jednym, aby duży plik nigdy nie blokował reszty. Ustawienie Maks. stron (1–50) ogranicza głębokość przeglądania paginowanego kanału przy jednym pobraniu.

Cron potrzebuje ruchu. Pseudo-cron działa tylko wtedy, gdy strona jest odwiedzana. W przypadku nowej lub bezczynnej witryny załaduj stronę, aby go uruchomić — lub skonfiguruj prawdziwe zadanie cron dla gwarantowanego timingu (patrz cron i CLI).

Deduplikacja i filtry

Deduplikacja jest automatyczna i działa na dwóch poziomach:

  • Na poziomie źródła. guid każdego elementu jest zapamiętywany, więc ponowne pobieranie kolejkuje tylko naprawdę nowe wpisy (już widziane elementy są liczone i pomijane).
  • W całej witrynie. W trybie Download identyfikator elementu jest przechowywany przy wideo, więc ten sam klip przychodzący z dwóch kanałów nie jest pobierany dwukrotnie.

Opcja Przy duplikacie decyduje o tym, co się stanie, gdy element już istnieje: Pomiń (zalecane) lub Aktualizuj istniejący.

Brak filtra słów kluczowych. Kanały nie mają filtra słów kluczowych do włączania/wykluczania — ogranicz zakres kanału, wskazując go na URL specyficzny dla kategorii lub tagu w źródle, i użyj Maks. stron, aby ograniczyć głębokość. Wyczyszczenie elementów źródła resetuje jego pamięć deduplikacji, ale nigdy nie usuwa filmów, które już zaimportowałeś.

Rozwiązywanie problemów z kanałami

  • „Nie można rozpoznać formatu kanału." Adres URL nie zwrócił prawidłowego formatu MRSS/RSS/CSV/JSON. Otwórz go w przeglądarce i sprawdź, czy widzisz surowy kanał, a nie stronę HTML.
  • Elementy utknęły w stanie „importowania". Odzyskują się same po około 30 minutach i są ponawiane; przejściowe błędy są ponawiane do trzech razy przed oznaczeniem jako nieudane.
  • Nieudane elementy. Użyj Przetworz ponownie, aby ponownie kolejkować wszystkie nieudane elementy dla danego źródła. Każde źródło pokazuje swój ostatni status i komunikat.
  • Tryb Download zawodzi. Download wymaga bezpośredniego adresu URL wideo (nie strony odtwarzacza); prywatne lub wewnętrzne hosty są zablokowane, a limit wynosi 5 GB na plik.
  • Nic się nie importuje. Sprawdź, czy harmonogram nie jest ustawiony na Tylko ręcznie, czy źródło jest włączone i czy Twoja witryna otrzymuje ruch do napędzania cron.

Następne kroki

Nadal masz problem?

Otwórz zgłoszenie z poziomu panelu, a nasz zespół Ci pomoże.

Wypróbuj demo na żywo → Pobierz TubePress →