Repolode
successible

successible/cleanslate

一款免费、可自托管的卡路里记录工具,专为饮食失控或难以坚持记录的人设计。

可替代:MyFitnessPalLose It!

Star
237
Fork
26
未关闭 Issue
2
最近提交
5天前

这是什么?

Clean Slate 是一款免费的卡路里记录应用,核心理念是不带评判地记录饮食。用户可以搜索并记录食物、快速添加热量和蛋白质、创建自定义食物和食谱,通过 Open Food Facts 扫描条形码,并记录运动和餐食。应用可在任何带浏览器的设备上使用。

除了使用官方托管的 cleanslate.sh 免费账户,也可以在 Linux 服务器上通过 Docker Compose 和 Caddy 自行部署,Caddy 会自动配置 HTTPS。默认认证方式为每个用户生成一个随机长令牌;如需使用 Apple、GitHub、Google 登录,则可以选择配置 Firebase,步骤相对复杂。

前端基于 React、TypeScript 和 Next.js 构建,后端使用 Hasura 与 PostgreSQL。数据通过 GraphQL API 提供访问,涵盖日志、食物、食谱、食材、运动和用户资料。

核心功能

  • 01搜索并记录食物,支持通过 Open Food Facts 扫描条形码
  • 02无需完整录入即可快速添加热量和蛋白质
  • 03创建带食材的自定义食物和食谱
  • 04记录运动和餐食
  • 05在任何带浏览器的设备上使用
  • 06通过 Docker Compose 和 Caddy 自托管并自动启用 HTTPS

适用场景

  • 希望记录饮食但不想被严格规则或负罪感束缚的人
  • 注重隐私、想在自己服务器上运行个人饮食记录工具的用户
  • 小团队共享一个基于令牌账户的自托管实例
  • 通过 GraphQL API 查询个人营养记录的开发者

快速上手

  1. 1

    克隆代码仓库

    git clone https://github.com/successible/cleanslate
  2. 2

    生成 .env 和 Caddyfile 文件

    bash configuration.sh
  3. 3

    拉取镜像并启动服务

    git pull origin main; bash deploy.sh

使用前须知

  • 自托管需要一台安装了 Docker、Docker Compose 的 Linux 服务器,以及一个支持 HTTPS 的域名。
  • Firebase 身份验证配置复杂;默认的 apiToken 登录方式更简单。

收录于专题

标签

常见问题

cleanslate 是什么?
一款免费、可自托管的卡路里记录工具,专为饮食失控或难以坚持记录的人设计。 Clean Slate 是一款免费的卡路里记录应用,核心理念是不带评判地记录饮食。用户可以搜索并记录食物、快速添加热量和蛋白质、创建自定义食物和食谱,通过 Open Food Facts 扫描条形码,并记录运动和餐食。应用可在任何带浏览器的设备上使用。
cleanslate 可以免费使用吗?用的什么许可证?
cleanslate 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
cleanslate 还在维护吗?
活跃维护中。cleanslate 最近一次提交是在 2026年11月2日。
cleanslate 适合用来做什么?
希望记录饮食但不想被严格规则或负罪感束缚的人 注重隐私、想在自己服务器上运行个人饮食记录工具的用户 小团队共享一个基于令牌账户的自托管实例 通过 GraphQL API 查询个人营养记录的开发者
cleanslate 怎么安装和运行?
克隆代码仓库: git clone https://github.com/successible/cleanslate 生成 .env 和 Caddyfile 文件: bash configuration.sh 拉取镜像并启动服务: git pull origin main; bash deploy.sh
在哪里获取 cleanslate?
源代码和安装说明在 GitHub 上:https://github.com/successible/cleanslate

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目