Repolode
PanSalut

PanSalut/Koffan

Самостоятельно размещаемое веб-приложение для общих списков покупок с синхронизацией в реальном времени и офлайн-режимом.

Open source альтернатива:AnyListGoogle Keep

Звёзды
825
Форки
85
Открытые issues
50
Последний коммит
22 дня назад

Что это?

Koffan — лёгкое веб-приложение для совместного ведения списков покупок. Несколько человек могут редактировать одни и те же списки с разных устройств, а изменения синхронизируются в реальном времени через WebSocket — так все видят, что ещё нужно купить, а что уже в корзине.

Приложение работает в любом мобильном или десктопном браузере и устанавливается как PWA. Списки можно разбивать на разделы, например «Молочные продукты» или «Уборка», товары — отмечать как купленные или сомнительные, а автодополнение предлагает позиции из истории. Списки можно создавать, редактировать и отмечать выполненные пункты офлайн; ожидающие изменения синхронизируются после восстановления подключения.

По умолчанию используется один общий пароль. Если задать MULTI_USER=true, можно включить персональные учётные записи и отдельные рабочие пространства — тогда один сервер смогут использовать несколько домохозяйств. Бэкенд на Go хранит данные в SQLite; в проекте также есть REST API и подписанные исходящие вебхуки для интеграций.

Ключевые возможности

  • 01Синхронизация общих списков между устройствами в реальном времени через WebSocket
  • 02Создание и редактирование списков офлайн с автоматической синхронизацией после восстановления подключения
  • 03Разделы, настраиваемые значки списков и несколько списков
  • 04Автодополнение на основе истории покупок
  • 05Персональные учётные записи и отдельные рабочие пространства по желанию
  • 06REST API и подписанные исходящие вебхуки

Сценарии использования

  • Пара или семья вместе составляет общий список покупок с разных телефонов
  • Несколько домохозяйств используют один самостоятельно размещённый сервер, сохраняя отдельные списки
  • Передача товаров из списка покупок в инструменты автоматизации, например n8n или Zapier, через вебхуки
  • Использование списка офлайн в магазине с плохим сигналом

Быстрый старт

  1. 1

    Запустите Koffan в Docker с помощью команды быстрого запуска из README

    docker run -d -p 3000:8080 -e APP_PASSWORD=yourpassword -v koffan-data:/data ghcr.io/pansalut/koffan:latest
  2. 2

    Откройте http://localhost:3000 в браузере и войдите, используя пароль

Что важно знать

  • В README не указана чёткая лицензия с открытым исходным кодом, поэтому перед повторным использованием проверьте условия лицензии в репозитории.
  • Для работы офлайн Koffan нужно предоставлять по HTTPS: обычный HTTP в домашней сети такой возможности не даёт.
  • При обновлении до 2.16.0 база данных переносится на новую схему, и откат невозможен. Сначала создайте резервную копию базы данных.

В подборках

Темы

Частые вопросы

Что такое Koffan?
Самостоятельно размещаемое веб-приложение для общих списков покупок с синхронизацией в реальном времени и офлайн-режимом. Koffan — лёгкое веб-приложение для совместного ведения списков покупок. Несколько человек могут редактировать одни и те же списки с разных устройств, а изменения синхронизируются в реальном времени через WebSocket — так все видят, что ещё нужно купить, а что уже в корзине.
Koffan можно использовать бесплатно? Какая у него лицензия?
Koffan распространяется с открытым исходным кодом под лицензией Other. Перед использованием в коммерческих продуктах проверьте условия лицензии.
Koffan всё ещё поддерживается?
Активно поддерживается. Последний коммит в Koffan — 16 окт. 2026 г..
Для чего можно использовать Koffan?
Пара или семья вместе составляет общий список покупок с разных телефонов Несколько домохозяйств используют один самостоятельно размещённый сервер, сохраняя отдельные списки Передача товаров из списка покупок в инструменты автоматизации, например n8n или Zapier, через вебхуки Использование списка офлайн в магазине с плохим сигналом
Как установить Koffan?
Запустите Koffan в Docker с помощью команды быстрого запуска из README: docker run -d -p 3000:8080 -e APP_PASSWORD=yourpassword -v koffan-data:/data ghcr.io/pansalut/koffan:latest Откройте http://localhost:3000 в браузере и войдите, используя пароль
Где скачать Koffan?
Исходный код и инструкции по установке — на GitHub: https://github.com/PanSalut/Koffan

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Surmai — self-hosted планировщик поездок для одного человека или семьи: храните маршруты, бронирования и документы в одном месте и делитесь ими с другими.

290+2 за неделю26TypeScriptMITАктивно поддерживаетсяОбновлён позавчера