Vikunja 是一个开源的、可以自行搭建的待办事项应用,可以在所有平台上进行组织和管理任务。Vikunja 有桌面以及安卓客户端,iOS 端还在开发中。
据开发者介绍,Vikunja 也是生活在安第斯山脉高山地区的南美洲两种野生骆驼之一,与羊驼是近亲,让人不禁想起 Python 语言的命名。
特点:
- 保持井然有序;将所有任务都组织在项目中,创建子项目,按照层次结构进行组织,并将相关的事项分组在一起
- 与同伴合作;Vikunja 让您可以轻松地与其他用户或整个团队共享项目!任务分配清楚地显示了每个人在做什么
- 灵活组织任务;您可以按照经典列表视图、甘特图、表格视图或看板方式查看您的任务,无论您需要哪种方式!
- 开源且免费
- 速度至上;我们设计 Vikunja 时注重速度,每次操作都在 100 毫秒以内完成,不再有加载旋转图标的等待, 因为一款高效的工具不应该让您感到阻碍
这篇文章帮助大家在服务器上安装 Vikunja。
1. SSH 登入服务器
这里使用一款基础的 1 CPU Core,2G RAM 的 VPS,运行 Debian 11 系统,来进行安装测试 Vikunja。
首先使用 SSH 端登入 VPS 终端。
2. 安装 Docker 与 Docker Compose
如果主机没有安装好 Docker 与 Docker Compose,可以参考这篇文章安装好 Docker 与 Docker Compose。
3. 安装 Vikunja
我们给 Vikunja 创建一个项目文件夹 /vikunja,推荐在 /home
目录下创建,
cd /home
mkdir vikunja
cd vikunja
再创建好 docker-compose.yml
文件,
touch docker-compose.yml
然后使用文本编辑器写入以下内容,
version: '3'
services:
vikunja:
image: vikunja/vikunja
environment:
VIKUNJA_SERVICE_PUBLICURL: <http://45.142>.**.**:3456
VIKUNJA_DATABASE_HOST: db
VIKUNJA_DATABASE_PASSWORD: tyooe
VIKUNJA_DATABASE_TYPE: mysql
VIKUNJA_DATABASE_USER: tyooe
VIKUNJA_DATABASE_DATABASE: tyooe
VIKUNJA_SERVICE_JWTSECRET: tyooe
ports:
- 3456:3456
volumes:
- ./files:/app/vikunja/files
depends_on:
db:
condition: service_healthy
restart: unless-stopped
db:
image: mariadb:10
command: --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci
environment:
MYSQL_ROOT_PASSWORD: tyooe
MYSQL_USER: tyooe
MYSQL_PASSWORD: tyooe
MYSQL_DATABASE: tyooe
volumes:
- ./db:/var/lib/mysql
restart: unless-stopped
healthcheck:
test: ["CMD-SHELL", "mysqladmin ping -h localhost -u $$MYSQL_USER --password=$$MYSQL_PASSWORD"]
interval: 2s
start_period: 30s
注意更改 VIKUNJA_SERVICE_PUBLICURL 里的 IP 更换成本机的 IP,将所有的 tyooe 更换成自己设置的名称或密码,其中vikunja
与db
段下的用户名与密码要保持一致。
这里可以通过 Linux 系统自带的文本编辑器 vi 打开 docker-compose.yml
,
vi docker-compose.yml
按 i
切换到编辑模式,再将上面的内容粘贴进去,完成后先按一下 esc,然后输入 :wq
保存退出;
也可以使用 FinalShell 的可视化编辑功能,双击打开 docker-compose.yml
,直接将上面的内容粘贴进去。
最后就是经典的 Docker,启动!命令,
docker-compose up -d
等待一会,打开本地浏览器输入 IP:3456 即可开始访问搭建好的 Vikunja。
4. 配置反向代理
反向代理需要一个可用的域名。
可以参考这篇文章,使用 Cloudflare Tunnel 作为反向代理工具,例如我这里使用了子域名 vikunja.044447.xyz 来访问 Vikunja。
5. Vikunja 使用
第一次打开 Vikunja,可能会遇到一个报错,提示 API 地址不可用,我们把 Vikunja URL 的域名换一下,改成这样即可,https://vikunja.044447.xyz/api/v1
,

然后再进行账号注册,

填写用户名、邮箱及密码,点击 CREATE ACCOUNT,

登录,进入首页,

在设置里可以更改时区与语言,设置 2FA 登录,导入导出 Vikunja数据,还可以使用 CalDAV 或 API 与其它应用联动。