关于 GanCook

完整项目名：Gloridust/GanCook

「今天谁做饭？」「吃啥？」——干饭厨子把这两个每天都要吵一遍的问题，变成一件温馨小事。

前一天晚上自动开好明天的饭局，家人各自点菜，谁掌勺谁认领，吃完打个分；月底还能在贡献墙上看看这个月是谁在默默下厨。专为家庭设计，不依赖任何云服务，数据全在你自己的 NAS 上。

特性功能

🚀 真·开箱即用 —— 一条 docker run 跑起来，无需配置任何环境变量，密钥首启自动生成并持久化。
🗄️ 单容器 + SQLite —— 没有外部数据库、没有云依赖，备份只需复制一个 data 目录。
👨‍👩‍👧 一账号多角色 —— 注册不分身份，人人都能做饭、点菜；做饭人按「每一餐」认领（「我来做这顿」）。
👆 选头像登录 —— 共享设备上无需打字，点自己的头像再输 6 位密码即可（像选用户头像）。
⏰ 自动饭局（像设闹钟） —— 在后台自由增删多条规则：餐次、时间、提前多久开、提前多久截止、生效星期都可自定义。到点自动开局、截止自动进入做饭、用餐后自动完成。
🌱 贡献墙 —— GitHub 风格热力图，谁做饭最勤、谁最会点菜，绿格子一目了然。
🖼️ 图片不拖后腿 —— 头像/菜品上传自动裁剪压缩（≤2MB）转 WebP 落盘（告别 base64 进库），加载飞快。
🥛 牛奶布艺 UI —— 柔和拟物 + 青菜绿，移动端优先，可作为 PWA 添加到主屏。
🌍 中英双语 —— 登录页与「我的 · 设置」一键切换。
🔄 升级无痛 —— 拉新镜像即可，数据库自动迁移，登录态不丢；管理员还能在网页端一键更新（需挂载 Docker 套接字，否则降级为手动指引）。

部署流程

以威联通NAS为例，通过Docker Compose的方式进行部署。

部署代码如下：

services:
  gancook:
    image: ghcr.io/gloridust/gancook:latest
    # 或者 gloridust/gancook:latest
    container_name: gancook
    restart: unless-stopped
    ports:
      - '3333:3000'
    volumes:
      # 数据目录（SQLite + 上传图片）。备份只需复制 ./data
      - /share/Container/gancook/data:/data
      
      # Docker 套接字：启用「家庭管理 → 关于与更新」的网页端一键更新（默认开启）
      # 容器内会让非root的app用户加入套接字所属组来访问；权限/路径不符时会自动
      # 降级为「显示手动更新命令」。若你的环境没有 Docker 守护进程或不想要此功能，删掉这行即可。
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      # 全部可选。开箱即用，无需配置任何密钥（首次启动自动生成并持久化到 ./data）。
      TZ: Asia/Shanghai

打开威联通的Container Station，创建新的应用程序。

截屏2026-09-07 14.25.22.png