x4121/taskd

Docker-Taskd

https://hub.docker.com/r/x4121/taskd 是容器化的 Taskwarrior 服务器镜像，用于快速搭建任务同步服务。

镜像概述

该镜像提供Taskwarrior服务的容器化部署方案，帮助个人或团队实现跨设备任务同步与管理，支持自动生成自签证书及用户权限配置。

核心功能

1. 自动生成自签证书（当./taskd/pki目录无密钥时）
2. 支持用户与组的创建、管理
3. 提供客户端同步所需的证书生成工具
4. 兼容Docker和docker-compose两种部署方式

使用场景

• 个人跨设备任务同步管理
• 团队内部任务协作与状态同步

配置说明

前置要求

• 已安装Docker
• 已安装docker-compose

启动服务器

用docker-compose启动

首次启动前，请确认证书配置或检查docker-compose.yml中的证书参数：

bash
docker-compose up -d

记录启动时输出的容器ID（记为$container）。

不用docker-compose启动

bash
docker run -d --name taskd \
  -p 53589:53589 \
  -v $PWD/taskd:/var/taskd \
  -e CERT_CN="taskd" \
  -e CERT_ORGANIZATION="some org" \
  -e CERT_COUNTRY="DE" \
  -e CERT_STATE="Bavaria" \
  -e CERT_LOCALITY="Munich" \
  x4121/taskd:latest

停止服务器

bash
docker-compose stop

创建用户

为$username（允许空格）创建账号，加入$group组（无空格），生成$user前缀（无空格）的密钥：

进入容器终端

bash
docker exec -it $container sh

创建组（若需新组）

bash
taskd add org '$group'

添加用户到组

bash
taskd add user '$group' '$username'

复制输出的New user key: $cred用于客户端配置。

生成用户密钥

bash
cd pki
gosu taskd ./generate.client $user

密钥文件位于./taskd/pki目录。

客户端配置

将ca.cert.pem、$user.cert.pem、$user.key.pem复制到客户端，编辑.taskrc：

bash
task config taskd.certificate $pathTo/$user.cert.pem
task config taskd.key $pathTo/$user.key.pem
task config taskd.ca $pathTo/ca.cert.pem
task config taskd.server $host:53589
task config taskd.credentials $group/$username/$cred

初始化同步

bash
task sync init

后续同步用task sync命令。

参考文档

Taskwarrior官方文档