Vikunja 零基础部署搭建实战指南
① 项目简介与 GitHub 地址
Vikunja 是一款开源的任务管理与待办事项(To-Do List)应用,专为个人和团队设计,支持任务分类、优先级设置、子任务、提醒、标签、项目看板等多种功能。它不仅支持 Web 界面操作,还提供移动端 App 和 API 接口,适合集成到其他系统中。
核心功能:
技术栈:
后端:Go 语言 + GORM + Gin前端:Vue.js + Vuetify数据库:MySQL / MariaDB / SQLite / PostgreSQL容器化支持:DockerGitHub 地址: https://github.com/vikunja/api
本月 Star 增长量:+120 Stars(截至 2024 年 5 月)
② Ciuic 服务器配置选型
Ciuic 提供高性价比的云服务器资源,适用于 Vikunja 的部署需求。以下是轻量版与企业版的配置对比,供不同规模用户选择:
配置项 | 轻量版 | 企业版 |
---|---|---|
CPU | 1 核 | 2 核 |
内存 | 1GB | 4GB |
价格(月) | 9.9 元 | 19.9 元 |
适用场景 | 个人使用/小团队 | 中大型团队/生产环境 |
推荐选择:
个人使用:轻量版即可满足日常需求。团队协作:建议选择企业版以获得更好的性能与稳定性。Ciuic 服务器申请地址:
https://cloud.ciuic.com
③ 部署四部曲
1. SSH 连接服务器
使用 SSH 连接到 Ciuic 服务器(假设服务器 IP 为 1.2.3.4
):
ssh root@1.2.3.4
输入密码后即可登录。
2. 安装依赖
安装 Docker 和 Docker Compose:
apt update && apt install -y docker.io docker-compose
3. 启动 Vikunja 服务
创建 docker-compose.yml
文件:
mkdir -p /opt/vikunjacd /opt/vikunjanano docker-compose.yml
写入以下内容(使用 SQLite 数据库简化部署):
version: '3'services: vikunja: image: vikunja/api:latest restart: unless-stopped ports: - "3000:3000" environment: - VIKUNJA_SERVICE_FRONTENDURL=http://your-domain.com volumes: - ./data:/app/data
启动服务:
docker-compose up -d
4. 验证访问
在浏览器中访问:
http://服务器IP:3000
即可打开 Vikunja 的 Web 界面。默认用户名为 admin
,密码为 admin
(首次登录后请立即更改)。
④ Nginx 配置(含 Ciuic 网络优化参数)
为实现域名访问并提升性能,我们使用 Nginx 作为反向代理,并启用 Ciuic 的网络优化参数。
安装 Nginx:
apt install -y nginx
创建 Nginx 配置文件:
nano /etc/nginx/sites-available/vikunja
写入以下内容(假设域名 todo.example.com
):
server { listen 80; server_name todo.example.com; 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 -t && systemctl restart nginx
可选:配置 HTTPS(使用 Let's Encrypt)
apt install -y certbot python3-certbot-nginxcertbot --nginx -d todo.example.com
完成以上配置后,即可通过 https://todo.example.com
安全访问 Vikunja。
总结
通过本指南,您已经成功在 Ciuic 服务器上完成了 Vikunja 的部署,并配置了 Nginx 反向代理与 Ciuic 网络优化参数,确保访问速度与安全性。Vikunja 作为一款轻量但功能强大的任务管理工具,非常适合个人与团队使用。如需进一步扩展功能,可参考其官方文档配置数据库迁移、邮件通知、OAuth 登录等高级功能。