Хостване на Ryot на Managed VPS: вашият тракер за медии и фитнес

Хостването на Ryot на Managed VPS означава, че историята на това, което гледате, четете, играете и вдигате, остава на ваш собствен сървър, който нашите екипи поддържат актуален и наблюдават денем и нощем. Ryot е свободен тракер с отворен код, с лиценз GPL-3.0, за филми, сериали, книги, игри, подкасти, музика и тренировки. Това ръководство следва официалния му Docker образ във версия v10.5.8, а ние изпълнихме всяка команда на VPS на Simafri, преди да го напишем: инсталиране с Docker Compose и PostgreSQL, HTTPS, първият акаунт, API ключовете за всеки тип медия, резервните копия и обновленията.

Simon Vasconcelos Lee Автор: Публикувано на 19 ноември 2026 г.Време за четене: 11 минути

Всички ръководства

Накратко

  1. Лицензът GPL-3.0 ви позволява да пускате Ryot за себе си, за семейството си или за клуба си, без да купувате лиценз; Ryot Pro, платен ключ, добавя функции върху същия образ.
  2. Инсталирайте го с Docker Compose: образът ignisda/ryot и PostgreSQL 18, с порт 8000, публикуван на 127.0.0.1 зад обратен прокси с HTTPS.
  3. Поставете паролата на базата данни и SERVER_ADMIN_ACCESS_TOKEN във файл .env и задайте FRONTEND_URL на публичния си адрес.
  4. Първият акаунт, който създадете, става администратор; после задайте USERS_ALLOW_REGISTRATION=false, за да затворите регистрациите на частна инстанция.
  5. Книгите работят веднага; филмите и сериалите изискват токен от TMDB, видеоигрите приложение в Twitch. Архивирайте с pg_dump, после обновявайте, като смените етикета на образа.

Какво прави Ryot

Ryot, от „Roll Your Own Tracker“, произнасяно „райът“, пази на едно място това, което сте гледали, чели, играли и тренирали, със статистики, календар на предстоящото и ваши собствени колекции. Разработчикът му, IgnisDa, го пише на Rust, с уеб интерфейс, който можете да инсталирате на телефон като приложение.

Какво позволява лицензът GPL-3.0

Ryot е публикуван с GNU General Public License, версия 3 (GPL-3.0). Можете да го използвате безплатно, за себе си, за семейството си, за клуба си или за фирмата си, да го копирате и да го променяте. Ако разпространявате променена версия, разпространявате и изходния ѝ код под същия лиценз. Софтуерът се предоставя без гаранция.

Ryot Pro е платен ключ, продаван от разработчика, който отключва допълнителни функции, като споделяне на профили и персонализирани препоръки. Той се поставя в променлива SERVER_PRO_KEY на същия образ, а сървърът се връща към общностната версия, ако ключът изтече. Нищо в това ръководство не го изисква.

Ресурсите, които да предвидите

Документацията не поставя минимален размер, а Ryot е лек. Ето какво измерихме на нашия тестов VPS, току-що инсталиран:

Размерът на сървъра зависи следователно от броя на потребителите и от другите приложения, които пускате до Ryot. На Managed VPS ни разкажете как го използвате и ще ви препоръчаме подходящия размер.

Инсталиране с Docker Compose

Ryot се доставя като един образ, ignisda/ryot, публикуван и като ghcr.io/ignisda/ryot, който обслужва и интерфейса, и API на порт 8000. Той изисква PostgreSQL 15 или по-нова версия, която работи до него в собствен контейнер. На сървър с Docker Engine и неговия плъгин Compose, инсталирани от хранилището на Docker за Ubuntu, създайте папка като /opt/ryot и поставете в нея този compose.yaml, базиран на файла от страницата за инсталиране:

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, после стартирайте стека:

Терминал, в /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

Първото стартиране изпълнява миграциите на базата данни и изтегля каталога с упражнения; на нашия тестов 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, със скрити тайни: удобен начин да проверите дадена променлива.

HTTPS: обратният прокси

Контейнерът обслужва Ryot по HTTP, на порт 8000. HTTPS се поема от обратен прокси пред него, който трябва да препраща публичната заглавка Host и X-Forwarded-Proto. Ние тествахме Caddy, инсталиран от официалното му хранилище за Debian и Ubuntu: той сам получава сертификата Let’s Encrypt, подновява го и по подразбиране препраща тези заглавки.

/etc/caddy/Caddyfile
ryot.example.com {
	reverse_proxy 127.0.0.1:8000
}
Терминал
sudo systemctl reload caddy

Първият акаунт, регистрациите и поканите

Ryot няма акаунт по подразбиране, а регистрациите са отворени на нова инстанция. Първият акаунт, който бъде създаден, получава ролята Admin; следващите са обикновени потребители. Създайте своя веднага след първото стартиране:

  1. Отворете адреса си: Ryot показва страницата си за вход.
  2. Щракнете върху „Create a new account?“, после въведете потребителско име и два пъти парола.
  3. Регистрирайте се, после влезте с новите си данни: попадате на таблото, с въвеждаща обиколка.
  4. В „Settings“, „Users“ акаунтът ви се появява с ролята Admin.

За частна инстанция затворете регистрациите: добавете USERS_ALLOW_REGISTRATION=false към средата на услугата ryot, после изпълнете docker compose up -d. На нашия тестов VPS връзката „Create a new account?“ изчезна, а опит за регистрация от адреса за регистрация беше отказан от сървъра с „Registration is disabled“.

Покана за другите потребители

  1. В „Settings“, „Users“ щракнете върху бутона + до заглавието.
  2. Въведете потребителското име на човека: Ryot създава акаунта и показва връзка за еднократна употреба.
  3. Изпратете връзката: човекът я отваря, избира парола, после влиза.

Тествахме го при затворени регистрации: поканеният акаунт беше създаден като обикновен потребител, паролата му беше зададена от връзката и той достигна до собственото си табло.

За да влизате вместо това с фирмените си акаунти, Ryot поддържа OpenID Connect: задайте SERVER_OIDC_CLIENT_ID, SERVER_OIDC_CLIENT_SECRET и SERVER_OIDC_ISSUER_URL и декларирайте https://ryot.example.com/api/auth като адрес за пренасочване при доставчика си.

Филми, сериали и игри: API ключовете

Ryot намира данните и обложките на всеки тип медия при доставчик. Някои работят без ключ, други изискват вашия, тъй като споделените ключове бяха премахнати във v9:

МедияДоставчикКакво да зададете
КнигиOpen LibraryНищо: работи веднага. Google Books и Hardcover са незадължителни, с техния API ключ
Филми и сериалиTMDB или TVDBMOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN, API Read Access Token на безплатен акаунт в TMDB, или MOVIES_AND_SHOWS_TVDB_API_KEY
ВидеоигриIGDB, чрез TwitchVIDEO_GAMES_TWITCH_CLIENT_ID и VIDEO_GAMES_TWITCH_CLIENT_SECRET, от приложение в конзолата за разработчици на Twitch
МузикаSpotify, незадължителноMUSIC_SPOTIFY_CLIENT_ID и MUSIC_SPOTIFY_CLIENT_SECRET
Импорт на анимеMyAnimeListANIME_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 първо затваря дъмповете и копията, които вече са в папката, преди да бъде записано каквото и да било, и спира архивирането, ако не успее:

Терминал, в /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
)

Планирайте това копие и го изпращайте извън сървъра. Поставени на диска, дъмповете влизат и в нощните резервни копия на сървъра.

Възстановяване

На същата или на нова инсталация, със същия .env, спрете приложението, заменете базата данни с празна, заредете дъмпа в нея, после стартирайте приложението отново:

Терминал, в /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

Тествахме целия цикъл на нашия VPS точно с тези команди: дъмп, базата данни изтрита и създадена отново празна, възстановяване. Двата акаунта, колекциите им и 876-те упражнения се върнаха, а администраторът влезе отново веднага.

Ryot експортира също вашите собствени данни в JSON, от страницата с настройки „Imports and Exports“, и може да ги импортира обратно. Този експорт изисква файлово хранилище, съвместимо с S3; дъмпът на базата данни по-горе работи без него.

Обновленията

Ryot излиза често, приблизително всяка седмица. Прочетете бележките към версията, направете резервно копие, сменете етикета на образа в compose.yaml, после изтеглете новия образ и пресъздайте контейнера. Миграциите на базата данни се изпълняват сами при стартиране:

Терминал, в /opt/ryot
docker compose pull
docker compose up -d
docker compose logs ryot | grep -i migration

Телеметрията

Ryot събира анонимни данни за използването, прегледи на страници и няколко събития, в самостоятелно хоствана инстанция на Umami на разработчика си. За да я изключите, добавете DISABLE_TELEMETRY=true към средата на услугата ryot, после изпълнете docker compose up -d.

Кой какво прави на Managed VPS

Самостоятелното хостване изисква да поддържате сървъра освен приложението. На Managed VPS нашите екипи поемат сървъра и следят проактивно вашата инстанция; Ryot остава ваш софтуер, с вашата история и вашите настройки.

ТемаНашите екипиВие
СървърътОбновления на системата и на сигурността, включително намеси на сървъраМоментът, който ви пасва
НаблюдениетоСървър, следен денонощно, 7 дни в седмицата, с намеса, без да се чака обаждането виВашата история, колекции и интеграции в Ryot
RyotПроактивно проследяване: грешки, забавяния, базата данни и дисковото пространство се откриват, препоръчва се корекцияИнсталирането, обновяванията, API ключовете и настройките му, които прилагате вие или вашият AI асистент
ПотребителитеСървърът, който ги носи, наблюдаван и архивиранАкаунтите, регистрациите и еднократното влизане
Резервните копияВсяка нощ, криптирани и пазени извън машината; възстановяването е включеноДъмповете на базата данни и JSON експортите на самия Ryot и заявката за възстановяване, когато ви потрябва
МиграциятаСегашният ви сървър е мигриран, безплатноМоментът на превключването

Ако предпочитате нашите екипи да се намесват в самото приложение, тази услуга се фактурира на час или на фиксирана цена, с оферта, съобщена преди намесата.

Ryot, на сървър, поддържан вместо вас

С Managed VPS от Simafri нашите екипи поддържат актуален сървъра на вашата инстанция на Ryot, наблюдават го денем и нощем и се намесват, без да чакат обаждането ви; те следят проактивно и вашата инстанция и ви препоръчват полезните корекции, които прилагате вие или вашият AI асистент. Резервните копия се криптират всяка нощ и се пазят извън машината, възстановяването им е включено, а миграцията от сегашния ви сървър е безплатна.

Разгледайте Managed VPS

Често задавани въпроси

Безплатен ли е Ryot?

Да. Ryot е с лиценз GPL-3.0: можете да го пускате за себе си, за семейството си или за екипа си, без да купувате лиценз. Ryot Pro е незадължителен платен ключ, който добавя функции към същия образ. Остава цената на сървъра, на който работи.

Как се инсталира Ryot с Docker Compose?

Използвайте образа ignisda/ryot и PostgreSQL 18 в compose.yaml. Поставете паролата на базата данни и SERVER_ADMIN_ACCESS_TOKEN във файл .env, задайте FRONTEND_URL на адреса си с https, публикувайте порт 8000 на 127.0.0.1, изпълнете docker compose up -d и поставете пред него обратен прокси с HTTPS.

Какви са данните за вход по подразбиране на Ryot?

Няма такива. Щракнете върху „Create a new account?“ на страницата за вход: първият създаден акаунт става администратор. После задайте USERS_ALLOW_REGISTRATION=false, за да затворите регистрациите; администраторът кани другите потребители от Settings, Users, с връзка за еднократна употреба.

Защо Ryot не намира филми или сериали?

От v9 филмите и сериалите изискват ваш собствен токен от TMDB: създайте безплатен акаунт в TMDB, поискайте API ключ и задайте неговия API Read Access Token в MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN. Видеоигрите изискват приложение в Twitch, а книгите работят без никакъв ключ.

Колко памет е нужна на Ryot?

Малко. На нашия тестов VPS нова инсталация използваше около 240 до 300 MB за Ryot и 70 MB за PostgreSQL, а двата образа заемат около 810 MB на диска.

Как се архивира Ryot?

Направете дъмп на базата данни 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.

Как се обновява Ryot?

Прочетете бележките към версията и направете резервно копие, сменете етикета на образа в compose.yaml, после изпълнете docker compose pull и docker compose up -d. Миграциите на базата данни се изпълняват сами при стартиране. Между основните версии следвайте страницата за миграция.

Покрива ли Managed VPS Ryot?

Managed VPS покрива сървъра: система, сигурност, наблюдение и резервни копия. Нашите екипи следят проактивно и вашата инстанция и ви препоръчват полезните корекции, които прилагате вие. Намеса в самото приложение се фактурира на час или на фиксирана цена.

Източници и официална документация

Свързани ръководства

PostgreSQL на VPS: как да оразмерите паметта и дискаБързата PostgreSQL база е база, чиито често четени данни се побират в паметта. Цялото оразмеряване започва оттук: обемът на базата, делът, който наистина работи, броят на връзките, след това дискът и неговият резерв. Това ръководство дава метода, началните настройки за 4, 8 и 16 GB памет и заявките, които измерват съществуваща база.Резервни копия на VPS: какво да проверите, преди да подпишетеПочти всяко предложение за VPS обявява „включени резервни копия“. Зад тези думи може да стои копие всяка нощ, пазено извън машината и възстановявано от експерти, или моментна снимка, поставена на същия диск като сървъра. Това ръководство дава въпросите, които правят разликата, какво означава всеки отговор и как да проверите, че едно резервно копие наистина се възстановява.Хостване на Actual Budget на Managed VPS: бюджетите ви на ваш сървърХостването на Actual Budget на Managed VPS означава бюджетите ви и тяхната синхронизация да остават на ваша собствена машина, която нашите екипи поддържат актуална и наблюдават денем и нощем. Actual Budget е инструмент за лични финанси, който работи първо локално, разпространяван с лиценз MIT. Това ръководство следва официалната му документация: ролята на сървъра, инсталиране с Docker Compose, HTTPS, паролата на сървъра, OpenID, шифроването от край до край, банковата синхронизация, резервните копия и обновленията.
Свържете се с нас