jofoerster/habitsync

这是什么？

核心功能

• 01支持每日、每周、每月及自定义周期的习惯，也可记录负面习惯
• 02共享习惯与每月挑战，附排行榜和社区投票
• 03通过 Apprise 发送提醒、进度低于阈值的警告等通知
• 04支持 OIDC 单点登录，可配置多个身份提供方并设置用户审批
• 05可在浏览器中作为 PWA 使用，并提供 Android 应用
• 06提供带 Swagger 文档的 REST API，并可导入 Loop Habit Tracker 数据

适用场景

• 在自己的服务器上保存个人习惯记录，而非使用云端应用
• 与朋友或家人组织习惯挑战小组
• 通过 Apprise 将提醒推送到 Discord、邮件或 Home Assistant
• 借助 REST API 将习惯数据接入 Home Assistant

快速上手

1. 1

   使用 Docker 在本地启动应用

   docker run \ -p 6842:6842 \ -e BASE_URL=http://localhost:6842 \ -e 'APP_SECURITY_BASIC-AUTH-USERS_test=$2y$10$EyuJ.fL/PzCTMMKTONEquuFLxAR8SAzl9iXF2v.qDZYCh5K2m78fS' \ ghcr.io/jofoerster/habitsync:latest
2. 2

   打开 http://localhost:6842 并使用 README 中给出的用户名 test 和密码登录

3. 3

   生产环境请使用 README 中描述的 Docker Compose 配置

使用前须知

• !Android 应用仍在开发中，需要与服务器版本保持同步。
• !v0.19.0 中移动端 OIDC 重定向 URI 发生了变化，现有移动端配置可能需要更新。
• !API 尚不完整，可能会发生变化。

收录于专题

标签

常见问题

habitsync 是什么？

可自托管的习惯追踪工具，支持目标设定、好友挑战、共享习惯和 OIDC 单点登录。 HabitSync 是一个可自托管的习惯追踪工具，支持每日、每周、每月或自定义周期的习惯，也能记录需要减少的负面习惯。项目通过 Docker 部署，既可以在浏览器中以 PWA 方式使用，也提供 Android 应用。

habitsync 可以免费使用吗？用的什么许可证？

habitsync 以 BSD-3-Clause 许可证开源。用于商业产品前，请先确认许可证条款。

habitsync 还在维护吗？

半年内有更新。habitsync 最近一次提交是在 2026年8月20日。

habitsync 适合用来做什么？

在自己的服务器上保存个人习惯记录，而非使用云端应用 与朋友或家人组织习惯挑战小组 通过 Apprise 将提醒推送到 Discord、邮件或 Home Assistant 借助 REST API 将习惯数据接入 Home Assistant

habitsync 怎么安装和运行？

使用 Docker 在本地启动应用: docker run \ -p 6842:6842 \ -e BASE_URL=http://localhost:6842 \ -e 'APP_SECURITY_BASIC-AUTH-USERS_test=$2y$10$EyuJ.fL/PzCTMMKTONEquuFLxAR8SAzl9iXF2v.qDZYCh5K2m78fS' \ ghcr.io/jofoerster/habitsync:latest 打开 http://localhost:6842 并使用 README 中给出的用户名 test 和密码登录 生产环境请使用 README 中描述的 Docker Compose 配置

在哪里获取 habitsync？

源代码和安装说明在 GitHub 上：https://github.com/jofoerster/habitsync