Ryoti majutamine Managed VPS-is: meedia ja treeningute jälgija teie serveris

Ryoti majutamine Managed VPS-is tähendab, et selle ajalugu, mida vaatate, loete, mängite ja tõstate, jääb serverisse, mis on teie enda ning mida meie meeskonnad hoiavad ajakohasena ja jälgivad päeval ja öösel. Ryot on GPL-3.0 litsentsiga vaba ja avatud lähtekoodiga jälgija filmide, sarjade, raamatute, mängude, taskuhäälingute, muusika ja treeningute jaoks. See juhend järgib selle ametlikku Dockeri tõmmist versioonis v10.5.8 ning käivitasime enne kirjutamist iga käsu Simafri VPS-is: paigaldus Docker Compose’i ja PostgreSQL-iga, HTTPS, esimene konto, iga meediatüübi API võtmed, varukoopiad ja uuendused.

Simon Vasconcelos Lee Autor: Avaldatud 19. novembril 2026Lugemisaeg: 11 minutit

Kõik juhendid

Lühidalt

  1. GPL-3.0 litsents lubab Ryoti käitada enda, oma pere või klubi jaoks, ilma et peaksite litsentsi ostma; tasuline võti Ryot Pro lisab sama tõmmise peale funktsioone.
  2. Paigaldage see Docker Compose’iga: tõmmis ignisda/ryot ja PostgreSQL 18, port 8000 avaldatud aadressil 127.0.0.1 HTTPS-i pöördproksi taga.
  3. Pange andmebaasi parool ja SERVER_ADMIN_ACCESS_TOKEN faili .env ning määrake muutujas FRONTEND_URL oma avalik aadress.
  4. Esimesena loodud kontost saab administraator; seejärel määrake USERS_ALLOW_REGISTRATION=false, et privaatses instantsis registreerumine sulgeda.
  5. Raamatud toimivad kohe; filmid ja sarjad vajavad TMDB luba, videomängud Twitchi rakendust. Varundage tööriistaga pg_dump ja uuendage, muutes tõmmise silti.

Mida Ryot teeb

Ryot, nimest «Roll Your Own Tracker» ja hääldusega «riot», hoiab ühes kohas seda, mida olete vaadanud, lugenud, mänginud ja treeninud, koos statistika, tulevaste väljaannete kalendri ja teie enda kogudega. Selle arendaja IgnisDa kirjutab seda Rustis ning selle veebiliidese saab telefoni rakendusena paigaldada.

Mida GPL-3.0 litsents lubab

Ryot avaldatakse GNU General Public License’i versiooni 3 (GPL-3.0) all. Võite seda tasuta kasutada enda, oma pere, klubi või ettevõtte jaoks, seda kopeerida ja muuta. Kui levitate muudetud versiooni, levitate selle lähtekoodi sama litsentsi all. Tarkvara pakutakse ilma garantiita.

Ryot Pro on arendaja müüdav tasuline võti, mis avab lisafunktsioone, näiteks profiili jagamise ja isikupärastatud soovitused. See pannakse sama tõmmise muutujasse SERVER_PRO_KEY ja server naaseb kogukonnaversiooni juurde, kui võti aegub. Selles juhendis pole seda kusagil vaja.

Arvestatavad ressursid

Dokumentatsioon ei sea minimaalset suurust ja Ryot on kerge. Siin on see, mida mõõtsime oma värskelt paigaldatud test-VPS-is:

Serveri suurus sõltub seega kasutajate arvust ja muudest rakendustest, mida Ryoti kõrval käitate. Managed VPS-i puhul kirjeldage meile oma kasutust ja me soovitame teile sobiva suuruse.

Paigaldus Docker Compose’iga

Ryot tarnitakse ühe tõmmisena, ignisda/ryot, mis on avaldatud ka nimega ghcr.io/ignisda/ryot ja serveerib pordil 8000 nii liidest kui ka API-t. See vajab PostgreSQL 15 või uuemat, mis töötab selle kõrval oma konteineris. Serveris, kuhu on Dockeri Ubuntu hoidlast paigaldatud Docker Engine ja selle Compose’i plugin, looge kaust, näiteks /opt/ryot, ja pange sinna see compose.yaml, mis põhineb paigalduslehe failil:

compose.yaml
services:
  ryot-db:
    image: postgres:18-alpine
    restart: unless-stopped
    environment:
      - TZ=Europe/Amsterdam
      - POSTGRES_DB=ryot
      - POSTGRES_USER=ryot
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD:?set POSTGRES_PASSWORD in .env}
    volumes:
      - postgres_storage:/var/lib/postgresql
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ryot -d ryot"]
      interval: 5s
      timeout: 5s
      retries: 10

  ryot:
    image: ignisda/ryot:v10.5.8
    restart: unless-stopped
    ports:
      - "127.0.0.1:8000:8000"
    environment:
      - TZ=Europe/Amsterdam
      - FRONTEND_URL=https://ryot.example.com
      - DATABASE_URL=postgres://ryot:${POSTGRES_PASSWORD}@ryot-db:5432/ryot
      - SERVER_ADMIN_ACCESS_TOKEN=${SERVER_ADMIN_ACCESS_TOKEN:?set SERVER_ADMIN_ACCESS_TOKEN in .env}
    depends_on:
      ryot-db:
        condition: service_healthy

volumes:
  postgres_storage:

Kaks saladust lähevad selle kõrvale faili .env, mille Docker Compose loeb iseenesest. Looge see loetavaks ainult rootile ja käivitage seejärel komplekt:

Terminal, kaustas /opt/ryot
umask 077
printf 'POSTGRES_PASSWORD=%s\nSERVER_ADMIN_ACCESS_TOKEN=%s\n' "$(openssl rand -hex 24)" "$(openssl rand -hex 32)" > .env
umask 022
docker compose up -d
docker compose ps

Esimene käivitamine käitab andmebaasi migratsioonid ja laadib alla harjutuste kataloogi; meie test-VPS-is vastas Ryot mõne sekundiga. Et kontrollida, kas see vastab:

Terminal
curl -s -o /dev/null -w "%{http_code}\n" http://127.0.0.1:8000/health
curl -s http://127.0.0.1:8000/backend/config | head -c 300

Esimene käsk vastab 200. Teine tagastab serveri laaditud seadistuse JSON-ina, saladused varjatud: mugav viis muutujat kontrollida.

HTTPS: pöördproksi

Konteiner serveerib Ryoti HTTP kaudu pordil 8000. HTTPS-i eest hoolitseb selle ees olev pöördproksi, mis peab edastama avaliku päise Host ja päise X-Forwarded-Proto. Testisime Caddy’t, mis paigaldati selle ametlikust Debiani ja Ubuntu hoidlast: see hangib Let’s Encrypti sertifikaadi ise, uuendab seda ja edastab need päised vaikimisi.

/etc/caddy/Caddyfile
ryot.example.com {
	reverse_proxy 127.0.0.1:8000
}
Terminal
sudo systemctl reload caddy

Esimene konto, registreerumine ja kutsed

Ryotil pole vaikekontot ja uues instantsis on registreerumine avatud. Esimene loodud konto saab rolli Admin; järgmised on tavakasutajad. Looge oma konto kohe pärast esimest käivitamist:

  1. Avage oma aadress: Ryot näitab oma sisselogimislehte.
  2. Klõpsake «Create a new account?» ning sisestage kasutajanimi ja kaks korda parool.
  3. Registreeruge ja logige seejärel uute andmetega sisse: jõuate juhtpaneelile, kus ootab tutvustusring.
  4. Jaotises «Settings», «Users» on teie konto rolliga Admin.

Privaatse instantsi puhul sulgege registreerumine: lisage USERS_ALLOW_REGISTRATION=false teenuse ryot keskkonda ja käivitage seejärel docker compose up -d. Meie test-VPS-is kadus link «Create a new account?» ja server lükkas registreerumisaadressilt proovitud registreerumise tagasi teatega «Registration is disabled».

Teiste kasutajate kutsumine

  1. Klõpsake jaotises «Settings», «Users» pealkirja kõrval olevat nuppu +.
  2. Sisestage inimese kasutajanimi: Ryot loob konto ja näitab ühekordset linki.
  3. Saatke link: inimene avab selle, valib parooli ja logib seejärel sisse.

Testisime seda suletud registreerumisega: kutsutud konto loodi tavakasutajana, selle parool määrati lingi kaudu ja see jõudis oma juhtpaneelile.

Kui soovite selle asemel sisse logida oma ettevõtte kontodega, toetab Ryot OpenID Connecti: määrake SERVER_OIDC_CLIENT_ID, SERVER_OIDC_CLIENT_SECRET ja SERVER_OIDC_ISSUER_URL ning deklareerige oma teenusepakkuja juures ümbersuunamisaadressiks https://ryot.example.com/api/auth.

Filmid, sarjad ja mängud: API võtmed

Ryot leiab iga meediatüübi andmed ja kaanepildid pakkujalt. Mõned toimivad ilma võtmeta, teised vajavad teie oma, sest jagatud võtmed eemaldati versioonis v9:

MeediaPakkujaMida määrata
RaamatudOpen LibraryMitte midagi: toimib kohe. Google Books ja Hardcover on valikulised, oma API võtmega
Filmid ja sarjadTMDB või TVDBMOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN, tasuta TMDB konto API Read Access Token, või MOVIES_AND_SHOWS_TVDB_API_KEY
VideomängudIGDB, Twitchi kauduVIDEO_GAMES_TWITCH_CLIENT_ID ja VIDEO_GAMES_TWITCH_CLIENT_SECRET, Twitchi arendajakonsooli rakendusest
MuusikaSpotify, valikulineMUSIC_SPOTIFY_CLIENT_ID ja MUSIC_SPOTIFY_CLIENT_SECRET
Anime importMyAnimeListANIME_AND_MANGA_MAL_CLIENT_ID, vajalik ainult MyAnimeListist importimiseks

Need võtmed on saladused: pange need faili .env, lisage teenuse ryot keskkonda rida, näiteks - MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN=${MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN}, ja käivitage seejärel docker compose up -d. Dokumentatsiooni seadistuslehel on loetletud kõik ülejäänud muutujad.

Varukoopiad

Kõik asub kahes kohas: PostgreSQL-i andmebaasis, köites postgres_storage, ja teie failis .env. Hoidke viimast turvaliselt: SERVER_ADMIN_ACCESS_TOKEN on vajalik andmebaasi salvestatud kaheastmelise autentimise saladuste lugemiseks. PostgreSQL-i tõmmis sisaldab tööriista pg_dump. Väljavõte sisaldab kõiki kontosid ja nende ajalugu, seega looge see loetavaks ainult rootile, kasutades sulgudes olevat umask 077: ülejäänud seanss säilitab oma tavapärase maski. Juba olemasolev fail säilitab üle kirjutamisel oma õigused, seega sulgeb rida find kõigepealt kaustas juba olevad väljavõtted ja koopiad, enne kui midagi kirjutatakse, ning peatab varundamise, kui see ei õnnestu:

Terminal, kaustas /opt/ryot
(
  umask 077
  find . -maxdepth 1 \( -name 'ryot-*.dump' -o -name 'env-*.bak' \) -exec chmod 600 {} + || exit 1
  docker compose exec -T ryot-db pg_dump -U ryot -Fc ryot > ryot-$(date +%F).dump
  cp .env env-$(date +%F).bak
)

Ajastage see koopia ja saatke see serverist välja. Kettale salvestatuna kuuluvad väljavõtted ka serveri öistesse varukoopiatesse.

Taastamine

Samas või uues paigalduses, sama failiga .env, peatage rakendus, asendage andmebaas tühjaga, laadige väljavõte sinna ja käivitage rakendus seejärel uuesti:

Terminal, kaustas /opt/ryot
docker compose stop ryot &&
docker compose exec -T ryot-db dropdb -U ryot ryot &&
docker compose exec -T ryot-db createdb -U ryot ryot &&
docker compose exec -T ryot-db pg_restore -U ryot -d ryot --exit-on-error --no-owner < ryot-2026-11-20.dump &&
docker compose start ryot

Testisime kogu tsüklit oma VPS-is täpselt nende käskudega: väljavõte, andmebaasi kustutamine ja tühjana uuesti loomine, taastamine. Mõlemad kontod, nende kogud ja 876 harjutust tulid tagasi ning administraator logis kohe uuesti sisse.

Ryot ekspordib ka teie enda andmed JSON-ina sätete lehelt «Imports and Exports» ning suudab need tagasi importida. See eksport vajab S3-ga ühilduvat failisalvestust; ülaltoodud andmebaasi väljavõte toimib ka ilma selleta.

Uuendused

Ryotist ilmub uusi versioone sageli, ligikaudu kord nädalas. Lugege versioonimärkmeid, tehke varukoopia, muutke tõmmise silti failis compose.yaml, seejärel tõmmake uus tõmmis ja looge konteiner uuesti. Andmebaasi migratsioonid käivituvad käivitamisel iseenesest:

Terminal, kaustas /opt/ryot
docker compose pull
docker compose up -d
docker compose logs ryot | grep -i migration

Telemeetria

Ryot kogub anonüümseid kasutusandmeid, lehevaatamisi ja mõningaid sündmusi, oma arendaja ise majutatud Umami instantsi. Selle väljalülitamiseks lisage DISABLE_TELEMETRY=true teenuse ryot keskkonda ja käivitage seejärel docker compose up -d.

Kes mida teeb Managed VPS-is

Ise majutamine nõuab lisaks rakendusele ka serveri hoidmist. Managed VPS-is võtavad meie meeskonnad serveri enda hoole alla ja jälgivad teie instantsi proaktiivselt; Ryot jääb teie tarkvaraks teie ajaloo ja teie sätetega.

TeemaMeie meeskonnadTeie
ServerSüsteemi- ja turvauuendused, sekkumised serverisse kaasa arvatudTeile sobiv hetk
SeireServerit jälgitakse ööpäevaringselt, sekkumisega ilma teie kõnet ootamataTeie ajalugu, kogud ja integratsioonid Ryotis
RyotProaktiivne jälgimine: vead, aeglus, andmebaas ja kettaruum avastatakse, parandus soovitatakseSelle paigaldus, uuendused, API võtmed ja sätted, mille rakendate teie või teie tehisintellekti assistent
KasutajadNeid kandev server, jälgitud ja varundatudKontod, registreerumine ja ühekordne sisselogimine
VarukoopiadIgal ööl, krüpteeritult ja masinast väljaspool hoituna; taastamine sisaldubRyoti enda andmebaasi väljavõtted ja JSON-ekspordid ning taastamistaotlus, kui seda vajate
ÜleviimineTeie praeguse serveri üleviimine, tasutaÜmberlülitamise hetk

Kui eelistate, et meie meeskonnad sekkuksid rakendusse endasse, arveldatakse see teenus tunni- või kindlahinnaga, hinnapakkumine edastatakse enne sekkumist.

Ryot teie eest hoitud serveris

Simafri Managed VPS-iga hoiavad meie meeskonnad teie Ryoti instantsi serveri ajakohasena, jälgivad seda päeval ja öösel ning sekkuvad ilma teie kõnet ootamata; nad jälgivad ka teie instantsi proaktiivselt ja soovitavad teile kasulikud parandused, mille rakendate ise või oma tehisintellekti assistendiga. Varukoopiad krüpteeritakse igal ööl ja hoitakse väljaspool masinat, nende taastamine sisaldub hinnas ning teie praeguse serveri üleviimine on tasuta.

Vaadake Managed VPS

Korduma kippuvad küsimused

Kas Ryot on tasuta?

Jah. Ryot on GPL-3.0 litsentsiga: võite seda käitada enda, oma pere või meeskonna jaoks, ilma et peaksite litsentsi ostma. Ryot Pro on valikuline tasuline võti, mis lisab samale tõmmisele funktsioone. Jääb ainult seda käitava serveri hind.

Kuidas paigaldada Ryot Docker Compose’iga?

Kasutage failis compose.yaml tõmmist ignisda/ryot ja PostgreSQL 18. Pange andmebaasi parool ja SERVER_ADMIN_ACCESS_TOKEN faili .env, määrake FRONTEND_URL oma https-aadressiks, avaldage port 8000 aadressil 127.0.0.1, käivitage docker compose up -d ja pange ette HTTPS-i pöördproksi.

Millised on Ryoti vaikimisi sisselogimisandmed?

Neid pole. Klõpsake sisselogimislehel «Create a new account?»: esimesena loodud kontost saab administraator. Seejärel määrake USERS_ALLOW_REGISTRATION=false, et registreerumine sulgeda; administraator kutsub teised kasutajad jaotisest Settings, Users ühekordse lingiga.

Miks Ryot ei leia filme ega sarju?

Alates versioonist v9 vajavad filmid ja sarjad teie enda TMDB luba: looge tasuta TMDB konto, taotlege API võtit ja määrake selle API Read Access Token muutujasse MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN. Videomängud vajavad Twitchi rakendust, raamatud aga toimivad ilma võtmeta.

Kui palju mälu Ryot vajab?

Vähe. Meie test-VPS-is kasutas värske paigaldus umbes 240-300 MB Ryoti ja 70 MB PostgreSQL-i jaoks ning kaks tõmmist võtavad umbes 810 MB kettaruumi.

Kuidas Ryotit varundada?

Tehke PostgreSQL-i andmebaasist väljavõte käsuga docker compose exec -T ryot-db pg_dump -U ryot -Fc ryot sätte umask 077 all, et ainult root saaks seda lugeda, ja hoidke alles koopia oma failist .env. Taastamiseks peatage rakendus, looge andmebaas käskudega dropdb ja createdb tühjana uuesti ning laadige seejärel väljavõte käsuga pg_restore --exit-on-error --no-owner.

Kuidas Ryotit uuendada?

Lugege versioonimärkmeid ja tehke varukoopia, muutke tõmmise silti failis compose.yaml, seejärel käivitage docker compose pull ja docker compose up -d. Andmebaasi migratsioonid käivituvad käivitamisel iseenesest. Peaversioonide vahel järgige migratsioonilehte.

Kas Managed VPS katab Ryoti?

Managed VPS katab serveri: süsteemi, turvalisuse, seire ja varukoopiad. Meie meeskonnad jälgivad ka teie instantsi proaktiivselt ja soovitavad kasulikke parandusi, mille rakendate teie. Sekkumine rakendusse arveldatakse tunni- või kindlahinnaga.

Võtke meiega ühendust