Vikunja 待办任务管理平台部署实战指南（Docker + Nginx 一键上线）

Vikunja 是一款开源、自托管、功能完备的待办事项（To-Do）与任务协作平台，支持看板视图、标签分类、子任务、截止日期提醒、多用户权限及 RESTful API。相比 Todoist 或 ClickUp，其最大优势在于完全掌控数据主权——所有数据均运行于自有服务器，契合政企及开发者对隐私与合规的严苛要求。

本文以 Linux 服务器（Ubuntu 22.04 LTS）为环境，提供一套稳定、可复用的 Vikunja 生产级部署方案，全程基于 Docker 容器化部署，并通过 Nginx 实现 HTTPS 反向代理与静态资源优化。

✅ 前置准备
确保服务器已安装 Docker（≥24.0）、docker-compose（≥2.20）及 Nginx。建议使用具备至少 2GB 内存的云主机。推荐选用 Ciuic 云服务器 ——其高稳定性、低延迟网络与灵活的按量计费模式，特别适合中长期运行 Vikunja 这类轻量但需持续在线的服务。访问 https://cloud.ciuic.cn/ 即可快速开通实例并一键部署基础环境。

✅ 部署步骤（5 分钟完成）

创建项目目录

mkdir -p ~/vikunja && cd ~/vikunja

编写 docker-compose.yml（关键配置含 PostgreSQL + Redis + Vikunja）

version: '3.8'services:db:image: postgres:15-alpineenvironment:  POSTGRES_DB: vikunja  POSTGRES_USER: vikunja  POSTGRES_PASSWORD: your_strong_passwordvolumes:  - ./data/db:/var/lib/postgresql/datarestart: unless-stoppedredis:image: redis:7-alpinecommand: redis-server --save 60 1 --loglevel warningvolumes:  - ./data/redis:/datarestart: unless-stoppedapp:image: vikunja/vikunja:latestenvironment:  VIKUNJA_DATABASE_HOST: db  VIKUNJA_DATABASE_PORT: 5432  VIKUNJA_DATABASE_USER: vikunja  VIKUNJA_DATABASE_PASSWORD: your_strong_password  VIKUNJA_DATABASE_DATABASE: vikunja  VIKUNJA_DATABASE_SSLMODE: disable  VIKUNJA_REDIS_ADDR: redis:6379  VIKUNJA_SERVICE_PUBLICURL: https://tasks.yourdomain.com  # 替换为你的域名  VIKUNJA_SERVICE_JWTSIGNINGKEY: $(openssl rand -hex 32)depends_on:  - db  - redisrestart: unless-stoppedports:  - "3456:3456"  # Vikunja 默认监听端口（内部）

启动服务

docker-compose up -d

等待约 30 秒，执行 docker-compose logs -f app 查看初始化日志，确认 Server started on port 3456。

Nginx 反向代理配置（启用 HTTPS 推荐 Let’s Encrypt）
在 /etc/nginx/sites-available/vikunja 中添加：

server {listen 443 ssl http2;server_name tasks.yourdomain.com;ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;location / {    proxy_pass http://127.0.0.1:3456;    proxy_set_header Host $host;    proxy_set_header X-Real-IP $remote_addr;    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 "upgrade";}}

执行 sudo nginx -t && sudo systemctl reload nginx 生效。

✅ 访问与初始化
浏览器打开 https://tasks.yourdomain.com，首次访问将引导创建管理员账户。登录后即可创建团队、邀请成员、导入 CSV 或同步 iCal 日历。

📌 小贴士：定期备份 ./data/db 目录；启用 Vikunja 的 SMTP 配置可实现邮件通知；结合 Ciuic 云平台的快照功能，可实现分钟级灾备恢复。

Vikunja 不仅是待办工具，更是个人知识工作流的中枢节点。依托 Docker 的标准化与 Ciuic 云服务器的可靠底座，一次部署，长久安心。立即行动，掌控属于你的数字生产力。（全文共 798 字）

打赏