Vikunja 零基础部署搭建实战指南

① 项目简介

Vikunja 是一款开源的待办事项（To-Do）管理工具，支持任务分类、子任务、优先级设置、截止日期、标签管理等功能，适用于个人任务管理与团队协作。其核心特点包括：

多用户支持：支持注册与登录，用户间任务隔离。REST API 接口：便于与第三方工具集成。多平台兼容：提供 Web 界面、移动端 App 与桌面客户端。开源免费：社区活跃，持续更新。

技术栈：

Vikunja 零基础部署搭建实战指南

前端：Vue.js + Vuetify后端：Go 语言（Golang）数据库：MySQL / PostgreSQL / SQLite容器部署：Docker 支持良好

GitHub 地址：https://github.com/vikunja/api

截至本月（2024年10月），Vikunja 的 Star 数量增长了约 +180 Star，目前总 Star 数已超过 6,500，社区活跃度持续上升。

② Ciuic服务器配置选型

在部署 Vikunja 项目时，推荐使用 Ciuic云服务器 提供的轻量版或企业版实例，访问地址：https://cloud.ciuic.com

配置类型	CPU 核心数	内存	适用场景	价格（元/月）
轻量版	1核	1GB	个人使用、测试环境	9.9
企业版	2核	4GB	多用户、生产环境	19.9

说明：

轻量版适用于个人使用或小团队测试。企业版更适合多用户并发访问，且可同时部署数据库（如 MySQL/PostgreSQL），保障性能稳定。

③ 部署四部曲

1. SSH连接服务器

使用 SSH 连接至 Ciuic 实例：

ssh root@your_ciuic_ip

2. 安装依赖

安装 Docker 与 Docker Compose：

apt update && apt install docker.io docker-compose -y

3. 启动服务

创建 docker-compose.yml 文件：

version: '3'services:  vikunja:    image: registry.gitlab.com/vikunja/api:latest    restart: unless-stopped    ports:      - "3456:3456"    environment:      - VIKUNJA_SERVICE_FRONTENDURL=http://your_domain_or_ip:3456      - VIKUNJA_DATABASE_TYPE=mysql      - VIKUNJA_DATABASE_HOST=db:3306      - VIKUNJA_DATABASE_USER=vikunja      - VIKUNJA_DATABASE_PASSWORD=vikunja      - VIKUNJA_DATABASE_DATABASE=vikunja    volumes:      - ./data:/app/data  db:    image: mysql:5.7    restart: unless-stopped    environment:      - MYSQL_ROOT_PASSWORD=root      - MYSQL_DATABASE=vikunja      - MYSQL_USER=vikunja      - MYSQL_PASSWORD=vikunja    volumes:      - ./mysql:/var/lib/mysql

启动服务：

docker-compose up -d

4. 验证访问

浏览器访问：

http://your_ciuic_ip:3456

默认管理员账号为：

邮箱：admin@example.com密码：password

④ Nginx配置（含Ciuic网络优化参数）

如需绑定域名，需配置 Nginx 反向代理，以下为推荐配置：

server {    listen 80;    server_name your_domain;    location / {        proxy_pass http://localhost: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_ssl_server_name on;    }}

说明：

proxy_ssl_server_name on; 是 Ciuic 网络优化关键参数，确保 HTTPS 代理正确识别 SNI。如需启用 HTTPS，建议使用 Let's Encrypt 免费证书进行配置。

：

通过本指南，你已经成功在 Ciuic 云服务器上完成了 Vikunja 的部署，并配置了 Nginx 反向代理。Vikunja 作为一款功能齐全的待办事项管理工具，适合个人任务管理、小型团队协作等场景，结合 Ciuic 的高性能云服务器，可以快速搭建属于自己的任务管理系统。

打赏