### [雨云搭建 Vikunja 任务与项目管理平台](https://www.jiyueip.com/article/12302)

**Published:** 2026-07-28T10:20:26

**Author:** 斑斓助理

**Excerpt:** 用雨云 KVM 云服务器 Docker 自建 Vikunja 任务与项目管理平台：多视图任务管理、子任务与标签、到期提醒、Webhook 接 n8n 自动化，含优惠码 admin01 五折。

待办清单写在手机备忘录里、项目进度记在微信置顶、团队分工靠口头同步——信息散落在五六个地方，周会一问「那件事谁跟了」全场沉默。Vikunja 是开源的任务管理平台，把个人待办、团队项目、看板、子任务、提醒收进同一个地方，还能和日历联动。本文用雨云 KVM 云服务器把它部署成自己的任务中枢。

## 为什么选 Vikunja

商业待办工具要么免费版功能阉割、要么把你的任务数据当资产。Vikunja 把这点翻过来：

-   **多视图**：同一批任务能看列表、看板、时间线、甘特，个人和团队共用一套数据；
-   **子任务 + 标签 + 优先级**：一件「上线部署」能拆成十几个勾选项，按「紧急/本周/阻塞」标签筛选；
-   **提醒与周期**：到期前推送、重复任务自动生成，不再靠脑子记；
-   **轻量**：纯 Go 后端，1 核 1G 就能跑得很顺，不挑配置。

它和代码托管是两条线：写代码的任务、Issue 留在 [Gitea](https://www.jiyueip.com/article/12241) 里跟提交挂钩；生活杂事、团队协同的杂活交给 Vikunja，职责分得清。

## 服务器与部署

Vikunja 推荐用前后端分离的 compose（api + frontend），或官方 all-in-one 镜像更省事。个人使用 1 核 1G 足够。我用雨云 KVM 云服务器（[官网入口](https://www.jiyueip.com/link/5617)），系统 Debian 12 + Docker，下单优惠码填 **admin01** 五折，7 天无理由退款。没用过雨云的先看 [选购与上手指南](https://www.jiyueip.com/article/12235)。

all-in-one 版 `docker-compose.yml`：

```yaml
services:
  vikunja:
    image: vikunja/vikunja:latest
    container_name: vikunja
    restart: unless-stopped
    ports:
      - "127.0.0.1:3456:3456"
    environment:
      - VIKUNJA_SERVICE_TIMEZONE=Asia/Shanghai
      - VIKUNJA_SERVICE_ENABLEREGISTRATION=false
      - VIKUNJA_DATABASE_HOST=...
    volumes:
      - ./files:/app/vikunja/files
      - ./db:/db
```

几个关键项：

-   `VIKUNJA_SERVICE_TIMEZONE=Asia/Shanghai` 必须设，否则提醒、周期任务的时间全按 UTC 算，早上九点的提醒可能凌晨就响了；
-   `VIKUNJA_SERVICE_ENABLEREGISTRATION=false` 关闭公开注册，任务平台是私有的，建好账号再关；
-   首次启动访问 `/setup` 创建管理员账号，之后才能正常登录。

Nginx 反代 3456 端口配 HTTPS。若前面挂了反代，记得在反代配置里传 `X-Real-IP` / `X-Forwarded-For`，否则 Vikunja 的登录限流会按反代 IP 计算，多人共用时容易被误封。

## 日常使用姿势

-   **个人待办**：建「生活」「工作」两个项目，碎片任务随手丢进去，有空就清空列表，配合 [Memos 轻笔记](https://www.jiyueip.com/article/12263) 记灵感、用 Vikunja 跟执行，想法和落地分开；
-   **团队协同**：给成员建账号、分项目、委派任务，看板视图拖动卡片即更新状态，周会直接投看板，谁卡住一目了然；
-   **和自动化联动**：Vikunja 有 Webhook，任务状态变化可触发 [n8n 自动化工作流](https://www.jiyueip.com/article/12296)——比如「任务到期未完成」自动发群消息提醒，把任务平台接进你的通知体系；
-   **日历订阅**：在设置里生成 CalDAV/订阅链接，导入手机日历， deadlines 直接出现在日程里。

## 踩坑记录

-   **提醒时间错乱**：忘了设时区，所有定时按 UTC。补上 `VIKUNJA_SERVICE_TIMEZONE=Asia/Shanghai` 并重启后恢复。
-   **反向代理后登录被限流**：反代没透传真实 IP，Vikunja 看到的全是同一代理 IP，几次失败就触发限流锁 IP。在 Nginx 加 `proxy_set_header X-Real-IP $remote_addr;` 解决。
-   **忘了关注册**：测试时开着公开注册，后来在后台关掉。生产环境建议 compose 里直接写 `false`，别等上线再补。
-   **数据备份**：持久化目录是 `./files` 和 `./db`，打包推对象存储即可（参考 [对象存储备份实践](https://www.jiyueip.com/article/11963)），重建比重新录入任务快得多。

## 合规提醒

Vikunja 用于个人及团队合法的任务与项目管理。任务内容请勿记录受保护的敏感个人信息或商业秘密外泄内容；协作账号按需分配权限，离职成员及时停用。依据《网络安全法》《数据安全法》，团队数据应妥善保管、最小权限共享。

## 小结

任务散落各处，本质是「没有单一可信源」。Vikunja 用 1 核 1G 的代价把待办、项目、看板、提醒收进一个自托管的库：个人清空列表、团队投看板、到期有提醒、还能接 n8n 自动化。雨云 KVM 1 核 1G 起步足矣，优惠码 admin01 五折，把散在备忘录、微信、脑子里的「待办」统一收口，周会再也不用互相问「那件事跟了没」。

**Tags:** 云服务器, 建站教程, 雨云, 雨云优惠码

**Categories:** 行业洞察

---