Переменные окружения
Настройте проект через переменные окружения, чтобы включить все необходимые сторонние сервисы
Обзор системы переменных окружения
GolOps поддерживает два способа настройки переменных окружения:
- Через файлы переменных окружения - для значений, которые меняются редко, например URL базы данных или секреты аутентификации.
- Через панель конфигурации в админке - для значений, которые меняются часто. GolOps предоставляет динамическую панель, где можно в любой момент менять такие параметры, как ключи платежей и настройки почтового сервера.
Настройка через файлы переменных окружения
Конфигурация URL сайта
| Переменная | Описание |
|---|---|
| VITE_APP_URL | URL сайта |
База данных
Смотрите документацию по настройке базы данных для более подробных инструкций.
| Переменная | Описание |
|---|---|
| DATABASE_URL | URL подключения к базе данных |
Аутентификация
Смотрите документацию по настройке аутентификации для более подробных инструкций.
| Переменная | Описание |
|---|---|
| ADMIN_EMAILS | Email-адреса администраторов |
| BETTER_AUTH_SECRET | Секретный ключ аутентификации |
| BETTER_AUTH_URL | URL аутентификации |
BETTER_AUTH_SECRET можно сгенерировать на сайте better-auth или нажать кнопку ниже:
Если вы хотите использовать OAuth (вход через GitHub или Google), настройте следующие переменные:
| Переменная | Описание |
|---|---|
| GITHUB_CLIENT_ID | ID клиента GitHub OAuth |
| GITHUB_CLIENT_SECRET | Секрет клиента GitHub OAuth |
| GOOGLE_CLIENT_ID | ID клиента Google OAuth |
| GOOGLE_CLIENT_SECRET | Секрет клиента Google OAuth |
TURNSTILE
GolOps использует TURNSTILE как сервис капчи для защиты сайта. Вам нужно зарегистрировать аккаунт на сайте TURNSTILE и создать сайт, чтобы получить site key. Более подробная инструкция есть в документации по капче.
| Переменная | Описание |
|---|---|
| TURNSTILE_SECRET_KEY | Секретный ключ TURNSTILE, его можно сгенерировать в Cloudflare Dashboard |
| VITE_TURNSTILE_SITE_KEY | Site key TURNSTILE, его можно получить в Cloudflare Dashboard |
| VITE_TURNSTILE_CAPTCHA_ENABLED | Включает капчу TURNSTILE, true - включить, false - выключить |
Почта
Вы можете использовать сервис Resend или собственный почтовый сервер. GolOps рекомендует Resend. Подробнее см. в документации по настройке почты.
Проверка email по умолчанию отключена. Настройте почтового провайдера, чтобы пользователи могли подтверждать аккаунт:
EMAIL_VERIFICATION_ENABLED=falseДля Resend нужно создать API-ключ на Resend.
| Переменная | Описание |
|---|---|
| EMAIL_PROVIDER | Почтовый провайдер, resend или custom |
| EMAIL_FROM | Email отправителя, например: GolOps <noreply@auth.vibeany.dev> |
| RESEND_API_KEY | API-ключ Resend |
Для собственного почтового сервера настройте следующие переменные. Подробности смотрите в документации вашего провайдера:
| Переменная | Описание |
|---|---|
| EMAIL_HOST | Хост почтового сервера |
| EMAIL_ADDRESS | Email отправителя |
| EMAIL_USER | Имя пользователя отправителя |
| EMAIL_PASSWORD | Пароль отправителя |
Платежи
Смотрите документацию по настройке платежей для более подробных инструкций.
Stripe
| Переменная | Описание |
|---|---|
| VITE_STRIPE_PUBLISHABLE_KEY | Publishable key Stripe |
| STRIPE_SECRET_KEY | API secret key Stripe |
| STRIPE_WEBHOOK_SECRET | Webhook secret Stripe |
| VITE_STRIPE_PRO_MONTHLY_PRICE_ID | ID ежемесячной цены Stripe Pro |
| VITE_STRIPE_PRO_YEARLY_PRICE_ID | ID годовой цены Stripe Pro |
| VITE_STRIPE_LIFETIME_PRICE_ID | ID пожизненной цены Stripe |
Creem
| Переменная | Описание |
|---|---|
| CREEM_X_API_KEY | API-ключ Creem |
| CREEM_TEST_MODE | Тестовый режим Creem, true - включить, false - выключить |
| CREEM_WEBHOOK_SECRET | Webhook secret Creem |
| VITE_CREEM_PRO_MONTHLY_PRODUCT_ID | ID ежемесячного продукта Creem Pro |
| VITE_CREEM_LIFETIME_PRODUCT_ID | ID пожизненного продукта Creem |
Кредиты
Чтобы упростить настройку для разработчиков, GolOps интегрирует систему кредитов прямо в админку. Вы можете в любой момент менять конфигурацию кредитов в панели администрирования, например количество кредитов и срок их действия. Подробнее - в документации по кредитам.
Хранилище
Смотрите документацию по настройке хранилища для более подробных инструкций.
| Переменная | Описание |
|---|---|
| STORAGE_PROVIDER | Провайдер хранилища, s3 или custom |
| S3_ACCESS_KEY | Access key S3 |
| S3_SECRET_KEY | Secret key S3 |
| S3_REGION | Region S3 |
| S3_BUCKET | Bucket S3 |
Настройка через админ-панель
GolOps предоставляет динамическую панель конфигурации, где можно менять следующие параметры без перезапуска сервиса.
Приоритет
Конфигурация из файлов переменных окружения имеет более высокий приоритет, чем
настройки в админке: - Серверная конфигурация: если в .env задано
STRIPE_SECRET_KEY=sk_xxx, значение payment_stripe_secret_key в админке
будет проигнорировано - Клиентская конфигурация (префикс public_): если в
.env задано VITE_CREDIT_ENABLE=true, значение public_credit_enable в
админке будет проигнорировано
Платежи
В админке можно выбрать провайдера платежей: stripe, creem, paypal, wechat, alipay
Stripe
| Параметр | Переменная окружения |
|---|---|
| Stripe Secret Key | STRIPE_SECRET_KEY |
| Stripe Webhook Secret | STRIPE_WEBHOOK_SECRET |
Creem
| Параметр | Переменная окружения |
|---|---|
| Creem X API Key | CREEM_X_API_KEY |
| Creem Test Mode | CREEM_TEST_MODE |
| Creem Webhook Secret | CREEM_WEBHOOK_SECRET |
PayPal
| Параметр | Переменная окружения |
|---|---|
| PayPal Client ID | PAYPAL_CLIENT_ID |
| PayPal Client Secret | PAYPAL_CLIENT_SECRET |
| PayPal Webhook ID | PAYPAL_WEBHOOK_ID |
| PayPal Sandbox Mode | PAYPAL_SANDBOX |
WeChat Pay
| Параметр | Переменная окружения |
|---|---|
| WeChat App ID | WECHAT_APP_ID |
| WeChat Merchant ID | WECHAT_MCH_ID |
| WeChat API Key | WECHAT_API_KEY |
| WeChat API v3 Key | WECHAT_API_V3_KEY |
| WeChat Certificate Serial No | WECHAT_SERIAL_NO |
| WeChat Private Key | WECHAT_PRIVATE_KEY |
Alipay
| Параметр | Переменная окружения |
|---|---|
| Alipay App ID | ALIPAY_APP_ID |
| Alipay App Private Key | ALIPAY_PRIVATE_KEY |
| Alipay Public Key | ALIPAY_PUBLIC_KEY |
| Alipay Sandbox Mode | ALIPAY_SANDBOX |
Кредиты
Базовая конфигурация
| Параметр | Переменная окружения | Значение по умолчанию |
|---|---|---|
| Включить систему кредитов | VITE_CREDIT_ENABLE | false |
| Разрешить бесплатным пользователям покупать | VITE_CREDIT_ALLOW_FREE_USER_PURCHASE | false |
Бонус за регистрацию
| Параметр | Переменная окружения | Значение по умолчанию |
|---|---|---|
| Включить бонус за регистрацию | VITE_CREDIT_SIGNUP_BONUS_ENABLED | false |
| Размер бонуса за регистрацию | VITE_CREDIT_SIGNUP_BONUS_AMOUNT | 0 |
| Срок действия бонуса (дней) | VITE_CREDIT_SIGNUP_BONUS_EXPIRE_DAYS | 30 |
Ежедневный бонус
| Параметр | Переменная окружения | Значение по умолчанию |
|---|---|---|
| Включить ежедневный бонус | VITE_CREDIT_DAILY_ENABLED | false |
| Размер ежедневного бонуса | VITE_CREDIT_DAILY_AMOUNT | 0 |
Почта
| Параметр | Переменная окружения | Значение по умолчанию |
|---|---|---|
| Почтовый провайдер | EMAIL_PROVIDER | resend |
| Email отправителя | EMAIL_FROM | - |
| API Key Resend | RESEND_API_KEY | - |
Хранилище
GolOps поддерживает S3-совместимые сервисы хранения, например AWS S3, Cloudflare R2 и MinIO.
| Параметр | Переменная окружения | Значение по умолчанию |
|---|---|---|
| Регион хранилища | STORAGE_REGION | auto |
| Имя bucket | STORAGE_BUCKET_NAME | - |
| Access Key ID | STORAGE_ACCESS_KEY_ID | - |
| Secret Access Key | STORAGE_SECRET_ACCESS_KEY | - |
| Endpoint хранилища | STORAGE_ENDPOINT | - |
| Публичный URL доступа | STORAGE_PUBLIC_URL | - |