Хостване на Vikunja на Managed VPS: вашите задачи и проекти на ваш сървър

Хостването на Vikunja на Managed VPS означава да пазите задачите и проектите на вашия екип на своя собствена машина, която нашите екипи поддържат актуална и наблюдават денем и нощем. Vikunja е свободен софтуер с лиценз AGPL-3.0. Това ръководство следва официалната му документация: изборът на база данни, инсталирането с Docker Compose, публичният адрес и тайният ключ, акаунтите, HTTPS, собствените настройки на Vikunja, имейлите, резервните копия и обновленията.

Simon Vasconcelos Lee Автор: Публикувано на 19 ноември 2026 г.Време за четене: 13 минути

Всички ръководства

Накратко

  1. Лицензът AGPL-3.0 позволява да използвате Vikunja във фирма, без да купувате лиценз; ако го промените, вашите отдалечени потребители трябва да могат да получат изходния код на вашата версия.
  2. Инсталирайте го с Docker Compose: образа vikunja/vikunja:2.8.0 и PostgreSQL, с порт 3456, публикуван на 127.0.0.1, зад обратен прокси с HTTPS.
  3. Две настройки трябва да са на място от самото начало: service.publicurl, HTTPS адресът на вашата инстанция, и service.secret, който подписва сесиите.
  4. Vikunja няма акаунт по подразбиране: създайте своя, после затворете регистрацията и добавяйте следващите акаунти от командния ред.
  5. Архивирайте заедно базата данни и папката files, преди всяко обновяване; миграциите на базата данни се изпълняват сами при стартиране.

Какво прави Vikunja

Vikunja е самостоятелно хостван мениджър на задачи и проекти с отворен код, който хранилището му описва като „мениджърът на задачи, който наистина притежавате“. API, написан на Go, и уеб интерфейсът се доставят в един-единствен изпълним файл или в един-единствен Docker образ: има само едно нещо за инсталиране.

Какво позволява лицензът AGPL-3.0

Vikunja е публикуван с лиценза GNU AGPL версия 3 или по-нова, с изключение на папката desktop/ в хранилището му, настолното приложение, която е с лиценз GPL версия 3 или по-нова. Можете да го използвате, включително във фирма, за екипа си, както и за клиентите си, без да купувате лиценз. Остава цената на сървъра, на който работи.

Член 13 добавя условие, присъщо на AGPL: ако променяте програмата, вашата версия трябва ясно да предложи на всеки, който взаимодейства с нея от разстояние, през мрежата, възможността да получи безплатно изходния ѝ код. Ако разпространявате копия, прилагат се и задълженията на лиценза за споделяне на кода. Пускането на Vikunja без промяна не задейства този член.

Това ръководство инсталира това издание с отворен код, което документацията описва като напълно функционално само по себе си. Vikunja Pro, незадължителен лиценз, добавя администраторски панел, отчитане на работното време и журнали за одит за организациите.

Ресурси и база данни

Vikunja работи със SQLite, PostgreSQL, MySQL или MariaDB. Документацията не дава числа за паметта или процесора; тя насочва избора на база данни според броя на потребителите:

База данниКакво казва документациятаВерсия, тествана в CI
SQLiteВградена в изпълнимия файл и в Docker образа, нищо за инсталиране. При повече от няколко потребители документацията препоръчва MySQL или PostgreSQL.Вградената
PostgreSQLБазата данни в Docker примерите на документацията. От 2.8.0 търсенето пренебрегва диакритичните знаци с разширението unaccent.18
MySQL, MariaDBПоне MySQL 8.0, тъй като 5.7 не се поддържа. За нелатински знаци базата данни трябва да използва utf8mb4.MySQL 8, MariaDB 12

Документацията препоръчва версия на базата данни, която все още се поддържа. Redis може да служи като кеш, но тя отбелязва, че вероятно няма да ви трябва, докато инстанцията има само няколко потребители: това ръководство минава без него.

Използваното дисково пространство зависи главно от прикачените файлове и фоновете на проектите, съхранявани в папката files, най-много 20 MB на файл по подразбиране. На Managed VPS ни разкажете за екипа си, броя на потребителите му и колко разчита на прикачени файлове и ще ви препоръчаме подходящия размер.

Инсталиране с Docker Compose

Документацията инсталира Vikunja и PostgreSQL с Docker Compose. На сървър с инсталиран Docker създайте папка и първо генерирайте тайния ключ на инстанцията, случайна стойност, която ще поставите във файла:

Терминал
openssl rand -hex 32

После поставете в папката този docker-compose.yml, взет от примера с PostgreSQL в документацията. Заменете tasks.example.com с името на домейна си, paste-your-secret-here със стойността, която генерирахте, и changeme със силна парола, една и съща на двете места:

docker-compose.yml
services:
  vikunja:
    image: vikunja/vikunja:2.8.0
    environment:
      VIKUNJA_SERVICE_PUBLICURL: https://tasks.example.com/
      VIKUNJA_SERVICE_SECRET: paste-your-secret-here
      VIKUNJA_SERVICE_IPEXTRACTIONMETHOD: xff
      VIKUNJA_DATABASE_TYPE: postgres
      VIKUNJA_DATABASE_HOST: db
      VIKUNJA_DATABASE_USER: vikunja
      VIKUNJA_DATABASE_PASSWORD: changeme
      VIKUNJA_DATABASE_DATABASE: vikunja
    ports:
      - "127.0.0.1:3456:3456"
    volumes:
      - ./files:/app/vikunja/files
    depends_on:
      db:
        condition: service_healthy
    restart: unless-stopped
  db:
    image: postgres:18
    environment:
      POSTGRES_USER: vikunja
      POSTGRES_PASSWORD: changeme
    volumes:
      - ./db:/var/lib/postgresql
    restart: unless-stopped
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -h localhost -U $$POSTGRES_USER"]
      interval: 30s
      start_period: 15s
      start_interval: 5s

Vikunja работи с потребител 1000: създайте папката files и му я предоставете преди първото стартиране, както иска документацията, после стартирайте услугите:

Терминал, в папката на docker-compose.yml
mkdir files
sudo chown 1000 files
docker compose up -d
docker compose logs vikunja

При първото стартиране Vikunja създава базата си данни и изпълнява всичките си миграции. Редът http server started on [::]:3456 в журналите означава, че е готов, а командата curl http://127.0.0.1:3456/api/v1/info, изпълнена на сървъра, връща версията му и публичните му настройки.

Със SQLite

За няколко потребители документацията предлага SQLite: премахнете услугата db, блока depends_on и променливите VIKUNJA_DATABASE_* и монтирайте папка на /db, където образът вече съхранява vikunja.db. Създайте я и я предоставете на потребител 1000, както files:

docker-compose.yml, услугата vikunja
    volumes:
      - ./files:/app/vikunja/files
      - ./db:/db

Без Docker: пакетът за Debian

От версия 2.4.0 Vikunja публикува хранилище с пакети за Debian и Ubuntu, за amd64, arm64 и armhf, подписано с неговия GPG ключ:

Терминал
curl -fsSL https://dl.vikunja.io/repos/gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/vikunja.gpg
echo "deb [signed-by=/usr/share/keyrings/vikunja.gpg] https://dl.vikunja.io/repos/apt stable main" | sudo tee /etc/apt/sources.list.d/vikunja.list
sudo apt update && sudo apt install vikunja

Пакетът инсталира Vikunja в /opt/vikunja, по подразбиране със SQLite, и услуга systemd, която е включена, но още не е стартирана. Той записва и случаен таен ключ в раздел service на /etc/vikunja/config.yml: допълнете същия раздел, после стартирайте услугата.

/etc/vikunja/config.yml
service:
  secret: "the value written by the package"
  publicurl: "https://tasks.example.com/"
  interface: "127.0.0.1:3456"
  ipextractionmethod: "xff"
Терминал
sudo systemctl start vikunja

Първият акаунт и регистрацията

Vikunja не създава акаунт по подразбиране. След като HTTPS е на място, отворете https://tasks.example.com/ и се регистрирайте: това е първият ви акаунт. Регистрацията е отворена по подразбиране за всеки, който стигне до адреса; след като акаунтите на екипа ви съществуват, документацията предлага да я затворите. Добавете този ред към променливите на услугата vikunja, после изпълнете отново docker compose up -d:

docker-compose.yml, под environment
      VIKUNJA_SERVICE_ENABLEREGISTRATION: "false"

Следващите акаунти се управляват от командния ред. Тъй като образът няма обвивка, извиквате директно неговия изпълним файл:

Терминал, в папката на docker-compose.yml
docker compose exec vikunja /app/vikunja/vikunja user create -u marie -e marie@example.com
docker compose exec vikunja /app/vikunja/vikunja user list
docker compose exec vikunja /app/vikunja/vikunja user reset-password 2 --direct

Сигурността на акаунтите

HTTPS: обратният прокси

Vikunja предоставя HTTP в явен вид. Документацията поставя HTTPS на обратен прокси, така че паролите и токените никога да не пътуват некриптирани: той слуша на портове 80 и 443, получава сертификата и препраща към Vikunja на 127.0.0.1:3456.

Зад прокси Vikunja по подразбиране вижда адреса на проксито при всяка заявка: тогава журналите и ограниченията на честотата засягат всички наведнъж. Настройката VIKUNJA_SERVICE_IPEXTRACTIONMETHOD: xff, която вече е във файла на Compose, го кара да чете заглавката X-Forwarded-For. Той се доверява на тази заглавка само при заявки, идващи от loopback адреси и адреси от частни мрежи, включително мрежата на Docker: с порта, публикуван на 127.0.0.1, само вашето прокси стига дотам.

С Caddy

Ето Caddyfile от документацията. Caddy сам получава сертификат Let’s Encrypt за даденото име, предава заглавката X-Forwarded-For и пропуска връзките WebSocket:

Caddyfile
tasks.example.com {
    reverse_proxy 127.0.0.1:3456
}

С Nginx

Блокът от документацията се свежда до ред proxy_pass и размер на качваните файлове. Този блок надгражда върху него с две добавки: заглавката X-Forwarded-For, която Vikunja чете, и заглавките за WebSocket. Интерфейсът на версия 2.8.0 отваря връзка WebSocket на /api/v2/ws за обновленията си на живо; когато тя не успее, известията му преминават към проверка на всеки 10 секунди. Първо добавете този блок map в раздела http на /etc/nginx/nginx.conf:

nginx.conf, в http
map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      close;
}

После този блок за сайта, на порт 80, за да остави на Certbot да постави HTTPS:

Блок на Nginx
server {
    listen 80;
    listen [::]:80;
    server_name tasks.example.com;

    location / {
        proxy_pass http://127.0.0.1:3456;
        client_max_body_size 20M;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection $connection_upgrade;
    }
}
Терминал
sudo nginx -t
sudo certbot --nginx

client_max_body_size 20M съответства на максималния размер на файл във Vikunja, 20 MB по подразбиране. Ако го увеличите с VIKUNJA_FILES_MAXSIZE, документацията иска да увеличите и този ред.

Настройки, специфични за Vikunja

Почти всеки ключ от файла config.yml има своя променлива на средата: service.enablecaldav става VIKUNJA_SERVICE_ENABLECALDAV. Когато една опция е зададена и на двете места, променливата има предимство. Списъкът за подсилване на сигурността в документацията преглежда функциите, които да изключите, ако не ви трябват:

КлючПо подразбиранеИзключете го, за да
service.enablelinksharingtrueЗабраните споделянето на проекти чрез публични връзки
service.enablecaldavtrueПремахнете крайната точка CalDAV, която приема HTTP basic auth
webhooks.enabledtrueПопречите на Vikunja да изпраща заявки към адреси, избрани от потребителите
service.enabletaskattachmentstrueЗабраните качването на файлове към задачите
service.enableuserdeletiontrueПопречите на потребителите да изтриват собствените си акаунти
plugins.enabledfalseВече е изключено: дръжте кода на трети страни извън Vikunja

Търсене без отчитане на диакритичните знаци в PostgreSQL

От 2.8.0 търсенето пренебрегва диакритичните знаци в PostgreSQL, когато разширението unaccent е активно: „cafe“ намира и „café“. Официалният образ на PostgreSQL го съдържа; активирайте го в базата данни на Vikunja, после рестартирайте Vikunja. Тогава журналът показва unaccent extension detected, search is accent-insensitive.

Терминал, в папката на docker-compose.yml
docker compose exec db psql -U vikunja -d vikunja -c 'CREATE EXTENSION IF NOT EXISTS unaccent;'
docker compose restart vikunja

Импортиране на задачите ви

Всеки потребител импортира задачи от раздела „Import“ в настройките си и може там също да експортира всичките си данни като zip архив. Импортирането от файл, архив на Vikunja, CSV, TickTick и WeKan, както и импортирането от инстанция на Planka, са винаги достъпни. Todoist, Trello и Microsoft To Do минават през OAuth: те са изключени по подразбиране и се включват в раздела migration на конфигурацията, с данните за достъп на приложението, създадено при всяка услуга. Пренасочването на OAuth става в браузъра: инстанцията не е нужно да е достъпна за тези услуги, но service.publicurl трябва да е правилен.

CalDAV

CalDAV синхронизира задачите с приложенията ви, с данните за връзка от раздела CalDAV в настройките. Документацията представя тази интеграция като алфа версия, която работи добре с някои клиенти: изпробвайте своя, преди да я направите инструмент на целия екип. На iPhone и iPad всеки проект става списък в приложението „Напомняния“. Акаунт с двуфакторно удостоверяване се свързва със специален токен за CalDAV.

Имейли: напомняния, потвърждения и пароли

Vikunja изпраща имейли за напомнянията за задачи, потвърждението на нов акаунт и нулирането на пароли. Изпращането е изключено по подразбиране: тогава акаунтите са активни веднага след създаването си, а нулирането на парола по имейл не е възможно. След като изпращането е включено, всеки нов локален акаунт потвърждава адреса си преди употреба.

От VPS на Simafri настройте SMTP сървър с удостоверяване, на порт 587 или 465: този на вашата услуга за изпращане или на вашия доставчик на имейл. Добавете тези променливи към услугата vikunja:

docker-compose.yml, под environment
      VIKUNJA_MAILER_ENABLED: "true"
      VIKUNJA_MAILER_HOST: smtp.example.com
      VIKUNJA_MAILER_PORT: 587
      VIKUNJA_MAILER_USERNAME: tasks@example.com
      VIKUNJA_MAILER_PASSWORD: your-smtp-password
      VIKUNJA_MAILER_FROMEMAIL: tasks@example.com

Изпълнете отново docker compose up -d, после изпратете тестово съобщение. Командата проверява връзката със SMTP командата NOOP, която някои минималистични релета не поддържат: предпочетете пълноценен SMTP сървър.

Терминал
docker compose exec vikunja /app/vikunja/vikunja testmail you@example.com

Резервните копия

Документацията брои две части за архивиране, заедно: базата данни и папката с прикачените файлове. От 2.8.0 изтритите задачи и проекти първо прекарват 30 дни в кошчето; след като този срок изтече или кошчето бъде изпразнено, само резервно копие може да ги върне.

ЕлементКакво пазиКак да го копирате
Базата данни PostgreSQLАкаунти, проекти, задачи, коментари и настройкиpg_dump, без да спирате Vikunja
filesПрикачени файлове, аватари и фонове на проектиКопие на папката
Със SQLite, db/vikunja.dbЦялата база данниКопие на файла, при спрян Vikunja
docker-compose.ymlТайният ключ, публичният адрес и паролитеПази се отделно, като тайна
Терминал, в папката на docker-compose.yml
docker compose exec -T db pg_dump -U vikunja vikunja > vikunja-$(date +%F).sql
tar -czf vikunja-files-$(date +%F).tar.gz files

Документацията иска криптирани резервни копия, пазени извън сървъра, и редовно тествани възстановявания: на отделна инстанция влезте и отворете задача с прикачен файл. Поставени на диска на сървъра, тези архиви влизат и в нощните му резервни копия.

Командата vikunja dump събира конфигурацията, базата данни и всички файлове в zip архив, а vikunja restore го зарежда обратно. Архивът съдържа конфигурационния файл и всяка променлива VIKUNJA_* в явен вид: криптирайте го и го защитавайте като самата база данни.

Възстановяване

На нова инсталация, със същия docker-compose.yml, заредете експорта в още празната база данни преди първото стартиране на Vikunja, после върнете папката files на мястото ѝ:

Терминал
docker compose up -d db
docker compose exec -T db psql -U vikunja vikunja < vikunja-2026-11-19.sql
tar -xzf vikunja-files-2026-11-19.tar.gz
docker compose up -d

Обновленията

Vikunja изпълнява сам миграциите на базата си данни, когато стартира нова версия. Затова документацията иска резервно копие преди всяко обновяване, за да можете да се върнете към предишното състояние, и прочит на бележките към версията, които посочват евентуалните ръчни стъпки.

  1. Прочетете бележките към новата версия.
  2. Експортирайте базата данни и копирайте папката files.
  3. Сменете етикета на образа в docker-compose.yml, например от 2.8.0 към следващата версия.
  4. Изтеглете новия образ и рестартирайте услугата.
Терминал
docker compose pull
docker compose up -d

С пакета за Debian sudo apt update && sudo apt upgrade заменя изпълнимия файл и рестартира услугата. Преминаването от стабилна версия към версиите unstable работи, но документацията не съветва връщането обратно: по-добре изчакайте следващата стабилна версия.

Корекциите на сигурността се публикуват като GitHub security advisories и се обявяват в бележките към версиите. Версия 2.8.0 от 5 ноември 2026 г. поправя деветнадесет от тях, а съобщението за нея моли да обновите възможно най-скоро. За да бъдете известявани, следете версиите в хранилището в GitHub или се абонирайте за RSS емисията на списъка с промени.

Кой какво прави на Managed VPS

Самостоятелното хостване изисква да поддържате сървъра освен приложението. На Managed VPS нашите екипи поемат сървъра и следят проактивно вашата инстанция; Vikunja остава ваш софтуер, с неговите настройки, вашите проекти и вашите задачи.

ТемаНашите екипиВие
СървърътОбновления на системата и на сигурността, включително намеси на сървъраМоментът, който пасва на вашата дейност
НаблюдениетоСървър, следен денонощно, 7 дни в седмицата, с намеса, без да се чака обаждането виЧетенето на журналите на вашата инстанция
VikunjaПроактивно проследяване: грешки, забавяния и дисково пространство се откриват, препоръчва се корекцияИнсталирането, обновяванията и настройките му, които прилагате вие или вашият AI асистент
Акаунтите и проектитеСървърът, който ги носи, наблюдаван и архивиранАкаунтите на екипа ви, регистрацията, споделянията и правата
ИмейлитеСървър, който достига вашия SMTP сървър на порт 587 или 465Вашата услуга за изпращане и данните ѝ за достъп
Резервните копияВсяка нощ, криптирани и пазени извън машината; възстановяването е включеноВашите експорти на базата данни и на папката files, и заявката за възстановяване, когато ви потрябва
МиграциятаСегашният ви сървър е мигриран, безплатноМоментът на превключването

Ако предпочитате нашите екипи да се намесват в самото приложение, тази услуга се фактурира на час или на фиксирана цена, с оферта, съобщена преди намесата.

Vikunja, на сървър, поддържан вместо вас

С Managed VPS от Simafri нашите екипи поддържат актуален сървъра на вашата инстанция на Vikunja, наблюдават го денем и нощем и се намесват, без да чакат обаждането ви; те следят проактивно и вашата инстанция и ви препоръчват полезните корекции, които прилагате вие или вашият AI асистент. Резервните копия се криптират всяка нощ и се пазят извън машината, възстановяването им е включено, а миграцията от сегашния ви сървър е безплатна.

Разгледайте Managed VPS

Често задавани въпроси

Безплатен ли е Vikunja за фирма?

Да. Vikunja е с лиценз AGPL-3.0: можете да го използвате във фирма, без да купувате лиценз. Ако го промените, вашите отдалечени потребители трябва да могат да получат изходния код на вашата версия. Остава цената на сървъра, на който работи.

Коя база данни да избера за Vikunja?

SQLite, вградена в образа, е достатъчна за няколко потребители. При повече документацията препоръчва PostgreSQL или MySQL. PostgreSQL е базата данни в нейните Docker примери, а от 2.8.0 търсенето в нея пренебрегва диакритичните знаци с разширението unaccent.

Как се инсталира Vikunja с Docker Compose?

Създайте docker-compose.yml с образите vikunja/vikunja:2.8.0 и postgres:18, порт 3456, публикуван на 127.0.0.1, папка files, предоставена на потребител 1000, публичния адрес и тайния ключ, после изпълнете docker compose up -d. След това поставете обратен прокси с HTTPS пред порт 3456.

За какво служат service.publicurl и service.secret?

service.publicurl е HTTPS адресът на вашата инстанция: Vikunja изгражда от него връзките си и своя CORS източник, оттук и грешката unauthorized, когато е грешен. service.secret подписва сесиите; ако е празен, той се сменя при всяко стартиране и изписва всички потребители.

Как се създава първият акаунт във Vikunja?

Vikunja няма акаунт по подразбиране: регистрирайте се на своята инстанция. После затворете регистрацията, като зададете VIKUNJA_SERVICE_ENABLEREGISTRATION на false, и създавайте следващите акаунти с командата vikunja user create, изпълнена в контейнера.

Как се настройват имейлите във Vikunja?

Включете изпращането с VIKUNJA_MAILER_ENABLED, после въведете хоста, порт 587 или 465, потребителското име, паролата и адреса на подателя на вашия SMTP сървър. Без имейли акаунтите са активни веднага след създаването си, а паролите се нулират от командния ред.

Как се архивира Vikunja?

Архивирайте заедно базата данни, с pg_dump за PostgreSQL, и папката files с прикачените файлове. Пазете копията криптирани и извън сървъра, правете копие преди всяко обновяване и редовно тествайте възстановяването им.

Покрива ли Managed VPS Vikunja?

Managed VPS покрива сървъра: система, сигурност, наблюдение и резервни копия. Нашите екипи следят проактивно и вашата инстанция и ви препоръчват полезните корекции, които прилагате вие. Намеса в самото приложение се фактурира на час или на фиксирана цена.

Източници и официална документация

Свързани ръководства

PostgreSQL на VPS: как да оразмерите паметта и дискаБързата PostgreSQL база е база, чиито често четени данни се побират в паметта. Цялото оразмеряване започва оттук: обемът на базата, делът, който наистина работи, броят на връзките, след това дискът и неговият резерв. Това ръководство дава метода, началните настройки за 4, 8 и 16 GB памет и заявките, които измерват съществуваща база.Резервни копия на VPS: какво да проверите, преди да подпишетеПочти всяко предложение за VPS обявява „включени резервни копия“. Зад тези думи може да стои копие всяка нощ, пазено извън машината и възстановявано от експерти, или моментна снимка, поставена на същия диск като сървъра. Това ръководство дава въпросите, които правят разликата, какво означава всеки отговор и как да проверите, че едно резервно копие наистина се възстановява.Разлика между управляван и неуправляван VPS: кой какво правиРазликата между управляван и неуправляван VPS се свежда до един въпрос: кой се грижи за сървъра, след като той вече работи. Думата „управляван“ обаче няма официално определение и от един хостинг доставчик до друг обхваща всичко от простото инсталиране на системата до цялостното стопанисване на сървъра. Това ръководство показва кой какво прави, ред по ред, заедно с междинното ниво на експертното съдействие, и дава въпросите, които премахват двусмислието, преди да подпишете.
Свържете се с нас