别再记在便签上了！用Docker搭建Vikunja，打造你的专属任务管理

Vikunja是什么？

Vikunja 是一款优秀的开源任务管理工具，以简洁直观的界面和全面功能满足个人与团队的多场景需求。它不仅涵盖任务创建、优先级设置、标签分类、子任务管理等基础功能，还提供列表、看板、甘特图、表格等多种视图模式，搭配 Markdown 编辑、附件上传、任务评论与实时协作功能，无论是整理个人日常琐事、规划学习目标，还是分配团队工作、跟踪项目进度都能轻松应对。

应用特点：

‌多层级项目管理‌：支持主项目/子项目分层管理，可灵活使用列表/看板/甘特图/表格四类视图组织任务
多视图支持：，提供多种任务查看方式，包括经典的列表视图、甘特图、表格视图以及看板（Kanban Board），满足不同用户的偏好和需求
‌协作生态‌：提供团队共享、任务分配、评论交互功能，支持WebDAV协议文件同步
‌中小团队协作‌：支持角色权限分配，实时同步任务状态变更，适用于敏捷开发等场景
‌替代商业软件‌：作为Todoist、滴答清单的开源替代方案，提供更轻量级界面和本地化数据管控
可访问演示Demo进行体验：
https://try.vikunja.io/login

image-20260206010221764

二、部署实战

推荐使用Docker Compose部署，包含前后端分离架构，支持MariaDB/MySQL/SQLite三种数据库方案

2.1、SQLite数据库方式

1、创建本地文件夹，存储本地数据映射

mkdir -p /opt/vikunja cd /opt/vikunja

2、使用Docker Compose

services: vikunja: image: vikunja/vikunja:latest container_name: vikunja environment: - VIKUNJA_SERVICE_PUBLICURL=http://192.168.5.100:3456 - VIKUNJA_SERVICE_JWTSECRET=45c1428dbdf63826b7b1a999e012df3b - VIKUNJA_DATABASE_PATH=/db/vikunja.db ports: - 3456:3456 volumes: - ./files:/app/vikunja/files - ./db:/db restart: unless-stopped

SQLlite本地数据库地址映射

./files:/app/vikunja/files

文件存储映射：

./db:/db

3、使用Docker命令

下载Docker镜像：

docker pull vikunja/vikunja

使用Docker命令启动容器

docker run -itd --name vikunja -p 3456:3456 #自定义端口 -v /opt/vikunja/files:/app/vikunja/files #自定义文件存储路径 -v /opt/vikunja/db:/db #自定义数据库存储路径 vikunja/vikunja

2.2、MYSQL数据库方式

Docker Compose文件

1、使用连接现有Mysql数据库，只创建vikunja

version: '3' services: vikunja: image: vikunja/vikunja environment: - TZ: Asia/Shanghai - VIKUNJA_SERVICE_PUBLICURL: http://<这里填NAS的局域网地址> - VIKUNJA_DATABASE_TYPE: mysql - VIKUNJA_DATABASE_HOST: 192.168.1.100 - VIKUNJA_DATABASE_DATABASE: vikunja - VIKUNJA_DATABASE_USER: vikunja - VIKUNJA_DATABASE_PASSWORD: password - VIKUNJA_SERVICE_JWTSECRET: 45c1428dbdf63826b7b1a999e012df3b ports: - 3456:3456 #自定义端口 volumes: - ./files:/app/vikunja/files #持久化存储配置，需小伙伴自定义文件存储路径

参数解释：

#选择数据库类型 VIKUNJA_DATABASE_TYPE: mysql #配置链接mysql数据库 - VIKUNJA_DATABASE_HOST: 192.168.1.100 - VIKUNJA_DATABASE_DATABASE: vikunja - VIKUNJA_DATABASE_USER: vikunja - VIKUNJA_DATABASE_PASSWORD: password

2、你可以创建vikunja服务+Mysqls数据库组合

services: vikunja: image: vikunja/vikunja:latest container_name: vikunja environment: - VIKUNJA_SERVICE_PUBLICURL=http://192.168.31.90:3456 - VIKUNJA_SERVICE_JWTSECRET=74eBQyirDWKwog8syDktUk9vuQKXTVoE - VIKUNJA_DATABASE_TYPE=mysql - VIKUNJA_DATABASE_HOST=db - VIKUNJA_DATABASE_PASSWORD=changeme - VIKUNJA_DATABASE_USER=vikunja - VIKUNJA_DATABASE_DATABASE=vikunja ports: - 3456:3456 volumes: - ./files:/app/vikunja/files depends_on: db: condition: service_healthy restart: unless-stopped db: image: mariadb:10 container_name: vikunja-db command: --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci environment: MYSQL_ROOT_PASSWORD: supersecret MYSQL_USER: vikunja MYSQL_PASSWORD: changeme MYSQL_DATABASE: vikunja volumes: - ./db:/var/lib/mysql healthcheck: test: ["CMD-SHELL", "mysqladmin ping -h localhost -u $$MYSQL_USER --password=$$MYSQL_PASSWORD"] interval: 2s start_period: 30s restart: unless-stopped