Product SiteDocumentation Site

13.3. Основные команды Forgejo

Команды управления сервером Forgejo необходимо выполнять от имени системного пользователя forgejo, например:
# su - forgejo
При выполнении команд вне рабочего каталога Forgejo необходимо явно указывать путь к файлу конфигурации:
-c /etc/forgejo/app.ini
Перед выполнением административных операций рекомендуется остановить службу Forgejo:
# systemctl stop forgejo
После завершения операций службу необходимо запустить повторно:
# systemctl start forgejo

Таблица 13.1. Управление пользователями и доступом

Действие
Команда
Создание администратора
forgejo admin user create -c /etc/forgejo/app.ini --username ivanov --password 'Pass123' --email ivanov@test.alt --admin
Создание обычного пользователя
forgejo admin user create --username user1 --password 'Pass123' --email user1@test.alt
Смена пароля пользователя
forgejo admin user change-password --username user1 --password 'NewPass456'
Список пользователей
forgejo admin user list -c /etc/forgejo/app.ini
Удаление пользователя
forgejo admin user delete --username user1

Таблица 13.2. Резервное копирование и обслуживание

Действие
Команда
Примечание
Создание полной резервной копии (дампа)
forgejo dump -c /etc/forgejo/app.ini --file /tmp/forgejo-backup.zip
Создает архив с базой данных, репозиториями Git, LFS-объектами, вложениями, аватарами и другими данными Forgejo
Экспорт отдельного репозитория
forgejo dump-repo
Создает резервную копию отдельного репозитория
Восстановление репозитория
forgejo restore-repo
Восстанавливает репозиторий из ранее созданного дампа
Генерация секретных ключей
forgejo generate secret INTERNAL_TOKEN
Генерирует случайную строку для вставки в app.ini (также поддерживает SECRET_KEY, LFS_JWT_SECRET)
Выполнение миграций базы данных
forgejo migrate -c /etc/forgejo/app.ini
Выполняет незавершенные миграции схемы базы данных
Очистка очередей задач
forgejo manager flush-queues
Принудительно очищает внутренние очереди фоновых задач
Проверка состояния системы
forgejo doctor -c /etc/forgejo/app.ini
Выполняет диагностику конфигурации, базы данных и файловой структуры
Индексация репозиториев
forgejo admin repo-sync-releases
Обновляет внутренние данные репозиториев (например, после ручного изменения файлов)