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.
Autor: Simon Vasconcelos Lee
Avaldatud 19. novembril 2026Lugemisaeg: 11 minutit
ignisda/ryot ja PostgreSQL 18, port 8000 avaldatud aadressil 127.0.0.1 HTTPS-i pöördproksi taga.SERVER_ADMIN_ACCESS_TOKEN faili .env ning määrake muutujas FRONTEND_URL oma avalik aadress.USERS_ALLOW_REGISTRATION=false, et privaatses instantsis registreerumine sulgeda.pg_dump ja uuendage, muutes tõmmise silti.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.
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.
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.
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:
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:
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: viitefail avaldab selle ilma aadressita ja Docker avab selle siis serveri kõigil aadressidel. Kohalikult avaldatuna on see kättesaadav ainult pöördproksi kaudu.postgres. Siin saab eraldi kasutaja ryot juhusliku parooli, kuueteistkümnendsüsteemis, et seda ei peaks muutujas DATABASE_URL paomärkidega kirjutama.SERVER_ADMIN_ACCESS_TOKEN on kohustuslik: see volitab administraatoritoiminguid API kaudu ja krüpteerib teie kasutajate kaheastmelise autentimise saladused. Hoidke see salajasena ja muutumatuna: teise loaga ei saa neid saladusi enam lugeda.FRONTEND_URL on teie avalik aadress kujul https://. Ryot kasutab seda oma loodavate linkide alusena ja OpenID Connect vajab seda.TZ on ajastatud tööde ajavöönd, vaikimisi GMT: määrake oma ajavöönd IANA loendist.v10 koos valikuga pull_policy: always, mis järgib iga käivitamisel iga alamversiooni. Täielik versioon, siin v10.5.8, laseb teil iga uuenduse aja ise valida.postgres_storage hoiab kõiki teie andmeid. PostgreSQL 18 hoiab neid kaustas /var/lib/postgresql, mistõttu köide ühendatakse sinna, mitte kausta /var/lib/postgresql/data nagu vanemate versioonide puhul.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:
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.
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.
ryot.example.com {
reverse_proxy 127.0.0.1:8000
}
sudo systemctl reload caddy
CADDY_TRUSTED_PROXIES.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:
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».
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.
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:
| Meedia | Pakkuja | Mida määrata |
|---|---|---|
| Raamatud | Open Library | Mitte midagi: toimib kohe. Google Books ja Hardcover on valikulised, oma API võtmega |
| Filmid ja sarjad | TMDB või TVDB | MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN, tasuta TMDB konto API Read Access Token, või MOVIES_AND_SHOWS_TVDB_API_KEY |
| Videomängud | IGDB, Twitchi kaudu | VIDEO_GAMES_TWITCH_CLIENT_ID ja VIDEO_GAMES_TWITCH_CLIENT_SECRET, Twitchi arendajakonsooli rakendusest |
| Muusika | Spotify, valikuline | MUSIC_SPOTIFY_CLIENT_ID ja MUSIC_SPOTIFY_CLIENT_SECRET |
| Anime import | MyAnimeList | ANIME_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.
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:
(
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.
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:
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 peatab taastamise esimese vea juures, selle asemel et jätkata ja vigadest lõpus teatada, ning && peatavad jada samas kohas: Ryot jääb peatatuks. See, mis enne viga laaditi, jääb andmebaasi, seega alustage pärast põhjuse kõrvaldamist uuesti käsust dropdb.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.
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:
docker compose pull
docker compose up -d
docker compose logs ryot | grep -i migration
develop järgib põhiharu: dokumentatsioon hoiatab, et selles on sageli suuri vigu ja see võib andmeid kaotada. Jääge väljalasete juurde.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.
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.
| Teema | Meie meeskonnad | Teie |
|---|---|---|
| Server | Süsteemi- ja turvauuendused, sekkumised serverisse kaasa arvatud | Teile sobiv hetk |
| Seire | Serverit jälgitakse ööpäevaringselt, sekkumisega ilma teie kõnet ootamata | Teie ajalugu, kogud ja integratsioonid Ryotis |
| Ryot | Proaktiivne jälgimine: vead, aeglus, andmebaas ja kettaruum avastatakse, parandus soovitatakse | Selle paigaldus, uuendused, API võtmed ja sätted, mille rakendate teie või teie tehisintellekti assistent |
| Kasutajad | Neid kandev server, jälgitud ja varundatud | Kontod, registreerumine ja ühekordne sisselogimine |
| Varukoopiad | Igal ööl, krüpteeritult ja masinast väljaspool hoituna; taastamine sisaldub | Ryoti enda andmebaasi väljavõtted ja JSON-ekspordid ning taastamistaotlus, kui seda vajate |
| Üleviimine | Teie 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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Simafri
Räägime teie kavatsusest
Öelge meile paari sõnaga, mida vajate: vastame teile kiiresti.
Aitäh! Teie päring on saadetud. Võtame teiega peagi ühendust.
Eelistate e-posti? Kirjutage meile aadressil support@simafri.com.