Vikunja开源待办清单:Docker一键部署与全面使用指南
Vikunja 是一款基于开源理念开发的任务管理工具,其主要目标是帮助用户有效地组织和追踪日常生活及工作中的各类待办事项。

您可以访问其在线演示站点(使用 demo/demo 作为登录凭证)以提前体验功能:
Vikunja安装部署步骤
使用 Docker Compose 配合 Sqlite 数据库
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_PATH=/db/vikunja.db
ports:
- 3456:3456
volumes:
- ./files:/app/vikunja/files
- ./db:/db
restart: unless-stopped
使用 Docker Compose 配合 PostgreSQL 数据库
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=postgres
- 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: postgres:18
container_name: vikunja-db
environment:
POSTGRES_PASSWORD: changeme
POSTGRES_USER: vikunja
volumes:
- ./db:/var/lib/postgresql
healthcheck:
test: ["CMD-SHELL", "pg_isready -h localhost -U $$POSTGRES_USER"]
interval: 2s
start_period: 30s
restart: unless-stopped
使用 Docker Compose 配合 MySQL/MariaDB 数据库
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
核心环境变量说明(更多详细配置建议查阅官方文档)
:::tips
VIKUNJA_SERVICE_PUBLICURL:此环境变量用于设置服务的公开访问地址,请根据您的实际网络环境进行修改。
VIKUNJA_SERVICE_JWTSECRET:此环境变量是用于加密JWT身份验证令牌的密钥,为确保安全,务必将其替换为您自己生成的复杂字符串。
VIKUNJA_DATABASE_TYPE:此环境变量用于指定后端数据库的类型,例如sqlite、postgres或mysql。
:::
Vikunja基本使用指南
在浏览器地址栏输入 http://您的服务器IP:3456 即可访问Vikunja的Web界面。

首次使用需要创建一个用户账户。

根据界面提示填写用户名、邮箱和密码等信息以完成注册(如果注册时提示“Unauthorized”错误,请检查上述VIKUNJA_SERVICE_PUBLICURL环境变量的值是否正确配置)。

成功登录后将进入主控制面板,其用户界面设计在视觉上较为美观。

提示:后续部分界面截图因调整了浏览器窗口大小以适应布局,因此展示效果可能与全屏状态略有不同。
进入用户设置页面,您可以在此处更换个人头像。

从本地设备选择图片文件并上传即可更新头像。

提示:在侧边栏或主界面可以快速创建新的任务清单。

首先创建一个项目(或称为空间)来归类您的任务。

为项目填写名称和描述等基本信息。

随后即可在项目中逐步添加具体的待办任务(下图示例清单内容由AI辅助生成)。

Vikunja支持以甘特图视图展示任务的时间规划和依赖关系。

任务也可以切换为表格视图,便于进行批量管理和数据筛选。

看板视图则能直观地反映任务在不同状态(如待处理、进行中、已完成)下的流转情况。

此外,您可以创建团队并邀请成员,以实现多人协作管理项目。

功能总结与评价
Vikunja 本质上是一款专注于待办事项管理的开源工具,其功能核心明确,相对而言可能不如大型项目管理软件复杂,但正因如此,它具备了快速上手和操作简单的优势。该工具既适用于个人管理日常学习与生活计划,也能满足小型团队进行项目规划和任务分配的基本需求。对于正在寻找一款轻量级、自托管待办清单应用的用户,部署并试用 Vikunja 是一个颇具实用价值的选择。
综合推荐指数:⭐⭐⭐(兼顾个人计划与团队协作) 用户体验评分:⭐⭐⭐(功能专注,学习曲线平缓) 部署复杂度评估:⭐⭐(流程清晰,配置简单)