Отладка проблем с подключением

При запуске Baserow, если вы столкнулись с сообщением "Обнаружена неправильная конфигурация URL-адреса бэкенда" или у вас возникли проблемы с подключением к серверу Baserow, этот учебник объяснит, почему может возникнуть эта ошибка и как её исправить.

Возможная причина ошибки

Baserow должен знать имя хоста, где он размещён, по нескольким практическим и вопросам безопасности. Он не может безопасно автоматически определить это имя хоста и вместо этого полагается на правильное его установление вами. В установках с использованием Docker и Docker Compose по умолчанию используется http://localhost. Если вы затем пытаетесь получить доступ к Baserow с другого компьютера, ваш браузер всё ещё будет настроен на поиск Baserow по адресу http://localhost, который не существует на другом компьютере, что обычно является причиной этой ошибки.

Исправление установки Docker

Убедитесь, что вы установили переменную окружения BASEROW_PUBLIC_URL на URL-адрес, который вы используете для доступа к Baserow. Следующие три раздела показывают, как это сделать в зависимости от того, как вы получаете доступ к вашему серверу Baserow.

Доступ через доменное имя

Если вы получаете доступ к вашему серверу Baserow через доменное имя, запустите Baserow следующим образом:

docker run \
  -e BASEROW_PUBLIC_URL=https://YOUR_DOMAIN_HERE \
  # ... за которыми следуют остальные аргументы вашего обычного docker-запуска Baserow

Доступ через доменное имя с автоматическим HTTPS

Если вы получаете доступ к вашему серверу Baserow через доменное имя и хотите, чтобы сервер Caddy Baserow автоматически обрабатывал HTTPS для вас, запустите Baserow следующим образом. Если вы всё ещё хотите иметь возможность получить доступ к вашему Baserow по http://localhost, добавьте ,http://localhost в BASEROW_CADDY_ADDRESSES.

docker run \
  -e BASEROW_PUBLIC_URL=https://YOUR_DOMAIN_HERE \
  -e BASEROW_CADDY_ADDRESSES=https://YOUR_DOMAIN_HERE \
  # ... за которыми следуют остальные аргументы вашего обычного docker-запуска Baserow

Доступ через IP-адрес

Если вы получаете доступ к вашему серверу Baserow через IP-адрес, запустите Baserow следующим образом:

docker run \
  -e BASEROW_PUBLIC_URL=http://YOUR_IP_ADDRESS_HERE \
  # ... за которыми следуют остальные аргументы вашего обычного docker-запуска Baserow

Доступ через нестандартный порт

Если вы хотите получить доступ к Baserow через другой порт, отличный от 80 (-p 80:80), вам также нужно установить переменную окружения WEB_FRONTEND_PORT. Вам также нужно правильно изменить аргумент -p 80:80 на -p YOUR_CUSTOM_PORT:80 и обновить BASEROW_PUBLIC_URL, добавив порт в конце.

Пожалуйста, обратите внимание, что порты 3000, 5432, 1085 и 8000 уже заняты внутри контейнера Docker, поэтому выберите другой порт для YOUR_CUSTOM_PORT. Это связано с тем, что встроенный обратный прокси Caddy слушает соединения по $BASEROW_PUBLIC_URL, и добавление порта к этому адресу также заставит Caddy внутри контейнера слушать этот порт.

docker run \
  -e BASEROW_PUBLIC_URL=https://YOUR_IP_OR_DOMAIN_HERE:YOUR_CUSTOM_PORT \
  -e WEB_FRONTEND_PORT=YOUR_CUSTOM_PORT \
  -p YOUR_CUSTOM_PORT:80 \
  # ... за которыми следуют остальные аргументы вашего обычного docker-запуска Baserow

Исправление установки Docker Compose

Убедитесь, что вы установили переменную окружения BASEROW_PUBLIC_URL на URL-адрес, который вы используете для доступа к Baserow. См. руководство по установке с использованием Docker Compose, чтобы узнать различные способы установки этой переменной с помощью Docker Compose.

Следующие три раздела показывают, как это сделать в зависимости от того, как вы получаете доступ к вашему серверу Baserow. Пожалуйста, не забудьте также включить любые дополнительные переменные окружения и аргументы, объяснённые в вышеупомянутом руководстве.

Доступ через доменное имя

Если вы получаете доступ к вашему серверу Baserow через доменное имя, запустите Baserow следующим образом:

BASEROW_PUBLIC_URL=https://YOUR_DOMAIN_HERE docker-compose up -d

Доступ через доменное имя с автоматическим HTTPS

Если вы получаете доступ к вашему серверу Baserow через доменное имя и хотите, чтобы сервер Caddy Baserow автоматически обрабатывал HTTPS для вас, запустите Baserow следующим образом. Если вы всё ещё хотите иметь возможность получить доступ к вашему Baserow по http://localhost, добавьте ,http://localhost в BASEROW_CADDY_ADDRESSES.

BASEROW_PUBLIC_URL=https://YOUR_DOMAIN_HERE \
BASEROW_CADDY_ADDRESSES=https://YOUR_DOMAIN_HERE \
docker-compose up -d

Доступ через IP-адрес

Если вы получаете доступ к вашему серверу Baserow через IP-адрес, запустите Baserow следующим образом:

BASEROW_PUBLIC_URL=https://YOUR_IP_HERE docker-compose up -d

Доступ через нестандартный порт

Если вы хотите получить доступ к Baserow через другой порт, отличный от 80, вам также нужно установить переменную окружения WEB_FRONTEND_PORT.

BASEROW_PUBLIC_URL=https://YOUR_IP_OR_DOMAIN_HERE:YOUR_CUSTOM_PORT \
WEB_FRONTEND_PORT=YOUR_CUSTOM_PORT \
docker-compose up -d

Исправление установки с использованием отдельных образов сервисов Baserow

Baserow также предоставляет образы baserow/backend и baserow/web-frontend для пользователей, которые хотят самостоятельно размещать и координировать различные сервисы Baserow. При использовании этих образов вам нужно установить следующие переменные окружения во всех контейнерах, запускающих эти образы. Пожалуйста, обратите внимание, что переменная окружения BASEROW_PUBLIC_URL не используется этими отдельными образами.

• PUBLIC_BACKEND_URL (по умолчанию http://localhost:8000): Общедоступный URL-адрес бэкенда. Должен включать порт, если он нестандартный.
• PRIVATE_BACKEND_URL (по умолчанию http://backend:8000): Не только браузер, но и сервер веб-фронтенда должны иметь возможность отправлять HTTP-запросы на бэкенд. Возможно, у них нет доступа к PUBLIC_BACKEND_URL или есть более прямой маршрут (например, из контейнера в контейнер вместо интернета). В случае среды разработки контейнер бэкенда можно доступен по имени хоста backend, и поскольку сервер также работает на порту 8000 внутри контейнера, приватный URL-адрес бэкенда должен быть http://backend:8000.
• PUBLIC_WEB_FRONTEND_URL (по умолчанию http://localhost:3000): Общедоступный URL-адрес веб-фронтенда. Должен включать порт, если он нестандартный.

Дополнительная помощь

Пожалуйста, опубликуйте сообщение на форуме сообщества, если у вас возникнут дополнительные проблемы или вы используете другой метод установки.