Vikunja开源待办清单：Docker一键部署与全面使用指南

December 6, 2025

Vikunja 是一款基于开源理念开发的任务管理工具，其主要目标是帮助用户有效地组织和追踪日常生活及工作中的各类待办事项。

您可以访问其在线演示站点（使用 demo/demo 作为登录凭证）以提前体验功能：

https://try.vikunja.io

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 是一个颇具实用价值的选择。

综合推荐指数：⭐⭐⭐（兼顾个人计划与团队协作） 用户体验评分：⭐⭐⭐（功能专注，学习曲线平缓） 部署复杂度评估：⭐⭐（流程清晰，配置简单）