MagosAurex
local wizard
Сообщений: 128
Регистрация: 2005
Регистрация: 2005
Собрал заметки по PagesHub / PagesServer. Ниже шпаргалка по режимам и флагам.
Быстрый старт
pageshub
# проверка
curl -I http://127.0.0.1:12500/
Обычный режим (webhooks)
| Флаг | Назначение | По умолчанию |
|---|---|---|
--port <int> | Порт веб-сервера | 12500 |
--route <string> | Необязательный сабпуть. Сервер обслуживает только запросы, начинающиеся с него. | / |
--sitepath <path> | Путь к каталогу со скачанными сайтами (обязательно) | — |
--sitessub | -ssub | Подпапка внутри sitepath | "" |
--repopath | -repo | Ссылка на репозиторий (обязательно) | — |
--credentials | -gitcred | Github credentials (username:pass) | "Github credentials (username:pass)" |
--workpath <path> | Каталог с конфигом и секретами | ~/.pageshub |
--rotatekeys <bool> | Сменить webhook secret | false |
Примеры
# явный порт и роут
pageshub --port 12500 --route /
# сайты в подпапке
pageshub --sitepath /var/www/static --sitessub docs
# репозиторий + креды
pageshub --repopath https://example.com/u/proj.git --credentials username:pass --workpath ~/.pageshub
# ротация секрета
pageshub --rotatekeys true
Режим pages (скан Forgejo)
| Флаг | Назначение | По умолчанию |
|---|---|---|
--url <string> | required. Базовый URL Forgejo | — |
--sites <path> | required. Каталог для статических сайтов | — |
--workpath <path> | Рабочая директория | ~/.pageshub |
--route <string> | Сабпуть | / |
--port <int> | Порт | 12500 |
pageshub pages --url https://forgejo.example.com --sites /srv/pages \
--workpath ~/.pageshub --route /public --port 12500
Если сервер за прокси — убедитесь, что
--route совпадает с префиксом прокси.
TL;DR для запуска: в обычном режиме передайте
В режиме
--sitepath и --repopath.В режиме
pages — --sites и --url. Остальное — по ситуации.
