Установка Kanboard на Debian 10 — пошаговая инструкция

Kanboard — бесплатный, с открытым исходным кодом и самохостящийся инструмент управления проектами по методологии Kanban. Через веб-интерфейс вы визуализируете рабочий процесс, ограничиваете количество задач в работе и настраиваете доски под свои нужды. Функциональность расширяется плагинами и внешними сервисами.

Ниже — пошаговый гид по установке и настройке Kanboard на Debian 10.

Требования

• Сервер с Debian 10.
• Настроен пароль root или доступ через sudo.
• Домен (рекомендуется) или публичный IP для доступа к веб-интерфейсу.

Важно: используйте защищённое окружение (внутренняя сеть или VPN) для начальной настройки и смены пароля администратора до открытия сервиса в интернет.

Шаг 0 — обновление системы

Рекомендуется сначала обновить пакеты до актуальной версии:

apt-get update -y  
 apt-get upgrade -y

После обновления перезагрузите систему, чтобы применить все обновления и новые версии ядер/сервисов.

Установка LEMP (Nginx, MariaDB, PHP)

Kanboard написан на PHP и может использовать MariaDB в качестве бэкенда. Установите Nginx, MariaDB, PHP 7.3 и необходимые модули:

apt-get install nginx mariadb-server php7.3 php7.3-common php7.3-cli php7.3-fpm php7.3-mbstring php7.3-json php7.3-opcache php7.3-zip php7.3-xml php7.3-gd php7.3-ldap php7.3-mysql php7.3-json php7.3-sqlite3

После установки запустите и включите автозапуск Nginx и MariaDB:

systemctl start nginx  
 systemctl start mariadb  
 systemctl enable nginx  
 systemctl enable mariadb

Настройка MariaDB для Kanboard

MariaDB по умолчанию требует базовой защиты. Запустите скрипт безопасности:

mysql_secure_installation

Отвечайте на вопросы безопасно. Пример ответов (в вашем случае возможны отличия):

    Enter current password for root (enter for none):
    Set root password? [Y/n]: N
    Remove anonymous users? [Y/n]: Y
    Disallow root login remotely? [Y/n]: Y
    Remove test database and access to it? [Y/n]:  Y
    Reload privilege tables now? [Y/n]:  Y

Затем войдите в shell MariaDB и создайте базу и пользователя для Kanboard:

mysql -u root -p

Внутри MariaDB выполните:

MariaDB [(none)]>CREATE DATABASE kanboard CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
MariaDB [(none)]>GRANT ALL PRIVILEGES ON kanboard.* TO 'kanboard'@'localhost' IDENTIFIED BY 'mypassword';
MariaDB [(none)]>FLUSH PRIVILEGES;
MariaDB [(none)]>\q

Важно: замените ‘mypassword’ на надёжный пароль и храните его в менеджере паролей.

Скачивание и установка Kanboard

Скачайте текущий релиз Kanboard с GitHub (пример для v1.2.10):

wget https://github.com/kanboard/kanboard/archive/v1.2.10.tar.gz

Распакуйте и скопируйте в корень веб-сервера:

tar -xvf v1.2.10.tar.gz
cp -r kanboard-1.2.10 /var/www/html/kanboard

Скопируйте пример конфигурации и откройте файл для редактирования:

cd /var/www/html/kanboard  
 cp config.default.php config.php
nano config.php

В config.php укажите параметры доступа к базе данных (пример ниже оставляет комментарии для ясности):

// Database driver: sqlite, mysql or postgres (sqlite by default)
define('DB_DRIVER', 'mysql');

// Mysql/Postgres username
define('DB_USERNAME', 'kanboard');

// Mysql/Postgres password
define('DB_PASSWORD', 'password');

// Mysql/Postgres hostname
define('DB_HOSTNAME', 'localhost');

// Mysql/Postgres database name
define('DB_NAME', 'kanboard');

Сохраните файл и назначьте корректные права доступа:

chown -R www-data:www-data /var/www/html/kanboard

Настройка виртуального хоста Nginx

Создайте файл конфигурации для Kanboard:

nano /etc/nginx/conf.d/kanboard.conf

Вставьте следующую конфигурацию (внимательно проверьте server_name и путь root):

server {
        listen       80;
        server_name  example.com;
        index        index.php;
        root         /var/www/html/kanboard;
        client_max_body_size 32M;

        location / {
            try_files $uri $uri/ /index.php$is_args$args;
        }

        location ~ \.php$ {
            try_files $uri =404;
            fastcgi_split_path_info ^(.+\.php)(/.+)$;
            fastcgi_pass unix:/var/run/php/php7.3-fpm.sock;
            fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
            fastcgi_index index.php;
            include fastcgi_params;
        }

        location ~* ^.+\.(log|sqlite)$ {
            return 404;
        }

        location ~ /\.ht {
            return 404;
        }

        location ~* ^.+\.(ico|jpg|gif|png|css|js|svg|eot|ttf|woff|woff2|otf)$ {
            log_not_found off;
            expires 7d;
            etag on;
        }

        gzip on;
        gzip_comp_level 3;
        gzip_disable "msie6";
        gzip_vary on;
        gzip_types
            text/javascript
            application/javascript
            application/json
            text/xml
            application/xml
            application/rss+xml
            text/css
            text/plain;
    }

Сохраните файл и проверьте конфигурацию Nginx:

nginx -t

Ожидаемый результат:

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

Перезапустите Nginx и php-fpm:

systemctl restart nginx  
 systemctl restart php7.3-fpm

Проверьте статус Nginx:

systemctl status nginx

Доступ к веб-интерфейсу Kanboard

Откройте в браузере http://example.com (замените example.com на ваш домен или IP). Страница входа выглядит примерно так:

По умолчанию логин/пароль: admin / admin. После первого входа смените пароль администратора:

Перейдите Admin > Users Management > admin и нажмите Change password, введите новый пароль и сохраните:

Важно: немедленно смените пароль admin и создайте отдельную учётную запись администратора с двухфакторной аутентификацией, если доступен плагин.

Рекомендации по безопасности и эксплуатации

• Ограничьте доступ к административным панелям по IP или через VPN.
• Регулярно обновляйте пакеты (OS, PHP, Nginx, MariaDB) и плагины Kanboard.
• Делайте резервные копии базы данных и каталога /var/www/html/kanboard.
• Следите за правами файлов и владельцем www-data.
• Проверьте совместимость плагинов с вашей версией Kanboard перед установкой.

Чек-лист после установки

• Заменён admin/admin на надёжный пароль.
• Настроен HTTPS (TLS) — рекомендуется использовать Certbot/Let’s Encrypt.
• Созданы резервные копии БД и файлов.
• Ограничен доступ к /var/www/html/kanboard/config.php и .db файлам.
• Логи мониторятся и ротация логов настроена.

Роли и базовый набор задач

Администратор:

• Создать учётные записи и роли.
• Установить плагины и обновления.
• Настроить резервное копирование.

Оператор (DevOps):

• Управлять службой Nginx и php-fpm.
• Обновлять пакеты безопасности.
• Восстанавливать из бэкапов.

Пользователь проекта:

• Создавать задачи и доски.
• Назначать исполнителей и устанавливать сроки.

Критерии приёмки

• Kanboard доступен по указанному домену/IP.
• Пользователь admin успешно сменил пароль.
• Возможность создания проекта и задачи подтверждена.
• Приложение отвечает на страницы без ошибок 5xx в логах.

Плейбук отката / план восстановления

1. Откат конфигурации Nginx: заменить текущий конфигурационный файл на резервную копию и перезапустить Nginx.
2. Откат базы: восстановить дамп MySQL через mysql client: mysql -u kanboard -p kanboard < backup.sql
3. Восстановление файлов: распаковать резервную копию /var/www/html/kanboard и применить права www-data.
4. Проверить доступность сервиса и журнал ошибок /var/log/nginx/error.log.

Диагностика проблем — краткая шпаргалка

• 502 Bad Gateway: проверьте статус php7.3-fpm (systemctl status php7.3-fpm) и сокет /var/run/php/php7.3-fpm.sock.
• Ошибки доступа к базе: проверьте credentials в config.php и права пользователя БД.
• 403/404 на статические файлы: проверьте права файлов и блоки location в Nginx.

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

Q: Какие учётные данные по умолчанию? A: admin / admin. Сразу смените пароль.

Q: Можно ли использовать SQLite вместо MySQL/MariaDB? A: Да — Kanboard поддерживает sqlite. Для небольших установок sqlite удобен, для команд и больших проектов рекомендуется MariaDB/Postgres.

Q: Нужно ли использовать PHP 7.3? A: В этом руководстве используется php7.3 как в исходном примере. Проверьте требования версии Kanboard и используйте совместимую ветку PHP.

Краткое резюме

• Kanboard легко развернуть на Debian 10 с помощью стека Nginx + MariaDB + PHP.
• Обязательно смените дефолтный пароль, настройте HTTPS и резервное копирование.
• Храните конфигурации и дампы в защищённом хранилище.

Спасибо — вы успешно установили и настроили Kanboard на Debian 10. Если нужно, могу помочь с настройкой HTTPS, автоматическим бэкапом или миграцией данных.