轻量级购物清单管理应用Koffan

简介什么是 Koffan Koffan是一个免费的开源购物清单应用专为家庭和情侣设计。它允许多个设备之间实时同步让多人实时共享同一个购物清单让每个人都知道该买什么购物车里已经有哪些。解决了「谁去买」「买了没」「还要买什么」的家庭协作难题。Koffan的名字来自波兰语kochanie亲爱的发音为KOF-fan。主要特点超轻量仅16 MB磁盘占用~2.5 MB内存占用多清单支持创建多个购物清单如不同超市、不同用途可自定义图标PWA 应用可像原生应用一样安装到手机桌面离线模式无网络时也能添加和编辑商品自动同步智能补全基于历史记录的模糊搜索提醒商品分类按类别组织如生鲜、日化、冷藏已购标记标记已购买的商品不确定模式标记暂时找不到的商品实时同步WebSocket实时同步多设备同时可见响应式界面移动端优先设计深色模式跟随系统自动切换多语言支持支持PL、EN、DE、ES、FR、PT、UK、NO、LT、EL、SK、RU等语言简单登录只需一个密码无需复杂注册REST API支持程序化访问和集成开源免费基于MIT License Commons Clause开源应用场景家庭购物夫妻或家人共用一个清单一人选购其他人实时看到进度情侣共享两个人分工购物避免重复购买** roommates **合租人员共同管理生活用品采购春节采购大家庭春节采购时多人分工Koffan是一个简单好用的家庭购物协作工具特别适合不想安装复杂应用只想快速分享清单的用户。安装在群晖上以 Docker 方式安装。Koffan镜托管在ghcr.io群晖Docker套件无法直接搜索需要使用命令行安装。本文写作时latest版本对应为v2.6.1docker cli 安装如果你熟悉命令行可能用docker cli更快捷# 新建文件夹 koffan 和 子目录mkdir-p/volume1/docker/koffan/data# 进入 koffan 目录cd/volume1/docker/koffan# 运行容器dockerrun-d\--restartunless-stopped\--namekoffan\-p3852:80\-v$(pwd)/data:/data\-eAPP_PASSWORDyourpassword\ghcr.io/pansalut/koffan:latest环境变量说明APP_PASSWORD登录密码默认值为yourpassword建议修改更多的环境变量请参考官方文档 https://github.com/PanSalut/Koffan#environment-variablesdocker-compose 安装也可以用docker-compose安装将下面的内容保存为docker-compose.yml文件version:3services:koffan:image:ghcr.io/pansalut/koffan:latestcontainer_name:koffanrestart:unless-stoppedports:-3852:80volumes:-./data:/dataenvironment:-APP_PASSWORDyourpassword然后通过SSH登录到您的群晖执行下面的命令# 新建文件夹 koffan 和 子目录mkdir-p/volume1/docker/koffan/data# 进入 koffan 目录cd/volume1/docker/koffan# 将 docker-compose.yml 放入当前目录# 一键启动docker-composeup-d运行在浏览器中输入http://群晖IP:3852就能看到登录界面密码为APP_PASSWORD中设定的值登录成功后的主界面点Create shopping list创建购物清单进入购物清单点Add first section开始添加Sections现在可以开始添加需要购买的物品了点Add继续添加老苏随便加了几个注意事项修改密码默认密码过于简单务必在环境变量中设置强密码数据备份数据库文件位于/data/shopping.db定期备份多设备同步添加商品后其他设备会自动同步无需手动刷新隐私安全数据存储在本地NAS仅家人可见密码错误锁定连续5次密码错误会锁定30分钟防止暴力破解参考文档Koffan: Free shopping assistant - A fast and simple app for managing your shopping list together地址https://github.com/PanSalut/KoffanKoffan Docker Image地址https://ghcr.io/pansalut/koffanKoffan REST API Documentation地址https://github.com/PanSalut/Koffan/wiki/REST-API