基于极空间docker-compose部署个人事项管理平台脉络(社区版):一站式管理事项、执行与等待

113次阅读
没有评论

共计 4523 个字符,预计需要花费 12 分钟才能阅读完成。

先说说为什么折腾这个

用 NAS 的朋友多少都折腾过效率工具:待办清单用某云 App,日程塞在手机日历,执行计划记在笔记软件里,等别人回邮件这种「悬而未决」的事……靠脑子或者随手一条备忘。时间一长就发现,事情散落在四五个地方,每打开一个 App 都是重新熟悉一遍上下文,特别割裂。

我自己也是这个状态,所以干脆按自己的需求写了一个自用的个人事项管理平台,取名「脉络」。用了小半年,觉得确实解决了我自己的问题,就整理了个社区版分享出来——纯粹是个人需求驱动做的东西,分享给同样有这个困扰的 NAS 玩家,也想听听大家都是怎么做事项管理的。

基于极空间docker-compose部署个人事项管理平台脉络(社区版):一站式管理事项、执行与等待

脉络是什么:把「一件事的完整生命周期」装进一个页面

脉络的思路很简单:一件事从「想做」到「做完」,中间无非经历四步——记下来 → 拆解怎么干 → 排进时间 → 等待外部反馈。所以它就围着这四步建模块,没有多余的:

模块 解决什么问题
事项 记录要做的事,六种状态、优先级、标签、计划日期,支持快速新建(回车即建、连续录入)
执行路径 把事项拆成阶段和子任务,进度实时聚合,干到哪一步一目了然
时间安排 一个子任务可以挂多个执行时间段,时间归时间、任务归任务,不互相污染
首页日历 事项按日期分布,月/周双视图,自带农历和 24 节气,点格子直接建子任务
今日待办 今天/明天/等待三个标签页,勾选完成、就地改时间、就地编辑,不用跳页
等待面板 记录「在等谁、等什么、等了多久、何时再跟进」,跟进到期自动提醒
任务空间 事项按空间归属(比如「家庭」「工作」「副业」),侧栏一键切换视角
账号体系 多账号数据完全隔离,家里人各用各的,互不干扰

我最看重的是这种一站式的连贯感:新建一个事项,顺手拆好子任务,拖到日历上排期,等对方回复的部分丢进「等待」面板——全程不用切换任何其他软件。等了三天没回音?面板上「等待时长」直接告诉你该去催了。这套闭环跑起来之后,我基本卸载了之前的 todo App。

基于极空间docker-compose部署个人事项管理平台脉络(社区版):一站式管理事项、执行与等待
基于极空间docker-compose部署个人事项管理平台脉络(社区版):一站式管理事项、执行与等待
基于极空间docker-compose部署个人事项管理平台脉络(社区版):一站式管理事项、执行与等待
基于极空间docker-compose部署个人事项管理平台脉络(社区版):一站式管理事项、执行与等待

和数据安全相关的设计也说两句:数据全部存在 NAS 本地的数据库卷里,不依赖任何云服务;遥测统计默认勾选但创建账号时可以取消,不自动升级、不上传登录 IP 和账号信息;没有通用默认密码,第一次登录必须用你自己的初始化码设置账号。

部署前准备

动手前先确认三件事:

  1. 机型:当前社区版只提供 x86_64 镜像。Z4 / Z4Pro / Z2Pro(N5105 实测可用)这类 Intel 机型没问题;ARM 机型(如 Q2C、Q5 系列)暂不支持,装了也跑不起来,别浪费时间。
  2. 资源:镜像总计约 505MB,四个容器跑起来内存占用 1GB 出头,2GB 以上内存的机器比较从容。
  3. 端口:默认访问端口 8080,先确认没被占用;被占了也不用慌,下面部署时改一行映射就行。

极空间部署:三步搞定

第一步:新建 Compose 项目

极空间打开 Docker → Compose → 新建项目,项目名填 mailuo-community,把下面的完整配置粘贴进去,点创建/启动。如果界面要求选目录,选你放应用数据的目录即可。

# Mailuo Community 0.1.0-beta.1 / linux/amd64 / port 9000.
# Store this YAML in your project folder: data/ and secrets/ are created beside it.
name: ${COMPOSE_PROJECT_NAME:-mailuo}
services:
  init:
    image: registry.cn-hangzhou.aliyuncs.com/mailuo/mailuo:0.1.0-beta.1-amd64
    platform: linux/amd64
    user: "0:0"
    entrypoint: ["node", "scripts/community/init.cjs"]
    volumes:
      - ./secrets:/run/mailuo
    restart: "no"
  postgres:
    image: registry.cn-hangzhou.aliyuncs.com/mailuo/mailuo:postgres-16-alpine-amd64
    platform: linux/amd64
    restart: unless-stopped
    environment:
      POSTGRES_USER: mailuo
      POSTGRES_DB: mailuo
      POSTGRES_PASSWORD_FILE: /run/mailuo/db-password
      TZ: Asia/Shanghai
    volumes:
      - ./data:/var/lib/postgresql/data
      - ./secrets:/run/mailuo:ro
    depends_on:
      init:
        condition: service_completed_successfully
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -h 127.0.0.1 -U mailuo -d mailuo"]
      interval: 5s
      timeout: 5s
      retries: 12
  migrate:
    image: registry.cn-hangzhou.aliyuncs.com/mailuo/mailuo:0.1.0-beta.1-migrate-amd64
    platform: linux/amd64
    environment:
      CHECKPOINT_DISABLE: "1"
      PRISMA_HIDE_UPDATE_MESSAGE: "1"
    volumes:
      - ./secrets:/run/mailuo:ro
    depends_on:
      postgres:
        condition: service_healthy
    restart: "no"
  app:
    image: registry.cn-hangzhou.aliyuncs.com/mailuo/mailuo:0.1.0-beta.1-amd64
    platform: linux/amd64
    restart: unless-stopped
    ports:
      - "${MAILUO_BIND:-0.0.0.0}:${APP_PORT:-9000}:3000"
    environment:
      MAILUO_TELEMETRY_DISABLED: ${MAILUO_TELEMETRY_DISABLED:-0}
      MAILUO_TRUST_PROXY: ${MAILUO_TRUST_PROXY:-0}
      MAILUO_ENV: prod
      MAILUO_DEPLOYMENT_MODE: selfhost
      MAILUO_COOKIE_SECURE: ${MAILUO_COOKIE_SECURE:-0}
      APP_VERSION: 0.1.0-beta.1
      GIT_COMMIT: 94e6648
      TZ: Asia/Shanghai
    volumes:
      - ./secrets:/run/mailuo:ro
    depends_on:
      migrate:
        condition: service_completed_successfully
    healthcheck:
      test: ["CMD", "node", "-e", "fetch('http://127.0.0.1:3000/api/health').then(r=>{if(!r.ok)process.exit(1)}).catch(()=>process.exit(1))"]
      interval: 15s
      timeout: 5s
      retries: 5
      start_period: 20s

镜像在阿里云公开仓库,不需要登录任何账号,直接匿名拉取。如果 8080 被占用,把 ports 那行改成 "8081:3000",右边 3000 不要动。

基于极空间docker-compose部署个人事项管理平台脉络(社区版):一站式管理事项、执行与等待
基于极空间docker-compose部署个人事项管理平台脉络(社区版):一站式管理事项、执行与等待

第二步:等它自己初始化完

点启动后会依次拉起 init → postgres → migrate → app 四个容器。这里有个新手最容易误会的地方:

  • init 和 migrate 是一次性任务,跑完就退出,退出码 0 是正常的,不是失败;
  • 最终状态应该是:app 和 postgres 运行中且健康,init、migrate 已退出。

首次启动需要联网拉三个镜像,大概 505MB,快慢看网络。数据库密码和实例密钥都是启动时随机生成、存在独立的 secrets 数据卷里的,你什么都不用填。

基于极空间docker-compose部署个人事项管理平台脉络(社区版):一站式管理事项、执行与等待

第三步:设置你自己的账号

  1. 在容器列表里点开 init 服务的日志,找到这一行:

Mailuo Community setup code (keep private):,后面那串就是本实例的初始化码,复制下来。

  1. 浏览器访问 http://极空间局域网IP:8080,把初始化码填进去,再设置你自己的账号密码。
  2. 登录后有一页首次使用指引,跟着点一遍就熟悉了。

没有通用默认账号密码,初始化码只在首次设置时用一次,之后重启升级都不需要再设。密码忘了也不用怕,重置命令在下面 FAQ。

基于极空间docker-compose部署个人事项管理平台脉络(社区版):一站式管理事项、执行与等待
基于极空间docker-compose部署个人事项管理平台脉络(社区版):一站式管理事项、执行与等待

常见问题 FAQ

Q:init 或 migrate 一直重启/报错怎么办? 先看日志定位原因。最常见的是极空间 Compose 版本较老、不支持 service_completed_successfully 这类依赖条件——这种情况不要删掉 init/migrate 相关段落硬跑,先升级系统或告诉我你的机型和系统版本,我帮你看兼容写法。

Q:镜像拉取很慢或者失败? 阿里云杭州的仓库,国内网络一般不慢。反复失败的话检查极空间的 Docker 镜像源设置,或者换个时段重试。

Q:忘记密码了? 在极空间 SSH 或终端里进入项目目录,执行一条重置命令即可(会顺带让所有已登录设备下线):

docker compose run --rm -e MAILUO_PASSWORD='你的新密码' migrate node scripts/server/setup-account.cjs

Q:手机能用吗? 浏览器直接访问 http://NAS局域网IP:8080 就是响应式页面,手机平板都能正常操作,不需要装 App。

Q:想在外面访问怎么办?⚠️ 重要 可以用极空间自带的远程访问功能,但开外网访问前请把 app 服务环境变量里的 MAILUO_COOKIE_SECURE 改为 1 再重建容器,否则登录 Cookie 在公网是明文传输的,有被窃听的风险。纯局域网用保持默认的 0 就行。

更新与数据安全

  • 升级:出新版本时,把 Compose 里三个镜像 tag 换成新版本号(比如 0.1.0-beta.6-amd64),重建项目即可。项目名和 data、secrets 两个数据卷保持不动,数据库迁移会自动增量执行。
  • 备份:定期备份 data 卷(所有事项数据)和 secrets 卷(密钥)就够。切记不要执行 docker compose down -v,-v 会把数据卷一起删掉。
  • 停止/重启不会丢任何数据,放心折腾。

写在最后:聊聊你的事项管理

目前社区版是 beta 阶段(0.1.0-beta.5),功能完全免费。后续计划中的方向包括多日历源同步(126 邮箱日历、苹果日历、QQ 日历的互通)和任务时间线,都是我自己用下来的真实需求。

这篇文章发出来,一半是分享工具,另一半是想讨论一个问题:大家都是怎么做个人事项管理的? 是 GTD 全家桶,还是一个备忘录走天下?「等待别人回复」这类悬而未决的事你是怎么追踪的?欢迎在评论区聊聊你的用法和痛点,有价值的需求我会考虑排进后续版本。

相关阅读:基于极空间 docker-compose 部署个人知识库 AFFiNE

正文完
 0
评论(没有评论)
验证码