Подключение к серверу Dolt

1. Запустите сервер Dolt

cd ~/Projects/myproject
dolt sql-server

По умолчанию Dolt слушает порт 3307.

2. Откройте Beadbox

В окне выбора воркспейса нажмите Добавить по серверу (или найдите карточку Дополнительно на экране приветствия при первом запуске).

3. Введите параметры подключения

4. Нажмите "Обнаружить базы данных"

Beadbox подключается к серверу и выполняет SHOW DATABASES для поиска всех баз данных, соответствующих шаблону beads_*.

5. Выберите базы данных

На экране обнаружения перечислены все найденные базы данных beads на сервере. Отметьте те, которые хотите добавить как воркспейсы. Для каждой назначается локальный путь к каталогу.

6. Нажмите "Добавить воркспейсы"

Beadbox создаёт локальный каталог .beads/ с файлом metadata.json, указывающим на ваш сервер, регистрирует воркспейс и открывает его.

1. Записывает метаданные подключения

Создаёт файл .beads/metadata.json в локальном каталоге проекта с деталями подключения к серверу:

{
  "dolt_mode": "server",
  "dolt_server_host": "127.0.0.1",
  "dolt_server_port": 3307,
  "dolt_database": "beads_myproject",
  "dolt_server_user": "root",
  "database": "dolt"
}

При включённом TLS добавляется ключ "dolt_server_tls": true. Этот файл указывает bd подключаться к удалённому серверу вместо использования локальной встроенной базы данных. Пароль намеренно отсутствует в этом файле.

2. Регистрирует воркспейс

Локальный каталог добавляется в ~/.beads/registry.json, чтобы Beadbox и bd могли найти его при следующих запусках.

3. Передаёт учётные данные во время выполнения

Каждый раз, когда Beadbox вызывает команду bd для этого воркспейса, он устанавливает BEADS_DOLT_PASSWORD в окружении подпроцесса. Пароль существует только в памяти процесса.

Отказано в подключении

Error: connect ECONNREFUSED 127.0.0.1:3307

• Dolt запущен? Проверьте с помощью ps aux | grep dolt или попробуйте dolt sql-server в каталоге проекта.
• Правильный порт? По умолчанию Dolt использует 3307, но вы могли настроить другой порт.
• Файрвол? На удалённых серверах убедитесь, что порт открыт для входящих подключений.

Доступ запрещён

Error: Access denied for user 'root'

• Требуется пароль? На вашем сервере Dolt может быть включена аутентификация. Введите пароль в форме подключения.
• Неправильный пользователь? Убедитесь, что имя пользователя соответствует пользователю Dolt с правами на чтение.
• Неправильный пароль? Пароли не сохраняются между сессиями. Введите его повторно после перезапуска Beadbox.

Ошибка TLS-рукопожатия

Error: TLS handshake failed

• Несовпадение флажка TLS. Если сервер требует TLS, отметьте "Использовать TLS". Если он не поддерживает TLS, снимите флажок. Неправильная настройка в любом направлении вызывает ошибку рукопожатия.
• Самоподписанные сертификаты. Если ваш сервер Dolt использует самоподписанный сертификат, возможно, потребуется добавить центр сертификации в системное хранилище доверия. bd CLI использует системный пул корневых сертификатов и отклоняет недоверенные сертификаты.

Базы данных не найдены

No beads databases found on 127.0.0.1:3307.
Databases must follow the beads_* naming pattern.

• Соглашение об именовании. Beadbox обнаруживает только базы данных, имена которых начинаются с beads_. Если ваша база данных названа иначе, переименуйте её или создайте новую с помощью bd init в режиме Dolt.
• База данных существует, но не видна? У учётной записи пользователя может не быть разрешения видеть все базы данных.
• Свежий сервер? Если вы только что запустили Dolt без инициализации beads, баз данных beads ещё нет. Выполните bd init в каталоге проекта с настроенным режимом Dolt, затем повторите обнаружение.