Ryot talpinimas Managed VPS serveryje reiškia, kad istorija to, ką žiūrite, skaitote, žaidžiate ir keliate sporto salėje, lieka jūsų pačių serveryje, kurį mūsų komandos prižiūri atnaujintą ir stebi dieną bei naktį. Ryot yra laisva atvirojo kodo sekimo programa, platinama pagal GPL-3.0 licenciją, skirta filmams, serialams, knygoms, žaidimams, tinklalaidėms, muzikai ir treniruotėms. Šis gidas seka oficialų jos Docker atvaizdą, v10.5.8 versiją, o kiekvieną komandą prieš rašydami išbandėme Simafri VPS serveryje: diegimą su Docker Compose ir PostgreSQL, HTTPS, pirmąją paskyrą, kiekvieno medijos tipo API raktus, atsargines kopijas ir atnaujinimus.
Autorius: Simon Vasconcelos Lee
Paskelbta 2026 m. lapkričio 19 d.Skaitymo trukmė: 11 min.
ignisda/ryot ir PostgreSQL 18, o 8000 prievadas paskelbtas adresu 127.0.0.1 už HTTPS atvirkštinio tarpinio serverio.SERVER_ADMIN_ACCESS_TOKEN įrašykite į .env failą, o kintamajame FRONTEND_URL nurodykite savo viešąjį adresą.USERS_ALLOW_REGISTRATION=false, kad privačiame egzemplioriuje uždarytumėte registraciją.pg_dump, o atnaujinkite pakeisdami atvaizdo žymą.Ryot, sutrumpinimas iš „Roll Your Own Tracker“, tariamas „riot“, vienoje vietoje saugo tai, ką matėte, perskaitėte, žaidėte ir treniravote, su statistika, artėjančių naujienų kalendoriumi ir jūsų pačių kolekcijomis. Jos kūrėjas IgnisDa ją rašo Rust kalba, o jos žiniatinklio sąsają galima įdiegti telefone kaip programėlę.
Ryot platinama pagal GNU General Public License 3 versiją (GPL-3.0). Ją galite nemokamai naudoti sau, savo šeimai, klubui ar įmonei, kopijuoti ir keisti. Jei platinate pakeistą versiją, platinate ir jos išeities kodą pagal tą pačią licenciją. Programinė įranga teikiama be garantijų.
Ryot Pro yra kūrėjo parduodamas mokamas raktas, atrakinantis papildomas funkcijas, pavyzdžiui, dalijimąsi profiliu ir asmenines rekomendacijas. Jis įrašomas į to paties atvaizdo kintamąjį SERVER_PRO_KEY, o pasibaigus rakto galiojimui serveris grįžta prie bendruomenės versijos. Šiam gidui jo visiškai nereikia.
Dokumentacija nenurodo minimalaus dydžio, o Ryot yra lengva. Štai ką išmatavome savo ką tik įdiegtame bandomajame VPS serveryje:
Todėl serverio dydis priklauso nuo naudotojų skaičiaus ir kitų programų, kurias naudojate šalia Ryot. Naudojant Managed VPS, papasakokite mums, kaip ją naudojate, ir mes rekomenduosime tinkamą dydį.
Ryot pateikiama kaip vienas atvaizdas, ignisda/ryot, taip pat skelbiamas kaip ghcr.io/ignisda/ryot, teikiantis ir sąsają, ir API 8000 prievadu. Jai reikia PostgreSQL 15 ar naujesnės versijos, veikiančios šalia, savo konteineryje. Serveryje su Docker Engine ir jo Compose papildiniu, įdiegtais iš Docker saugyklos Ubuntu sistemai, sukurkite katalogą, pavyzdžiui, /opt/ryot, ir įdėkite į jį šį compose.yaml, parengtą pagal diegimo puslapio failą:
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:
Dvi slaptos reikšmės dedamos šalia esančiame .env faile, kurį Docker Compose nuskaito savaime. Sukurkite jį taip, kad skaityti galėtų tik root, tada paleiskite rinkinį:
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
127.0.0.1: pavyzdinis failas jį skelbia be adreso, ir tada Docker jį atveria visais serverio adresais. Paskelbtas lokaliai, jis pasiekiamas tik per atvirkštinį tarpinį serverį.postgres. Čia atskiras naudotojas ryot gauna atsitiktinį šešioliktainį slaptažodį, kad jo nereikėtų koduoti kintamajame DATABASE_URL.SERVER_ADMIN_ACCESS_TOKEN yra privalomas: jis suteikia teisę atlikti administratoriaus operacijas per API ir šifruoja jūsų naudotojų dviejų veiksnių autentifikavimo slaptas reikšmes. Laikykite jį paslaptyje ir nekeiskite: su kitu žetonu šių slaptų reikšmių nebebus galima perskaityti.FRONTEND_URL yra jūsų viešasis adresas su https://. Ryot jį naudoja kaip savo kuriamų nuorodų pagrindą, o OpenID Connect jo reikia.TZ yra suplanuotų užduočių laiko juosta, pagal numatymą GMT: nurodykite savąją iš IANA sąrašo.v10 su pull_policy: always, kuri kiekvieno paleidimo metu seka kiekvieną smulkesnę versiją. Visa versija, čia v10.5.8, leidžia pasirinkti, kada vyks kiekvienas atnaujinimas.postgres_storage saugo visus jūsų duomenis. PostgreSQL 18 juos laiko kataloge /var/lib/postgresql, todėl tomas prijungiamas ten, o ne prie /var/lib/postgresql/data, kaip senesnėse versijose.Pirmasis paleidimas paleidžia duomenų bazės migracijas ir atsisiunčia pratimų katalogą; mūsų bandomajame VPS serveryje Ryot atsakė per kelias sekundes. Norėdami patikrinti, ar ji atsako:
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
Pirmoji komanda atsako 200. Antroji grąžina serverio įkeltą konfigūraciją JSON formatu, su paslėptomis slaptomis reikšmėmis: patogus būdas patikrinti kintamąjį.
Konteineris Ryot teikia per HTTP, 8000 prievadu. HTTPS rūpinasi priešais jį stovintis atvirkštinis tarpinis serveris, kuris turi perduoti viešąją antraštę Host ir X-Forwarded-Proto. Išbandėme Caddy, įdiegtą iš jo oficialios Debian ir Ubuntu saugyklos: jis pats gauna Let’s Encrypt sertifikatą, jį atnaujina ir pagal numatymą perduoda šias antraštes.
ryot.example.com {
reverse_proxy 127.0.0.1:8000
}
sudo systemctl reload caddy
CADDY_TRUSTED_PROXIES.Ryot neturi numatytosios paskyros, o naujame egzemplioriuje registracija atvira. Pirmoji sukurta paskyra gauna vaidmenį Admin; tolesnės yra paprasti naudotojai. Susikurkite savo paskyrą iškart po pirmojo paleidimo:
Privačiam egzemplioriui uždarykite registraciją: į paslaugos ryot aplinką pridėkite USERS_ALLOW_REGISTRATION=false, tada paleiskite docker compose up -d. Mūsų bandomajame VPS serveryje nuoroda „Create a new account?“ dingo, o bandymą registruotis registracijos adresu serveris atmetė su pranešimu „Registration is disabled“.
Tai išbandėme su uždaryta registracija: pakviesta paskyra buvo sukurta kaip paprasto naudotojo, jos slaptažodis nustatytas per nuorodą, ir ji pateko į savo valdymo skydelį.
Norėdami vietoj to prisijungti su savo įmonės paskyromis, naudokite OpenID Connect, kurį Ryot palaiko: nustatykite SERVER_OIDC_CLIENT_ID, SERVER_OIDC_CLIENT_SECRET ir SERVER_OIDC_ISSUER_URL, o savo teikėjo pusėje nurodykite https://ryot.example.com/api/auth kaip peradresavimo adresą.
Ryot kiekvieno medijos tipo duomenis ir viršelius randa pas teikėją. Kai kurie veikia be rakto, kitiems reikia jūsų rakto, nes bendri raktai buvo pašalinti v9 versijoje:
| Medija | Teikėjas | Ką nustatyti |
|---|---|---|
| Knygos | Open Library | Nieko: veikia iškart. Google Books ir Hardcover yra neprivalomi, su savo API raktu |
| Filmai ir serialai | TMDB arba TVDB | MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN, nemokamos TMDB paskyros API Read Access Token, arba MOVIES_AND_SHOWS_TVDB_API_KEY |
| Vaizdo žaidimai | IGDB, per Twitch | VIDEO_GAMES_TWITCH_CLIENT_ID ir VIDEO_GAMES_TWITCH_CLIENT_SECRET, iš programos Twitch kūrėjų konsolėje |
| Muzika | Spotify, neprivaloma | MUSIC_SPOTIFY_CLIENT_ID ir MUSIC_SPOTIFY_CLIENT_SECRET |
| Anime importas | MyAnimeList | ANIME_AND_MANGA_MAL_CLIENT_ID, reikalingas tik importuojant iš MyAnimeList |
Šie raktai yra slaptos reikšmės: įrašykite juos į .env failą, į paslaugos ryot aplinką pridėkite eilutę, pavyzdžiui, - MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN=${MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN}, tada paleiskite docker compose up -d. Dokumentacijos konfigūracijos puslapyje išvardyti visi kiti kintamieji.
Viskas yra dviejose vietose: PostgreSQL duomenų bazėje, tome postgres_storage, ir jūsų .env faile. Pastarąjį laikykite saugiai: SERVER_ADMIN_ACCESS_TOKEN reikalingas duomenų bazėje saugomoms dviejų veiksnių slaptoms reikšmėms perskaityti. PostgreSQL atvaizde yra pg_dump. Išklotinėje yra visos paskyros ir jų istorija, todėl sukurkite ją taip, kad skaityti galėtų tik root, su umask 077 skliaustuose: likusi jūsų sesija išlaiko įprastą kaukę. Jau esamas failas perrašomas išlaiko savo teises, todėl eilutė find pirmiausia uždaro kataloge jau esančias išklotines ir kopijas, dar prieš ką nors įrašant, ir sustabdo kopijavimą, jei to padaryti nepavyksta:
(
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
)
Suplanuokite šią kopiją ir siųskite ją už serverio ribų. Laikomos diske, išklotinės taip pat patenka į naktines serverio atsargines kopijas.
Tame pačiame ar naujame diegime, su tuo pačiu .env, sustabdykite programą, pakeiskite duomenų bazę tuščia, įkelkite į ją išklotinę, tada vėl paleiskite programą:
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
--exit-on-error sustabdo atkūrimą ties pirma klaida, užuot tęsus ir pranešus apie klaidas pabaigoje, o && sustabdo seką toje vietoje: Ryot lieka sustabdyta. Tai, kas buvo įkelta iki klaidos, lieka duomenų bazėje, todėl pašalinę priežastį pradėkite iš naujo nuo dropdb.Visą ciklą išbandėme savo VPS serveryje būtent šiomis komandomis: išklotinė, duomenų bazė ištrinta ir vėl sukurta tuščia, atkūrimas. Abi paskyros, jų kolekcijos ir 876 pratimai sugrįžo, o administratorius iškart vėl prisijungė.
Ryot taip pat eksportuoja jūsų pačių duomenis JSON formatu iš nustatymų puslapio „Imports and Exports“ ir gali juos vėl importuoti. Tam eksportui reikia su S3 suderinamos failų saugyklos; aukščiau aprašyta duomenų bazės išklotinė veikia ir be jos.
Ryot išleidžiama dažnai, maždaug kas savaitę. Perskaitykite versijos pastabas, padarykite atsarginę kopiją, pakeiskite atvaizdo žymą faile compose.yaml, tada atsisiųskite naują atvaizdą ir iš naujo sukurkite konteinerį. Duomenų bazės migracijos paleidžiamos savaime paleidimo metu:
docker compose pull
docker compose up -d
docker compose logs ryot | grep -i migration
develop seka pagrindinę šaką: dokumentacija įspėja, kad joje dažnai būna didelių klaidų ir ji gali prarasti duomenis. Laikykitės oficialių leidimų.Ryot renka anoniminius naudojimo duomenis, puslapių peržiūras ir kelis įvykius, savo kūrėjo savarankiškai talpinamame Umami egzemplioriuje. Norėdami tai išjungti, į paslaugos ryot aplinką pridėkite DISABLE_TELEMETRY=true, tada paleiskite docker compose up -d.
Talpinant savo serveryje, be programos reikia prižiūrėti ir patį serverį. Naudojant Managed VPS, mūsų komandos perima serverį ir proaktyviai stebi jūsų egzempliorių; Ryot lieka jūsų programa su jūsų istorija ir jūsų nustatymais.
| Tema | Mūsų komandos | Jūs |
|---|---|---|
| Serveris | Sistemos ir saugumo atnaujinimai, įskaitant įsikišimą serveryje | Jums tinkamas momentas |
| Stebėsena | Serveris stebimas 24 val. per parą, 7 dienas per savaitę, įsikišant nelaukiant jūsų skambučio | Jūsų istorija, kolekcijos ir integracijos Ryot programoje |
| Ryot | Proaktyvi stebėsena: klaidos, sulėtėjimai, duomenų bazė ir disko vieta pastebimi, rekomenduojamas pataisymas | Jos diegimas, atnaujinimai, API raktai ir nustatymai, kuriuos pritaikote jūs arba jūsų DI asistentas |
| Naudotojai | Juos nešantis serveris, stebimas ir saugomas atsarginėmis kopijomis | Paskyros, registracija ir vienkartinis prisijungimas |
| Atsarginės kopijos | Kiekvieną naktį, šifruotos ir saugomos už mašinos ribų; atkūrimas įskaičiuotas | Pačios Ryot duomenų bazės išklotinės ir JSON eksportai, taip pat atkūrimo prašymas, kai jo prireikia |
| Perkėlimas | Jūsų dabartinis serveris perkeliamas nemokamai | Perjungimo momentas |
Jei norite, kad mūsų komandos įsikištų į pačią programą, ši paslauga apmokestinama valandomis arba fiksuota kaina, o skaičiavimas pateikiamas prieš įsikišimą.
Su Simafri Managed VPS mūsų komandos palaiko jūsų Ryot egzemplioriaus serverį atnaujintą, stebi jį dieną ir naktį ir įsikiša nelaukdamos jūsų skambučio; jos taip pat proaktyviai stebi jūsų egzempliorių ir rekomenduoja naudingus pataisymus, kuriuos pritaikote jūs arba jūsų DI asistentas. Atsarginės kopijos kiekvieną naktį šifruojamos ir saugomos už mašinos ribų, jų atkūrimas įskaičiuotas, o jūsų dabartinio serverio perkėlimas nemokamas.
Taip. Ryot platinama pagal GPL-3.0 licenciją: ją galite naudoti sau, savo šeimai ar komandai, nieko nepirkdami dėl licencijos. Ryot Pro yra neprivalomas mokamas raktas, pridedantis funkcijų tam pačiam atvaizdui. Lieka tik ją vykdančio serverio kaina.
Faile compose.yaml naudokite atvaizdą ignisda/ryot ir PostgreSQL 18. Duomenų bazės slaptažodį ir SERVER_ADMIN_ACCESS_TOKEN įrašykite į .env failą, FRONTEND_URL nustatykite į savo https adresą, paskelbkite 8000 prievadą adresu 127.0.0.1, paleiskite docker compose up -d ir priešais pastatykite HTTPS atvirkštinį tarpinį serverį.
Jų nėra. Prisijungimo puslapyje spustelėkite „Create a new account?“: pirmoji sukurta paskyra tampa administratoriaus paskyra. Tada nustatykite USERS_ALLOW_REGISTRATION=false, kad uždarytumėte registraciją; administratorius kitus naudotojus kviečia iš skilties Settings, Users, su vienkartine nuoroda.
Nuo v9 versijos filmams ir serialams reikia jūsų pačių TMDB žetono: susikurkite nemokamą TMDB paskyrą, paprašykite API rakto ir jo API Read Access Token įrašykite į MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN. Vaizdo žaidimams reikia Twitch programos, o knygos veikia be jokio rakto.
Nedaug. Mūsų bandomajame VPS serveryje naujas diegimas naudojo apie 240-300 MB Ryot ir 70 MB PostgreSQL, o du atvaizdai užima apie 810 MB disko.
Padarykite PostgreSQL duomenų bazės išklotinę komanda docker compose exec -T ryot-db pg_dump -U ryot -Fc ryot su umask 077, kad ją galėtų skaityti tik root, ir išsaugokite savo .env failo kopiją. Norėdami atkurti, sustabdykite programą, su dropdb ir createdb iš naujo sukurkite tuščią duomenų bazę, tada įkelkite išklotinę su pg_restore --exit-on-error --no-owner.
Perskaitykite versijos pastabas ir padarykite atsarginę kopiją, pakeiskite atvaizdo žymą faile compose.yaml, tada paleiskite docker compose pull ir docker compose up -d. Duomenų bazės migracijos paleidžiamos savaime paleidimo metu. Tarp pagrindinių versijų vadovaukitės migracijos puslapiu.
Managed VPS apima serverį: sistemą, saugumą, stebėseną ir atsargines kopijas. Mūsų komandos taip pat proaktyviai stebi jūsų egzempliorių ir rekomenduoja naudingus pataisymus, kuriuos pritaikote jūs. Įsikišimas į pačią programą apmokestinamas valandomis arba fiksuota kaina.
Simafri
Pakalbėkime apie jūsų sumanymą
Pasakykite mums keliais žodžiais, ko jums reikia: greitai jums atsakome.
Ačiū! Jūsų užklausa išsiųsta. Netrukus su jumis susisieksime.
Labiau mėgstate el. paštą? Rašykite mums adresu support@simafri.com.