Gostovanje Ryot na Managed VPS: sledenje medijem in vadbi na vašem strežniku

Gostovanje Ryot na Managed VPS pomeni, da zgodovina tega, kar gledate, berete, igrate in dvigujete, ostane na lastnem strežniku, ki ga naše ekipe posodabljajo in podnevi in ponoči spremljajo. Ryot je prosto, odprtokodno orodje za sledenje pod licenco GPL-3.0, za filme, serije, knjige, igre, podkaste, glasbo in vadbe. Ta vodnik sledi njegovi uradni sliki Docker v različici v10.5.8, vsak ukaz pa smo pred pisanjem zagnali na VPS Simafri: namestitev z Docker Compose in PostgreSQL, HTTPS, prvi račun, ključi API za vsako vrsto medijev, varnostne kopije in posodobitve.

Simon Vasconcelos Lee Avtor: Objavljeno 19. novembra 2026Čas branja: 11 minut

Vsi vodniki

Na kratko

  1. Licenca GPL-3.0 vam dovoljuje, da Ryot poganjate zase, za svojo družino ali svoj klub, ne da bi kupili licenco; Ryot Pro, plačljiv ključ, isti sliki doda funkcije.
  2. Namestite ga z Docker Compose: slika ignisda/ryot in PostgreSQL 18, z vrati 8000, objavljenimi na 127.0.0.1 za obratnim posredniškim strežnikom s HTTPS.
  3. Geslo zbirke podatkov in SERVER_ADMIN_ACCESS_TOKEN postavite v datoteko .env, FRONTEND_URL pa nastavite na svoj javni naslov.
  4. Prvi račun, ki ga ustvarite, postane skrbnik; nato nastavite USERS_ALLOW_REGISTRATION=false, da na zasebni instanci zaprete registracije.
  5. Knjige delujejo takoj; filmi in serije potrebujejo žeton TMDB, videoigre aplikacijo na Twitchu. Varnostno kopirajte s pg_dump, posodabljajte pa tako, da spremenite oznako slike.

Kaj počne Ryot

Ryot, okrajšava za „Roll Your Own Tracker“, ki se izgovarja „riot“, na enem mestu hrani, kaj ste gledali, brali, igrali in trenirali, s statistiko, koledarjem prihajajočega in lastnimi zbirkami. Njegov razvijalec, IgnisDa, ga piše v Rustu, s spletnim vmesnikom, ki ga lahko na telefon namestite kot aplikacijo.

Kaj dovoljuje licenca GPL-3.0

Ryot je objavljen pod licenco GNU General Public License, različica 3 (GPL-3.0). Brezplačno ga lahko uporabljate, zase, za svojo družino, svoj klub ali svoje podjetje, ga kopirate in spreminjate. Če razširjate spremenjeno različico, pod isto licenco razširjate tudi njeno izvorno kodo. Programska oprema je na voljo brez jamstva.

Ryot Pro je plačljiv ključ, ki ga prodaja razvijalec in ki odklene dodatne funkcije, kot sta deljenje profila in prilagojena priporočila. Vpiše se v spremenljivko SERVER_PRO_KEY iste slike, strežnik pa se vrne na skupnostno različico, če ključ poteče. Nič v tem vodniku ga ne potrebuje.

Viri, ki jih je treba predvideti

Dokumentacija ne določa najmanjše velikosti, Ryot pa je lahek. To smo izmerili na našem testnem VPS, sveže nameščenem:

Velikost strežnika je torej odvisna od števila uporabnikov in od drugih aplikacij, ki jih poganjate ob Ryotu. Na Managed VPS nam opišite, kako ga uporabljate, in priporočili vam bomo ustrezno velikost.

Namestitev z Docker Compose

Ryot je na voljo kot ena sama slika, ignisda/ryot, objavljena tudi kot ghcr.io/ignisda/ryot, ki na vratih 8000 streže tako vmesnik kot API. Potrebuje PostgreSQL 15 ali novejšega, ki teče ob njem v lastnem vsebniku. Na strežniku z Docker Engine in njegovim vtičnikom Compose, nameščenima iz Dockerjevega repozitorija za Ubuntu, ustvarite mapo, kot je /opt/ryot, in vanjo postavite ta compose.yaml, pripravljen na podlagi datoteke s strani o namestitvi:

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:

Skrivnosti gresta v datoteko .env poleg nje, ki jo Docker Compose prebere sam. Ustvarite jo tako, da jo lahko bere samo root, nato zaženite sklad:

Terminal, v mapi /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

Prvi zagon izvede migracije zbirke podatkov in prenese katalog vaj; na našem testnem VPS se je Ryot odzval v nekaj sekundah. Da preverite, ali se odziva:

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

Prvi ukaz odgovori z 200. Drugi vrne nastavitve, ki jih je strežnik naložil, v obliki JSON, s prikritimi skrivnostmi: priročen način za preverjanje spremenljivke.

HTTPS: obratni posredniški strežnik

Vsebnik Ryot streže prek HTTP, na vratih 8000. Za HTTPS poskrbi obratni posredniški strežnik pred njim, ki mora posredovati javno glavo Host in X-Forwarded-Proto. Preizkusili smo Caddy, nameščen iz njegovega uradnega repozitorija za Debian in Ubuntu: sam pridobi potrdilo Let’s Encrypt, ga podaljšuje in te glave privzeto posreduje.

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

Prvi račun, registracije in povabila

Ryot nima privzetega računa, registracije pa so na novi instanci odprte. Prvi račun, ki je ustvarjen, dobi vlogo Admin; naslednji so navadni uporabniki. Svoj račun ustvarite takoj po prvem zagonu:

  1. Odprite svoj naslov: Ryot prikaže svojo stran za prijavo.
  2. Kliknite „Create a new account?“, nato vnesite uporabniško ime in dvakrat geslo.
  3. Registrirajte se, nato se prijavite z novimi poverilnicami: znajdete se na nadzorni plošči, z uvodnim ogledom.
  4. Pod „Settings“, „Users“ je vaš račun prikazan z vlogo Admin.

Za zasebno instanco zaprite registracije: dodajte USERS_ALLOW_REGISTRATION=false v okolje storitve ryot, nato zaženite docker compose up -d. Na našem testnem VPS je povezava „Create a new account?“ izginila, poskus registracije z naslova za registracijo pa je strežnik zavrnil s sporočilom „Registration is disabled“.

Povabilo drugih uporabnikov

  1. Pod „Settings“, „Users“ kliknite gumb + poleg naslova.
  2. Vnesite uporabniško ime osebe: Ryot ustvari račun in prikaže povezavo za enkratno uporabo.
  3. Pošljite povezavo: oseba jo odpre, izbere geslo, nato se prijavi.

Preizkusili smo to z zaprtimi registracijami: povabljeni račun je bil ustvarjen kot navaden uporabnik, njegovo geslo je bilo nastavljeno prek povezave in prišel je do svoje nadzorne plošče.

Če se želite namesto tega prijavljati z računi svojega podjetja, Ryot podpira OpenID Connect: nastavite SERVER_OIDC_CLIENT_ID, SERVER_OIDC_CLIENT_SECRET in SERVER_OIDC_ISSUER_URL ter pri svojem ponudniku prijavite https://ryot.example.com/api/auth kot naslov za preusmeritev.

Filmi, serije in igre: ključi API

Ryot podatke in naslovnice za vsako vrsto medijev poišče pri ponudniku. Nekateri delujejo brez ključa, drugi potrebujejo vašega, saj so bili skupni ključi v v9 odstranjeni:

MedijiPonudnikKaj nastaviti
KnjigeOpen LibraryNič: deluje takoj. Google Books in Hardcover sta neobvezna, z njunim ključem API
Filmi in serijeTMDB ali TVDBMOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN, API Read Access Token brezplačnega računa TMDB, ali MOVIES_AND_SHOWS_TVDB_API_KEY
VideoigreIGDB, prek TwitchaVIDEO_GAMES_TWITCH_CLIENT_ID in VIDEO_GAMES_TWITCH_CLIENT_SECRET, iz aplikacije v razvijalski konzoli Twitch
GlasbaSpotify, neobveznoMUSIC_SPOTIFY_CLIENT_ID in MUSIC_SPOTIFY_CLIENT_SECRET
Uvoz animejevMyAnimeListANIME_AND_MANGA_MAL_CLIENT_ID, potreben le za uvoz iz MyAnimeList

Ti ključi so skrivnosti: postavite jih v datoteko .env, v okolje storitve ryot dodajte vrstico, kot je - MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN=${MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN}, nato zaženite docker compose up -d. Stran dokumentacije o nastavitvah navaja vse druge spremenljivke.

Varnostne kopije

Vse je na dveh mestih: v zbirki podatkov PostgreSQL, v nosilcu postgres_storage, in v vaši datoteki .env. Slednjo hranite na varnem: SERVER_ADMIN_ACCESS_TOKEN je potreben za branje dvostopenjskih skrivnosti, shranjenih v zbirki podatkov. Slika PostgreSQL vsebuje pg_dump. Izpis vsebuje vse račune in njihovo zgodovino, zato ga ustvarite tako, da ga lahko bere samo root, z umask 077 v oklepajih: preostanek vaše seje obdrži običajno masko. Datoteka, ki že obstaja, ob prepisu obdrži svoja dovoljenja, zato vrstica find najprej zapre izpise in kopije, ki so že v mapi, preden se kar koli zapiše, in ustavi varnostno kopiranje, če ji to ne uspe:

Terminal, v mapi /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
)

To kopijo načrtujte in jo pošiljajte zunaj strežnika. Shranjeni na disku izpisi vstopijo tudi v nočne varnostne kopije strežnika.

Obnova

Na isti ali novi namestitvi, z isto datoteko .env, ustavite aplikacijo, zbirko podatkov zamenjajte s prazno, vanjo naložite izpis, nato aplikacijo znova zaženite:

Terminal, v mapi /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

Celoten cikel smo na svojem VPS preizkusili prav s temi ukazi: izpis, zbirka podatkov izbrisana in znova ustvarjena prazna, obnova. Oba računa, njune zbirke in 876 vaj so se vrnili, skrbnik pa se je takoj znova prijavil.

Ryot vaše lastne podatke izvozi tudi v JSON, s strani nastavitev „Imports and Exports“, in jih lahko znova uvozi. Ta izvoz potrebuje shrambo datotek, združljivo s S3; zgornji izpis zbirke podatkov deluje tudi brez nje.

Posodobitve

Ryot izhaja pogosto, približno vsak teden. Preberite opombe ob izdaji, naredite varnostno kopijo, spremenite oznako slike v compose.yaml, nato prenesite novo sliko in vsebnik znova ustvarite. Migracije zbirke podatkov se ob zagonu izvedejo same:

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

Telemetrija

Ryot zbira anonimne podatke o uporabi, oglede strani in nekaj dogodkov, na instanci Umami, ki jo razvijalec gosti sam. Če jo želite izklopiti, dodajte DISABLE_TELEMETRY=true v okolje storitve ryot, nato zaženite docker compose up -d.

Kdo kaj dela na Managed VPS

Samostojno gostovanje poleg aplikacije zahteva tudi vzdrževanje strežnika. Na Managed VPS naše ekipe prevzamejo strežnik in proaktivno spremljajo vašo instanco; Ryot ostaja vaša programska oprema, z vašo zgodovino in vašimi nastavitvami.

TemaNaše ekipeVi
StrežnikPosodobitve sistema in varnosti, vključno s posegi na strežnikuTrenutek, ki vam ustreza
NadzorStrežnik pod nadzorom 24 ur na dan, 7 dni v tednu, s posegom brez čakanja na vaš klicVaša zgodovina, vaše zbirke in vaše integracije v Ryotu
RyotProaktivno spremljanje: napake, upočasnitve, zbirka podatkov in prostor na disku, s priporočenim popravkomNamestitev, posodobitve, ključi API in nastavitve, ki jih uvedete vi ali vaš AI pomočnik
UporabnikiStrežnik, ki jih nosi, pod nadzorom in varnostno kopiranRačuni, registracije in enotna prijava
Varnostne kopijeVsako noč, šifrirane in shranjene zunaj stroja; obnova je vključenaIzpisi zbirke podatkov in izvozi JSON, značilni za Ryot, in zahteva za obnovo, ko jo potrebujete
SelitevSelitev vašega sedanjega strežnika, brezplačnoTrenutek preklopa

Če želite, da naše ekipe posežejo v samo aplikacijo, se ta storitev zaračuna po urah ali pavšalno, z oceno stroškov, sporočeno pred posegom.

Ryot na strežniku, ki ga vzdržujemo za vas

Z Managed VPS Simafri naše ekipe strežnik vaše instance Ryot sproti posodabljajo, ga podnevi in ponoči nadzirajo ter posežejo brez čakanja na vaš klic; vašo instanco tudi proaktivno spremljajo in vam priporočajo koristne popravke, ki jih uvedete vi ali vaš AI pomočnik. Varnostne kopije so vsako noč šifrirane in shranjene zunaj stroja, njihova obnova je vključena, selitev vašega sedanjega strežnika pa je brezplačna.

Odkrijte Managed VPS

Pogosta vprašanja

Ali je Ryot brezplačen?

Da. Ryot je pod licenco GPL-3.0: lahko ga poganjate zase, za svojo družino ali svojo ekipo, ne da bi kupili licenco. Ryot Pro je neobvezen plačljiv ključ, ki isti sliki doda funkcije. Ostane strošek strežnika, na katerem teče.

Kako namestim Ryot z Docker Compose?

V datoteki compose.yaml uporabite sliko ignisda/ryot in PostgreSQL 18. Geslo zbirke podatkov in SERVER_ADMIN_ACCESS_TOKEN postavite v datoteko .env, FRONTEND_URL nastavite na svoj naslov https, vrata 8000 objavite na 127.0.0.1, zaženite docker compose up -d in predenj postavite obratni posredniški strežnik s HTTPS.

Katere so privzete poverilnice za Ryot?

Teh ni. Na strani za prijavo kliknite Create a new account?: prvi ustvarjeni račun postane skrbnik. Nato nastavite USERS_ALLOW_REGISTRATION=false, da zaprete registracije; skrbnik druge uporabnike povabi iz Settings, Users, s povezavo za enkratno uporabo.

Zakaj Ryot ne najde filmov ali serij?

Od v9 filmi in serije potrebujejo vaš lastni žeton TMDB: ustvarite brezplačen račun TMDB, zaprosite za ključ API in njegov API Read Access Token vpišite v MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN. Videoigre potrebujejo aplikacijo na Twitchu, knjige pa delujejo brez kakršnega koli ključa.

Koliko pomnilnika potrebuje Ryot?

Malo. Na našem testnem VPS je sveža namestitev porabila približno 240 do 300 MB za Ryot in 70 MB za PostgreSQL, sliki pa zasedata približno 810 MB diska.

Kako varnostno kopiram Ryot?

Zbirko podatkov PostgreSQL izpišite z docker compose exec -T ryot-db pg_dump -U ryot -Fc ryot pod umask 077, da jo lahko bere samo root, in shranite kopijo svoje datoteke .env. Za obnovo ustavite aplikacijo, zbirko podatkov z dropdb in createdb znova ustvarite prazno, nato izpis naložite s pg_restore --exit-on-error --no-owner.

Kako posodobim Ryot?

Preberite opombe ob izdaji in naredite varnostno kopijo, spremenite oznako slike v compose.yaml, nato zaženite docker compose pull in docker compose up -d. Migracije zbirke podatkov se ob zagonu izvedejo same. Med glavnimi različicami sledite strani o migraciji.

Ali Managed VPS pokriva Ryot?

Managed VPS pokriva strežnik: sistem, varnost, nadzor in varnostne kopije. Naše ekipe tudi proaktivno spremljajo vašo instanco in vam priporočajo koristne popravke, ki jih uvedete vi. Poseg v aplikacijo se zaračuna po urah ali pavšalno.

Stopite v stik z nami