https://valoryx.org/ru/docs/configuration/ Recent content in Конфигурация on Valoryx Hugo ru https://valoryx.org/ru/docs/configuration/environment/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/ru/docs/configuration/environment/ Переменные окружения DocPlatform читает конфигурацию из переменных окружения. Устанавливайте их в оболочке, файле .env в рабочей директории или в оркестраторе контейнеров. Сервер Переменная По умолчанию Описание PORT 3000 Порт HTTP-сервера HOST 0.0.0.0 Адрес HTTP-сервера. Установите 127.0.0.1 для ограничения доступа только localhost. DATA_DIR .docplatform Корневая директория для всех данных DocPlatform (база данных, резервные копии, workspaces, ключи) BASE_DOMAIN — Пользовательский домен для опубликованной документации (например, docs.yourcompany.com). При установке опубликованная документация использует этот домен для канонических URL и записей sitemap. https://valoryx.org/ru/docs/configuration/authentication/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/ru/docs/configuration/authentication/ Аутентификация DocPlatform поддерживает локальную аутентификацию (email + пароль) сразу после установки, с опциональным входом через Google и GitHub OIDC для команд, использующих этих провайдеров. Локальная аутентификация (по умолчанию) Локальная аутентификация работает без какой-либо настройки. Пользователи регистрируются с email и паролем и входят с теми же учетными данными. Как это работает Регистрация — пользователь отправляет email + пароль. Пароль хешируется с помощью argon2id (рекомендованный OWASP 2024 алгоритм). Вход — пользователь отправляет учетные данные. https://valoryx.org/ru/docs/configuration/permissions/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/ru/docs/configuration/permissions/ Роли и права доступа DocPlatform использует ролевую модель доступа (RBAC) на базе Casbin — авторизационного движка, работающего в рамках процесса. Проверка прав выполняется менее чем за 0.1 мс без обращения к внешним сервисам. Иерархия ролей DocPlatform определяет 5 публичных ролей в строгой иерархии. Более высокие роли наследуют все права более низких. Super Admin ← Full platform access (all workspaces) │ Admin ← Manage workspace settings, git config, theme │ Editor ← Создание и редактирование страниц (настраивается для каждого workspace) │ Commenter ← View pages, leave comments │ Viewer ← View pages only Platform Owner — внутренняя роль для операторов самостоятельно размещённых экземпляров, предназначенная для обслуживания платформы (миграции базы данных, управление лицензиями, конфигурация системы). https://valoryx.org/ru/docs/configuration/workspace-config/ Mon, 01 Jan 0001 00:00:00 +0000 https://valoryx.org/ru/docs/configuration/workspace-config/ Настройки workspace Каждый workspace имеет собственный файл конфигурации по адресу .docplatform/workspaces/{workspace-id}/.docplatform/config.yaml. Редактируйте этот файл напрямую или используйте веб-интерфейс (Settings -> Workspace). Полный справочник конфигурации # Workspace identity workspace_id: 01KJJ10NTF31Z1QJTG4ZRQZ2Z2 # Auto-generated ULID name: "Engineering Docs" # Display name slug: eng-docs # URL slug for published docs description: "Internal engineering documentation" # Git synchronization git_remote: git@github.com:your-org/eng-docs.git git_branch: main git_auto_commit: true # Auto-commit editor saves to git sync_interval: 300 # Polling interval in seconds (0 = disabled) # Theme theme: mode: auto # light, dark, auto (follows system preference) accent: blue # Accent color for published site # Publishing defaults publishing: default_published: false # New pages published by default?