Files
pgames-manager/docs/F95.md
T
mrleo1nid ad622389bd
CI / frontend (push) Failing after 17s
CI / backend (push) Failing after 34s
fix: simplify F95 cookie setup and constrain auth dialog layout
2026-10-26 15:58:40 +03:00

55 lines
5.6 KiB
Markdown

# Импорт данных и обложек F95zone
Кнопка «Подтянуть» в формах создания и редактирования игры загружает название,
описание, теги и превью. Изображение сохраняется на сервере в WebP; обложка игры
меняется только после сохранения формы. Перед сохранением превью можно убрать.
Cookie привязаны к текущему пользователю приложения. Если они отсутствуют,
истекли или F95zone запросил вход, открывается окно авторизации с возможностью
отказаться. Уже полученные название, описание и теги остаются в форме.
При отказе автоматических повторов нет; можно заполнить данные вручную.
Чтобы добавить сессию:
1. Войдите в свой аккаунт F95zone в браузере и откройте тему игры.
2. Нажмите F12 → «Приложение» (Application) → «Хранилище» → «Файлы cookie» →
`https://f95zone.to`.
3. Выберите строку `xf_user` и скопируйте только содержимое колонки «Значение»
в одноимённое поле окна авторизации. Если копируете из нижней панели Cookie Value,
отключите «Показать декодированные параметры URL». При необходимости добавьте
`xf_session` таким же способом. Имена cookie, домен, путь и срок действия копировать не нужно.
4. Нажмите «Сохранить и повторить». Импорт повторится с вашими cookie.
`xf_user` — токен «запомнить меня», `xf_session` — идентификатор текущей сессии.
В XenForo вход может подтверждаться одним из них; начните с `xf_user`, либо используйте
`xf_session`, если `xf_user` отсутствует. Это не гарантирует доступ через защиту F95zone.
См. [пояснение разработчика XenForo](https://xenforo.com/community/threads/authentication-from-a-node-application.189858/).
`xf_csrf` и `TSVB_UID` для этого импорта не запрашиваются.
Если сайт блокирует запрос, откройте «Если F95zone блокирует запрос» и добавьте
`cf_clearance` из той же таблицы. Необязательный User-Agent находится в Network →
запрос страницы темы → Request Headers → User-Agent.
`cf_clearance` привязан к посетителю и устройству; перенос cookie из браузера на сервер
может не сработать ([документация Cloudflare](https://developers.cloudflare.com/cloudflare-challenges/concepts/clearance/)).
Cookie используется для запроса темы и скачивания картинки. Сессия хранится
зашифрованной в записи вашего пользователя; другие пользователи её не используют.
Значения не возвращаются через API и не сохраняются в localStorage.
Кнопка «Забыть cookie F95zone» удаляет вашу сессию. При повторном отказе в доступе
сохранённая сессия сбрасывается и окно предлагает ввести новые cookie либо отказаться.
Успешный доступ к F95zone зависит также от защиты сайта; ответ 403 может означать
блокировку автоматических запросов, а не только истёкшую сессию.
После обновления приложения примените миграции до `0005` обычным способом
(Docker-образ применяет их при запуске backend). Установите обновлённые зависимости
backend. Шифрование использует `SECRET_KEY`; при смене ключа пользователям
потребуется заново добавить cookie. Общие `F95_COOKIE` и `F95_USER_AGENT` из `.env`
больше не используются; перезапуск сервера для изменения личной сессии не требуется.
Импорт выбирает `og:image`, а при его отсутствии — первую доступную `bbImage`
из первого сообщения вне скрытых блоков. Поддерживаются изображения на
`f95zone.to` и его поддоменах; внешние хостинги пропускаются. Скачивание ограничено
20 МиБ, переходы за пределы F95zone блокируются до отправки cookie.
Если изображение скачать не удалось, текстовые данные импортируются с сообщением
об ошибке превью; текущая обложка игры сохраняется.