NocoDB на VPS: своя база данных как Excel — без Airtable

1. Что такое NocoDB и зачем он нужен

Представьте Excel, в котором можно переключаться между таблицей, Kanban-доской, галереей, формой и календарём — и всё это над одними и теми же данными. Добавьте автоматически сгенерированный REST API, связи между таблицами и управление правами доступа. Вот что такое NocoDB.

Такой инструмент уже существует — это Airtable. Он отличный, но дорогой: бесплатный план ограничен 1 000 строк, а командный стоит от $20 с человека в месяц. Команда из пяти человек — $100/мес только за базу данных. NocoDB делает то же самое, только бесплатно и на вашем сервере.

Для чего реально используют NocoDB:

2. Требования к серверу

NocoDB запускает два контейнера: само приложение на Node.js (~200–300 МБ) и PostgreSQL (~100–200 МБ). На 1 ГБ RAM всё умещается. Если на сервере уже работают другие сервисы — берите 2 ГБ.

3. Установка через Docker Compose

Мы запустим NocoDB с PostgreSQL в качестве хранилища. Это важно: без явного указания базы NocoDB использует SQLite — встроенный файл внутри контейнера. SQLite работает, но ненадёжен для продакшена: данные теряются при пересоздании контейнера, нет нормального бэкапа, плохо справляется с параллельными запросами. С PostgreSQL всё надёжно.

Шаг 1: установка Docker

Если Docker ещё не установлен:

curl -fsSL https://get.docker.com | sh

Шаг 2: директория проекта

mkdir -p /opt/nocodb && cd /opt/nocodb

Шаг 3: JWT-секрет

NocoDB использует JWT-токены для аутентификации сессий. Если не задать секрет явно, он генерируется случайно при каждом старте контейнера — и все пользователи будут разлогинены при каждом перезапуске. Сгенерируйте постоянный секрет:

openssl rand -hex 32

Шаг 4: файл .env

Создайте файл с настройками. Замените выделенные значения на свои:

# Публичный URL (с вашим доменом)
NC_PUBLIC_URL=https://nocodb.ваш-домен.ru

# JWT-секрет — ВСТАВЬТЕ РЕЗУЛЬТАТ openssl rand -hex 32
NC_AUTH_JWT_SECRET=вставьте_сюда_сгенерированный_секрет

# Пароль PostgreSQL — задаётся здесь и используется в NC_DB ниже
POSTGRES_PASSWORD=StrongPass123

# Подключение к PostgreSQL (формат специфичный для NocoDB!)
NC_DB=pg://db:5432?u=nocodb&p=StrongPass123&d=nocodb

# Отключить анонимную телеметрию
NC_DISABLE_TELE=true

# Суперадмин — задайте сразу, чтобы не было лишнего экрана при первом входе
# (пароль: мин. 8 символов, заглавная буква, цифра, спецсимвол)
# NC_ADMIN_EMAIL=admin@ваш-домен.ru
# NC_ADMIN_PASSWORD=Sup3rS3cr3t!

Шаг 5: docker-compose.yml

services:
  nocodb:
    image: nocodb/nocodb:latest
    depends_on:
      db:
        condition: service_healthy
    env_file: .env
    ports:
      - "127.0.0.1:8080:8080"
    restart: unless-stopped
    volumes:
      - nc_data:/usr/app/data

  db:
    image: postgres:16-alpine
    environment:
      POSTGRES_DB: nocodb
      POSTGRES_USER: nocodb
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U nocodb -d nocodb"]
      interval: 10s
      timeout: 5s
      retries: 10
    restart: unless-stopped
    volumes:
      - db_data:/var/lib/postgresql/data

volumes:
  nc_data:
  db_data:

Шаг 6: запуск

cd /opt/nocodb
docker compose up -d

Первый запуск занимает около минуты — NocoDB ждёт, пока PostgreSQL пройдёт healthcheck, затем запускается сам и создаёт схему базы. Проверьте статус:

docker compose ps

Оба сервиса должны быть в статусе Up. Если nocodb упал — смотрите логи: docker compose logs nocodb. Самая частая причина — ошибка в строке NC_DB в .env.

4. Nginx и SSL

NocoDB готов на порту 8080. Теперь настроим Nginx, чтобы он был доступен по нормальному домену с HTTPS.

DNS-запись

Добавьте A-запись у своего регистратора:

nocodb.ваш-домен.ru  →  A  →  IP_ВАШЕГО_VPS

Конфиг Nginx

nano /etc/nginx/sites-available/nocodb

server {
    listen 80;
    server_name nocodb.ваш-домен.ru;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    server_name nocodb.ваш-домен.ru;

    ssl_certificate     /etc/letsencrypt/live/nocodb.ваш-домен.ru/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/nocodb.ваш-домен.ru/privkey.pem;
    ssl_protocols       TLSv1.2 TLSv1.3;

    # Для загрузки файлов-вложений
    client_max_body_size 50m;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        # Для WebSocket (используется в реальном времени)
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

ln -s /etc/nginx/sites-available/nocodb /etc/nginx/sites-enabled/
nginx -t

ufw allow 80/tcp
ufw allow 443/tcp
ufw reload

# Установить certbot, если ещё не установлен
apt install -y certbot python3-certbot-nginx

certbot --nginx -d nocodb.ваш-домен.ru

systemctl reload nginx

Теперь NocoDB доступен по адресу https://nocodb.ваш-домен.ru.

5. Первый вход и создание базы

Откройте NocoDB в браузере. Если вы не задали NC_ADMIN_EMAIL в .env, первый экран — форма регистрации суперадмина. Это единственный аккаунт с полным доступом ко всему.

6. Представления: Grid, Gallery, Form, Kanban, Calendar

Одни и те же данные — пять способов их показать. Представление (view) не копирует данные: таблица одна, а вот фильтры, сортировки и скрытые поля у каждого представления свои. Создавайте сколько угодно представлений для одной таблицы.

Чтобы создать новое представление: в левой панели под названием таблицы нажмите + Add View — выберите тип. У каждого представления свои настройки фильтрации, сортировки и видимых полей. Одно представление не влияет на другое.

7. REST API — автоматически для каждой таблицы

Каждая таблица в NocoDB автоматически получает полноценный REST API. Это значит: фронтенд на React, мобильное приложение, Python-скрипт или n8n-автоматизация могут читать и писать данные через HTTP-запросы — без отдельного бэкенда.

Swagger — интерактивная документация

NocoDB автоматически генерирует Swagger UI для вашего API. Откройте в браузере:

https://nocodb.ваш-домен.ru/api/swagger

Там вы увидите все доступные методы: получить список строк, создать, обновить, удалить. Прямо в Swagger можно попробовать запросы без написания кода.

Как получить API-токен

Перейдите в Team & Settings → API Tokens → + Add new token. Дайте токену название и скопируйте его — он показывается только один раз.

Примеры запросов

Получить все строки таблицы:

curl "https://nocodb.ваш-домен.ru/api/v1/db/data/noco/PROJECT_ID/TABLE_ID" \
  -H "xc-token: ВАШ_ТОКЕН"

Создать новую строку:

curl -X POST "https://nocodb.ваш-домен.ru/api/v1/db/data/noco/PROJECT_ID/TABLE_ID" \
  -H "xc-token: ВАШ_ТОКЕН" \
  -H "Content-Type: application/json" \
  -d '{"Title": "Новая запись", "Status": "Активен"}'

8. Шаринг и совместная работа

NocoDB поддерживает два уровня совместного доступа: добавление коллег в базу как участников и публичный шаринг отдельных представлений по ссылке.

Роли участников

Чтобы пригласить коллегу: Base Settings → Collaborators → + Invite. Введите email и выберите роль. Если SMTP не настроен — скопируйте ссылку-приглашение и отправьте вручную через мессенджер.

Публичная ссылка на представление

Любое представление можно сделать публичным — тогда его видит любой по ссылке, без входа в систему. Можно также защитить ссылку паролем.

9. Импорт из CSV и Excel

Если у вас уже есть данные в Excel или CSV — не нужно вводить их вручную. NocoDB импортирует файл и создаёт таблицу автоматически, определяя типы полей.

Данные можно экспортировать обратно в CSV или Excel в любой момент: нажмите ... рядом с названием таблицы → Download → CSV / Excel.

10. Обновление и бэкап

Бэкап перед обновлением

При обновлении между версиями NocoDB автоматически выполняет миграции схемы. Обычно всё проходит гладко, но иногда при больших прыжках в версии могут быть проблемы. Сделайте дамп базы на всякий случай:

cd /opt/nocodb
docker compose exec db pg_dump -U nocodb nocodb > backup-$(date +%Y%m%d-%H%M).sql

Обновление NocoDB

cd /opt/nocodb
docker compose pull nocodb
docker compose up -d nocodb

NocoDB пересоздаётся, данные в PostgreSQL volume остаются. После запуска откройте интерфейс и убедитесь, что всё работает.

Восстановление из бэкапа

# Остановить NocoDB
docker compose stop nocodb

# Восстановить базу
docker compose exec -T db psql -U nocodb nocodb < backup-20260308-1200.sql

# Запустить NocoDB обратно
docker compose start nocodb

11. Частые проблемы

docker compose logs nocodb --tail=50

# Добавить в /opt/nocodb/.env:
# NC_AUTH_JWT_SECRET=$(openssl rand -hex 32)
# (скопируйте вывод команды и вставьте вручную)

docker compose up -d nocodb

docker compose up -d nocodb

12. Частые вопросы