Хостването на Ryot на Managed VPS означава, че историята на това, което гледате, четете, играете и вдигате, остава на ваш собствен сървър, който нашите екипи поддържат актуален и наблюдават денем и нощем. Ryot е свободен тракер с отворен код, с лиценз GPL-3.0, за филми, сериали, книги, игри, подкасти, музика и тренировки. Това ръководство следва официалния му Docker образ във версия v10.5.8, а ние изпълнихме всяка команда на VPS на Simafri, преди да го напишем: инсталиране с Docker Compose и PostgreSQL, HTTPS, първият акаунт, API ключовете за всеки тип медия, резервните копия и обновленията.
Автор: Simon Vasconcelos Lee
Публикувано на 19 ноември 2026 г.Време за четене: 11 минути
ignisda/ryot и PostgreSQL 18, с порт 8000, публикуван на 127.0.0.1 зад обратен прокси с HTTPS.SERVER_ADMIN_ACCESS_TOKEN във файл .env и задайте FRONTEND_URL на публичния си адрес.USERS_ALLOW_REGISTRATION=false, за да затворите регистрациите на частна инстанция.pg_dump, после обновявайте, като смените етикета на образа.Ryot, от „Roll Your Own Tracker“, произнасяно „райът“, пази на едно място това, което сте гледали, чели, играли и тренирали, със статистики, календар на предстоящото и ваши собствени колекции. Разработчикът му, IgnisDa, го пише на Rust, с уеб интерфейс, който можете да инсталирате на телефон като приложение.
Ryot е публикуван с GNU General Public License, версия 3 (GPL-3.0). Можете да го използвате безплатно, за себе си, за семейството си, за клуба си или за фирмата си, да го копирате и да го променяте. Ако разпространявате променена версия, разпространявате и изходния ѝ код под същия лиценз. Софтуерът се предоставя без гаранция.
Ryot Pro е платен ключ, продаван от разработчика, който отключва допълнителни функции, като споделяне на профили и персонализирани препоръки. Той се поставя в променлива SERVER_PRO_KEY на същия образ, а сървърът се връща към общностната версия, ако ключът изтече. Нищо в това ръководство не го изисква.
Документацията не поставя минимален размер, а Ryot е лек. Ето какво измерихме на нашия тестов VPS, току-що инсталиран:
Размерът на сървъра зависи следователно от броя на потребителите и от другите приложения, които пускате до Ryot. На Managed VPS ни разкажете как го използвате и ще ви препоръчаме подходящия размер.
Ryot се доставя като един образ, ignisda/ryot, публикуван и като ghcr.io/ignisda/ryot, който обслужва и интерфейса, и API на порт 8000. Той изисква PostgreSQL 15 или по-нова версия, която работи до него в собствен контейнер. На сървър с Docker Engine и неговия плъгин Compose, инсталирани от хранилището на Docker за Ubuntu, създайте папка като /opt/ryot и поставете в нея този 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:
Двете тайни отиват във файл .env до него, който Docker Compose чете сам. Създайте го четим само за root, после стартирайте стека:
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: референтният файл го публикува без адрес, а тогава Docker го отваря на всички адреси на сървъра. Публикуван локално, той е достъпен само през обратния прокси.postgres като потребител и парола. Тук отделен потребител ryot получава случайна парола, в шестнадесетичен вид, за да не изисква екраниране в DATABASE_URL.SERVER_ADMIN_ACCESS_TOKEN е задължителен: той разрешава администраторските операции през API и шифрова тайните за двуфакторно удостоверяване на потребителите ви. Пазете го в тайна и го пазете непроменен: с друг токен тези тайни вече не могат да бъдат прочетени.FRONTEND_URL е публичният ви адрес, с https://. Ryot го използва като основа на връзките, които генерира, а OpenID Connect се нуждае от него.TZ е часовата зона на планираните задачи, по подразбиране GMT: поставете своята, от списъка на IANA.v10 с pull_policy: always, което следва всяка второстепенна версия при всяко стартиране. Пълната версия, тук v10.5.8, ви позволява да изберете кога да стане всяко обновяване.postgres_storage пази всичките ви данни. PostgreSQL 18 ги държи в /var/lib/postgresql, затова томът е монтиран там, а не на /var/lib/postgresql/data, както при по-старите версии.Първото стартиране изпълнява миграциите на базата данни и изтегля каталога с упражнения; на нашия тестов VPS Ryot отговори след няколко секунди. За да проверите дали отговаря:
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
Първата команда отговаря с 200. Втората връща конфигурацията, заредена от сървъра, във формат JSON, със скрити тайни: удобен начин да проверите дадена променлива.
Контейнерът обслужва Ryot по HTTP, на порт 8000. HTTPS се поема от обратен прокси пред него, който трябва да препраща публичната заглавка Host и X-Forwarded-Proto. Ние тествахме Caddy, инсталиран от официалното му хранилище за Debian и Ubuntu: той сам получава сертификата Let’s Encrypt, подновява го и по подразбиране препраща тези заглавки.
ryot.example.com {
reverse_proxy 127.0.0.1:8000
}
sudo systemctl reload caddy
CADDY_TRUSTED_PROXIES.Ryot няма акаунт по подразбиране, а регистрациите са отворени на нова инстанция. Първият акаунт, който бъде създаден, получава ролята Admin; следващите са обикновени потребители. Създайте своя веднага след първото стартиране:
За частна инстанция затворете регистрациите: добавете USERS_ALLOW_REGISTRATION=false към средата на услугата ryot, после изпълнете docker compose up -d. На нашия тестов VPS връзката „Create a new account?“ изчезна, а опит за регистрация от адреса за регистрация беше отказан от сървъра с „Registration is disabled“.
Тествахме го при затворени регистрации: поканеният акаунт беше създаден като обикновен потребител, паролата му беше зададена от връзката и той достигна до собственото си табло.
За да влизате вместо това с фирмените си акаунти, Ryot поддържа OpenID Connect: задайте SERVER_OIDC_CLIENT_ID, SERVER_OIDC_CLIENT_SECRET и SERVER_OIDC_ISSUER_URL и декларирайте https://ryot.example.com/api/auth като адрес за пренасочване при доставчика си.
Ryot намира данните и обложките на всеки тип медия при доставчик. Някои работят без ключ, други изискват вашия, тъй като споделените ключове бяха премахнати във v9:
| Медия | Доставчик | Какво да зададете |
|---|---|---|
| Книги | Open Library | Нищо: работи веднага. Google Books и Hardcover са незадължителни, с техния API ключ |
| Филми и сериали | TMDB или TVDB | MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN, API Read Access Token на безплатен акаунт в TMDB, или MOVIES_AND_SHOWS_TVDB_API_KEY |
| Видеоигри | IGDB, чрез Twitch | VIDEO_GAMES_TWITCH_CLIENT_ID и VIDEO_GAMES_TWITCH_CLIENT_SECRET, от приложение в конзолата за разработчици на Twitch |
| Музика | Spotify, незадължително | MUSIC_SPOTIFY_CLIENT_ID и MUSIC_SPOTIFY_CLIENT_SECRET |
| Импорт на аниме | MyAnimeList | ANIME_AND_MANGA_MAL_CLIENT_ID, нужен само за импорт от MyAnimeList |
Тези ключове са тайни: поставете ги във файла .env, добавете ред като - MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN=${MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN} към средата на услугата ryot, после изпълнете docker compose up -d. Страницата за конфигурация в документацията изброява всички останали променливи.
Всичко се намира на две места: базата данни PostgreSQL, в тома postgres_storage, и файлът ви .env. Пазете последния на сигурно място: SERVER_ADMIN_ACCESS_TOKEN е нужен, за да се четат тайните за двуфакторно удостоверяване, съхранени в базата данни. Образът на PostgreSQL включва pg_dump. Дъмпът съдържа всеки акаунт и неговата история, затова го създайте четим само за root, с umask 077 в скоби: останалата част от сесията ви запазва обичайната си маска. Файл, който вече съществува, запазва правата си, когато бъде презаписан, затова редът с find първо затваря дъмповете и копията, които вече са в папката, преди да бъде записано каквото и да било, и спира архивирането, ако не успее:
(
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
)
Планирайте това копие и го изпращайте извън сървъра. Поставени на диска, дъмповете влизат и в нощните резервни копия на сървъра.
На същата или на нова инсталация, със същия .env, спрете приложението, заменете базата данни с празна, заредете дъмпа в нея, после стартирайте приложението отново:
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 спира възстановяването при първата грешка, вместо да продължи и да съобщи грешките накрая, а && спират последователността там: Ryot остава спрян. Заредените преди грешката данни остават в базата данни, затова започнете отново от dropdb, щом причината бъде отстранена.Тествахме целия цикъл на нашия VPS точно с тези команди: дъмп, базата данни изтрита и създадена отново празна, възстановяване. Двата акаунта, колекциите им и 876-те упражнения се върнаха, а администраторът влезе отново веднага.
Ryot експортира също вашите собствени данни в JSON, от страницата с настройки „Imports and Exports“, и може да ги импортира обратно. Този експорт изисква файлово хранилище, съвместимо с S3; дъмпът на базата данни по-горе работи без него.
Ryot излиза често, приблизително всяка седмица. Прочетете бележките към версията, направете резервно копие, сменете етикета на образа в compose.yaml, после изтеглете новия образ и пресъздайте контейнера. Миграциите на базата данни се изпълняват сами при стартиране:
docker compose pull
docker compose up -d
docker compose logs ryot | grep -i migration
develop следва основния клон: документацията предупреждава, че често съдържа сериозни грешки и може да загуби данни. Останете на официалните версии.Ryot събира анонимни данни за използването, прегледи на страници и няколко събития, в самостоятелно хоствана инстанция на Umami на разработчика си. За да я изключите, добавете DISABLE_TELEMETRY=true към средата на услугата ryot, после изпълнете docker compose up -d.
Самостоятелното хостване изисква да поддържате сървъра освен приложението. На Managed VPS нашите екипи поемат сървъра и следят проактивно вашата инстанция; Ryot остава ваш софтуер, с вашата история и вашите настройки.
| Тема | Нашите екипи | Вие |
|---|---|---|
| Сървърът | Обновления на системата и на сигурността, включително намеси на сървъра | Моментът, който ви пасва |
| Наблюдението | Сървър, следен денонощно, 7 дни в седмицата, с намеса, без да се чака обаждането ви | Вашата история, колекции и интеграции в Ryot |
| Ryot | Проактивно проследяване: грешки, забавяния, базата данни и дисковото пространство се откриват, препоръчва се корекция | Инсталирането, обновяванията, API ключовете и настройките му, които прилагате вие или вашият AI асистент |
| Потребителите | Сървърът, който ги носи, наблюдаван и архивиран | Акаунтите, регистрациите и еднократното влизане |
| Резервните копия | Всяка нощ, криптирани и пазени извън машината; възстановяването е включено | Дъмповете на базата данни и JSON експортите на самия Ryot и заявката за възстановяване, когато ви потрябва |
| Миграцията | Сегашният ви сървър е мигриран, безплатно | Моментът на превключването |
Ако предпочитате нашите екипи да се намесват в самото приложение, тази услуга се фактурира на час или на фиксирана цена, с оферта, съобщена преди намесата.
С Managed VPS от Simafri нашите екипи поддържат актуален сървъра на вашата инстанция на Ryot, наблюдават го денем и нощем и се намесват, без да чакат обаждането ви; те следят проактивно и вашата инстанция и ви препоръчват полезните корекции, които прилагате вие или вашият AI асистент. Резервните копия се криптират всяка нощ и се пазят извън машината, възстановяването им е включено, а миграцията от сегашния ви сървър е безплатна.
Да. Ryot е с лиценз GPL-3.0: можете да го пускате за себе си, за семейството си или за екипа си, без да купувате лиценз. Ryot Pro е незадължителен платен ключ, който добавя функции към същия образ. Остава цената на сървъра, на който работи.
Използвайте образа ignisda/ryot и PostgreSQL 18 в compose.yaml. Поставете паролата на базата данни и SERVER_ADMIN_ACCESS_TOKEN във файл .env, задайте FRONTEND_URL на адреса си с https, публикувайте порт 8000 на 127.0.0.1, изпълнете docker compose up -d и поставете пред него обратен прокси с HTTPS.
Няма такива. Щракнете върху „Create a new account?“ на страницата за вход: първият създаден акаунт става администратор. После задайте USERS_ALLOW_REGISTRATION=false, за да затворите регистрациите; администраторът кани другите потребители от Settings, Users, с връзка за еднократна употреба.
От v9 филмите и сериалите изискват ваш собствен токен от TMDB: създайте безплатен акаунт в TMDB, поискайте API ключ и задайте неговия API Read Access Token в MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN. Видеоигрите изискват приложение в Twitch, а книгите работят без никакъв ключ.
Малко. На нашия тестов VPS нова инсталация използваше около 240 до 300 MB за Ryot и 70 MB за PostgreSQL, а двата образа заемат около 810 MB на диска.
Направете дъмп на базата данни PostgreSQL с docker compose exec -T ryot-db pg_dump -U ryot -Fc ryot с umask 077, така че само root да може да го чете, и пазете копие на файла си .env. За възстановяване спрете приложението, създайте отново празна база данни с dropdb и createdb, после заредете дъмпа с pg_restore --exit-on-error --no-owner.
Прочетете бележките към версията и направете резервно копие, сменете етикета на образа в compose.yaml, после изпълнете docker compose pull и docker compose up -d. Миграциите на базата данни се изпълняват сами при стартиране. Между основните версии следвайте страницата за миграция.
Managed VPS покрива сървъра: система, сигурност, наблюдение и резервни копия. Нашите екипи следят проактивно и вашата инстанция и ви препоръчват полезните корекции, които прилагате вие. Намеса в самото приложение се фактурира на час или на фиксирана цена.
Simafri
Да поговорим за Вашия проект
Кажете ни с няколко думи от какво имате нужда: отговаряме Ви бързо.
Благодарим! Вашето запитване е изпратено. Ще се свържем с вас скоро.
Предпочитате имейл? Пишете ни на support@simafri.com.