待办事项列表应用程序Vikunja

发表于 2022-07-18 更新于 2025-10-28 分类于各种折腾 Waline：阅读次数：本文字数： 2.3k 阅读时长 ≈ 2 分钟

Vikunja 是一个开源的、自托管的待办事项列表应用程序，适用于所有平台。

杨浦区防控办昨天傍晚发布了『告杨浦居民书（二十二）』，本周一、三、五、日晚间开展全区全员核酸筛查。比上周少了 2 次，说明情况应该是有所好转。

什么是 Vikunja ？

Vikunja (/vɪˈkuːnjə/) 是一个开源的待办事项列表应用程序。你可以用 Todo 应用程序来组织你的生活。Vikunja 前端采用 Vue.js，后端采用 go，基于 AGPLv3 协议。

安装

建数据库

官方提供的 docker-compose 安装方式，需要另外安装 Mariadb 10 镜像，还是老套路，直接使用群晖自带的 Mariadb 10

在 phpMyAdmin 中创建了名为 vikunja 的空数据库。

设置文件

在群晖上以 Docker Compose 方式安装。

即使采用了群晖本身的数据库，Vikunja 依然涉及到前、后端两个镜像。

之前遇到前后端分离的项目，例如在线辅导工具 Nettu Meet、网易云播放器 YesPlayMusic 等，因为项目本身没有提供官方的镜像，当时为了容易安装，老苏把前、后端编到了一个镜像中，但这种方式并不符合微服务的软件架构，所以这次我们实践下官方提供的外部用 Nginx 做代理转发的方式，这种方式和老苏封装在里面的道理是一样的，好处是对外暴露的端口尽量的少。

原版的 nginx.conf 在这里：https://vikunja.io/docs/full-docker-example/#example-with-nginx-as-proxy

docker-compose.yml

老苏对官方的 docker-compose.yml 做了调整

version: '3'

services:
  api:
    image: vikunja/api
    container_name: vj_api
    environment:
      VIKUNJA_DATABASE_HOST: 192.168.0.197:3307
      VIKUNJA_DATABASE_TYPE: mysql
      VIKUNJA_DATABASE_USER: vikunja
      VIKUNJA_DATABASE_PASSWORD: 123456
      VIKUNJA_DATABASE_DATABASE: vikunja
    volumes: 
      - ./files:/app/vikunja/files
    restart: unless-stopped
  
  frontend:
    image: vikunja/frontend
    container_name: vj_web
    restart: unless-stopped
  
  proxy:
    image: nginx
    container_name: vj_nginx
    ports:
      - 3480:80
    volumes:
      - ./nginx.conf:/etc/nginx/conf.d/default.conf:ro
    depends_on:
      - api
      - frontend
    restart: unless-stopped

关于卷的说明如下

文件夹	装载路径	说明
`docker/vikunja/files`	`/app/vikunja/files`	存放上传文件，比如图片

环境变量参数的说明如下，需根据前面数据库设置做修改

范围	默认
`VIKUNJA_DATABASE_HOST`	数据库主机 `IP` + 端口
`VIKUNJA_DATABASE_TYPE`	数据库类型，默认设为 `mysql`
`VIKUNJA_DATABASE_USER`	数据库用户，默认设为 `vikunja`
`VIKUNJA_DATABASE_PASSWORD`	数据库密码，对应用户 `vikunja` 的密码，上面的示例用了 `123456`
`VIKUNJA_DATABASE_DATABASE`	数据库库名，默认设为 `vikunja`

nginx.conf

nginx.conf 来自官方的示例：https://vikunja.io/docs/full-docker-example/#example-with-nginx-as-proxy

这种设置不支持 gzip，官方有支持的版本，请自行修改

server {
    listen 80;

    location / {
        proxy_pass http://frontend:80;
    }

    location ~* ^/(api|dav|\.well-known)/ {
        proxy_pass http://api:3456;
        client_max_body_size 20M;
    }
}

开始安装

用 SSH 客户端登录群晖后，在命令行后执行下面的命令

# 新建文件夹 vikunja 和 子目录
mkdir -p /volume2/docker/vikunja/files

# 进入目录
cd /volume2/docker/vikunja

# 将 docker-compose.yml 和 nginx.conf 放入当前目录

# 一键启动
docker-compose up -d