fnOS 部署 Vikunja：Docker Compose 搭建私人待办平台与权限问题处理

前言在 NAS 上部署待办工具看起来无非就是写一份 Docker Compose、启动容器再打开浏览器注册账号。但真正开始装 Vikunja 时最容易卡住的反而不是功能配置而是挂载目录的读写权限。本文会以 fnOS 为环境从创建 Vikunja 数据目录开始配置files和db的权限再通过 Docker Compose 启动容器并把容器运行用户固定为对应 UID避免数据库和附件目录因为权限不匹配导致服务异常。部署完成后再进入 Vikunja 本身的使用流程。Vikunja 不只是简单的“打勾式待办清单”。同一套任务可以继续按项目组织设置截止时间并用于团队成员之间的任务分配和进度管理。文章中会实际创建任务、团队和项目看看它从个人待办扩展到小型项目管理以后具体怎么使用。最后还会通过 cpolar 给 3456 端口增加公网访问入口并配置固定二级子域名让部署在 NAS 上的 Vikunja 不只是在家里记任务在手机流量或异地电脑上也能继续查看和更新。这篇文章最终要完成的是一套数据留在自己 NAS、可以长期运行同时能够跨设备使用的私人任务管理平台。1.什么是VikunjaVikunja 是一款完全开源、支持私有化自托管的任务 / 项目管理工具对标付费工具 Todoist、Trello、飞书项目兼顾个人日常待办与多人团队协作最大特色是数据完全由自己掌控同时拥有现代化清爽 UI也就是前文提到的 “颜值与实力并存” 的开源待办软件Vikunja。基础技术信息开发语言后端采用 Go 语言编写前端基于 Vue.js程序轻量化、响应速度极快页面交互无长时间加载等待。开源协议采用 AGPLv3 开源协议代码完全公开可查阅无后台隐私收集、无厂商锁定你可以随时导出全部任务数据自由迁移Vikunja。部署方式官方提供一键 Docker 镜像可部署在 fnOS、群晖等 NAS、Linux 服务器、云主机默认使用 SQLite 轻量数据库大型团队可切换 MySQL/PostgreSQL。项目成熟度开发时长超 8 年2026 年初正式发布 1.0 稳定版GitHub 近 4k 星标Docker 镜像下载量超 700 万社区维护活跃Vikunja。核心功能亮点四种任务视图一套数据自由切换同一批任务支持4种可视化模式无需重复创建数据列表视图日常待办、购物清单、简单计划首选看板视图适配敏捷开发、流程跟踪对标Trello甘特图中长期项目进度规划、任务依赖管理表格视图批量筛选、编辑、导出任务数据Vikunja。完备的任务管理能力不输付费工具支持优先级、截止时间、重复周期任务、子任务分层、标签分类、文件附件上传、邮件 / 站内提醒、自定义筛选视图同时支持 CalDAV协议可与手机系统日历、备忘录双向同步任务。团队协作功能支持创建命名空间、多级子项目项目可分享给其他用户支持任务指派、操作动态记录、精细化权限管控小型团队、工作室可完全替代付费协作软件。两大使用模式自托管推荐NAS用户免费无任何功能限制所有任务、文件数据存储在你自己的NAS / 服务器中不存在第三方平台泄露、关停丢失数据的风险也是本文部署教程的核心使用方式。官方云端订阅不想自建服务的用户可选择官方托管云按月付费数据存储在欧盟合规服务器适合不想折腾部署的用户。对比商业工具的核心优势无功能付费锁Trello、Todoist 的甘特图、表格导出、多看板等高级功能均需开通会员而 Vikunja 自托管后全部功能免费开放数据主权完全自主商业工具数据存厂商服务器Vikunja 本地部署数据仅存你的硬件隐私安全性更高轻量化低资源占用Docker 单容器运行NAS 低配置硬件也能流畅运行无需高额硬件开销无广告、无强制推送界面简约清爽长期使用体验舒适。适用人群个人用户收纳生活琐事、工作计划、学习备考清单替代手机自带备忘录技术爱好者、NAS玩家fnOS、群晖自建私有服务实现数据本地存储小型团队、工作室免费完成项目分工、进度跟踪省去协作软件订阅成本。2.安装前提条件2.1ssh远程连接到飞牛开启【SSH 服务】使用终端Windows PowerShell / Mac Terminal登录在设置—SSH中开启SSH服务2.2验证docker是否开启使用命令docker-vsystemctl status-v也可以直接在飞牛主页查看其他机器也是这样的哦~3.安装Vikunja首先创建一下安装的目录并进入到该目录mkdir-p/docker/Vikunjacd/docker/Vikunjachown-R1000:1000 ./files ./dbchmod-R777./files ./db创建并编辑docker-compose.yml文件version:3services: vikunja: image: vikunja/vikunja:latest container_name: vikunja environment: -VIKUNJA_SERVICE_PUBLICURLhttp://192.168.42.147:3456 -VIKUNJA_SERVICE_SECRET45c1428dbdf63826b7b1a999e012df3b -VIKUNJA_DATABASE_PATH/db/vikunja.db ports: -3456:3456volumes: - ./files:/app/vikunja/files - ./db:/db restart: unless-stopped# 强制容器内运行用户uid1000彻底解决权限不匹配user:1000:1000启动容器dockercompose up-d部署完成后在浏览器中输入http://飞牛IP:346就能看到Vikunja的界面4.使用Vikunja4.1 登录访问首次登录要先注册账号密码注册完成后返回登录登录成功后到达主页面4.2 创建任务我们来创建第一个任务勾选前面即可分清任务完成与否为该任务设置完成时间你们还可以编辑这些4.3 创建团队也可以创建团队为了方便分配团队人员工作管理团队人员4.4 创建项目创建项目为该项目添加任务这里还有不同的形式我们通过Docker在fnOS NAS部署完成Vikunja私有待办平台后默认仅能在局域网内访问外出通勤、异地办公时无法随时查看、编辑个人任务清单而多数家庭宽带不具备公网IP手动设置路由器端口转发操作繁琐且存在安全隐患这时我们就可以搭配轻量内网穿透工具cpolar使用它无需复杂网络配置只需建立一条加密隧道就能将NAS上本地3456端口运行的Vikunja服务映射生成专属公网访问链接手机流量、外地电脑均可随时随地连接我们自建的待办系统完美解决内网服务远程访问的痛点。5.安装cpolar实现随时随地开发5.1 什么是cpolarcpolar是一款安全高效的内网穿透工具无需公网IP或复杂配置只需一条命令即可将本地服务器、Web服务或任意端口映射到公网让你随时随地远程访问内网应用特别适合开发调试、远程运维和应急部署等场景。5.2 部署cpolarcpolar 可以将你本地电脑中的服务如 SSH、Web、数据库映射到公网。即使你在家里或外出时也可以通过公网地址连接回本地运行的开发环境。❤️以下是安装cpolar步骤使用一键脚本安装命令sudocurlhttps://get.cpolar.sh|sh安装完成后执行下方命令查看cpolar服务状态如图所示即为正常启动sudosystemctl status cpolarCpolar安装和成功启动服务后在浏览器上输入虚拟机主机IP加9200端口即:【http://ip:9200】访问Cpolar管理界面使用Cpolar官网注册的账号登录,登录后即可看到cpolar web 配置界面,接下来在web 界面配置即可打开浏览器访问本地9200端口使用cpolar账户密码登录即可,登录后即可对隧道进行管理。6.配置公网地址登录cpolar web UI管理界面后,点击左侧仪表盘的隧道管理——创建隧道隧道名称可自定义本例使用了:Vikunja注意不要与已有的隧道名称重复协议http本地地址3456域名类型随机域名地区选择China Top创建成功后打开左侧在线隧道列表,可以看到刚刚通过创建隧道生成了公网地址接下来就可以在其他电脑或者移动端设备异地上使用地址访问。访问成功。7.保留固定公网地址使用cpolar为其配置二级子域名该地址为固定地址不会随机变化。点击左侧的预留选择保留二级子域名地区选择china Top然后设置一个二级子域名名称我使用的是Vikunja大家可以自定义。填写备注信息点击保留。登录cpolar web UI管理界面点击左侧仪表盘的隧道管理——隧道列表找到所要配置的隧道点击右侧的编辑。修改隧道信息将保留成功的二级子域名配置到隧道中域名类型选择二级子域名Sub Domain填写保留成功的二级子域名地区: China Top点击更新更新完成后打开在线隧道列表此时可以看到随机的公网地址已经发生变化地址名称也变成了保留和固定的二级子域名名称。最后我们使用固定的公网地址在任意设备的浏览器中访问可以看到成功访问的页面这样一个永久不会变化的二级子域名公网网址即设置好了。总结Vikunja 比普通待办清单更进一步的地方是它可以从一条简单任务逐步扩展到项目、团队和不同管理视图同时又保留了自托管的优势任务和附件数据都可以放在自己的 NAS 中。这次部署里更值得记住的其实是目录权限处理。Docker 容器能启动并不代表挂载的数据目录一定能够正常读写提前把 UID 和目录权限理顺后面的升级和长期运行会省掉不少排查时间。再通过 cpolar 增加固定公网入口以后这套部署在 fnOS 上的任务系统也可以继续用于异地办公和多设备访问。对于已经有 NAS、又不想把所有任务长期放在第三方平台的人来说Vikunja 提供的是一种比较完整的自托管选择。