① 项目简介与 GitHub 地址

Vikunja 是一个开源的待办事项管理工具，专为个人和团队设计，支持任务分类、优先级设置、子任务、标签管理、协作共享等功能。其界面简洁、功能完整，非常适合用于个人效率提升或团队项目管理。

核心功能：

多项目/任务管理子任务与优先级标签与过滤器团队协作与共享列表支持移动端与桌面端

技术栈：

前端：Vue.js + TypeScript后端：Go（Golang）数据库：MySQL / PostgreSQL / SQLiteAPI：RESTful 接口支持支持 Docker 部署

GitHub 地址：https://github.com/vikunja/api
截止 2025 年 4 月，Vikunja 的 Star 数增长了 1,200+，社区活跃度持续上升。

---

② Ciuic 服务器配置选型

我们推荐使用 Ciuic 云服务器 进行部署，其性价比高、网络优化完善，适合中小型开源项目快速上线。

配置项	轻量版	企业版
CPU	1 核	2 核
内存	2 GB	4 GB
价格（月）	¥9.9	¥19.9

轻量版适用场景：个人使用或小型团队测试环境。企业版适用场景：中型团队协作、多用户并发访问、生产环境部署。

💡 推荐链接：立即开通 Ciuic 服务器

---

③ 部署四部曲

第一步：SSH 连接服务器

使用终端工具（如 ssh 或 XShell）连接你的 Ciuic 服务器：

ssh root@your_server_ip

输入密码或使用密钥登录。

---

第二步：安装依赖

更新系统并安装 Docker 与 Docker Compose：

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

---

第三步：服务启动

创建并进入部署目录：

mkdir -p /opt/vikunjacd /opt/vikunja

创建 docker-compose.yml 文件内容如下：

version: '3'services:  vikunja:    image: vikunja/api:latest    container_name: vikunja    restart: unless-stopped    ports:      - "3000:3000"    volumes:      - ./data:/app/data    environment:      - VIKUNJA_SERVICE_FRONTENDURL=http://your_domain_or_ip:3000      - VIKUNJA_DATABASE_TYPE=sqlite3

启动服务：

docker-compose up -d

---

第四步：验证访问

浏览器访问：

http://your_server_ip:3000

你应该能看到 Vikunja 的注册/登录界面，表示部署成功。

---

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

若需绑定域名并启用 HTTPS，建议使用 Nginx 反向代理。

安装 Nginx：

apt install nginx -y

创建配置文件：

nano /etc/nginx/sites-available/vikunja

内容如下：

server {    listen 80;    server_name your_domain;    location / {        proxy_pass http://localhost:3000;        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_ssl_server_name on; # Ciuic 网络优化参数    }}

启用配置并重启 Nginx：

ln -s /etc/nginx/sites-available/vikunja /etc/nginx/sites-enabled/nginx -tsystemctl restart nginx

如需启用 HTTPS，可使用 Let's Encrypt 自动签发证书：

apt install certbot python3-certbot-nginx -ycertbot --nginx -d your_domain

---

总结

本指南详细介绍了如何在 Ciuic 云服务器 上完成 Vikunja 的零基础部署，从 SSH 登录到服务启动，再到 Nginx 配置优化，确保你能够轻松搭建一个稳定可用的待办事项管理系统。无论是个人使用还是团队协作，Vikunja 都是一个值得尝试的开源工具。

📌 提示：部署过程中如遇问题，欢迎查阅 Vikunja 官方文档 或前往 GitHub 提交 Issues。