Repolode
streetwriters

streetwriters/notesnook-sync-server

Сервер синхронизации для приложения Notesnook, который можно развернуть на своей инфраструктуре; написан на .NET 8, поддерживает Docker, но самостоятельный хостинг пока в альфа-версии.

Звёзды
950
Форки
77
Открытые issues
29
Последний коммит
вчера

Что это?

В этом репозитории находится исходный код бэкенда синхронизации, к которому подключаются приложения Notesnook для заметок. В него входят Notesnook API, сервис идентификации и сервис обмена сообщениями для событий синхронизации в реальном времени. Все они оформлены как отдельные проекты .NET 8 в одном решении.

Проект можно собрать из исходников с помощью .NET SDK или запустить через Docker Compose: он поднимет MongoDB, Silo для совместимого с S3 файлового хранилища и сервисы Notesnook. Через профиль Compose также можно запустить дополнительные контейнеры для тем оформления, CORS-прокси и API входящих сообщений. В папке examples доступны примеры конфигурации для внешних MongoDB, Silo и Garage.

Самостоятельный хостинг возможен, но официально не поддерживается, а документация по настройке пока не готова. Начиная с версии 3.0.18 в клиентских приложениях можно указать URL собственного сервера.

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

  • 01Запускает Notesnook API, сервис идентификации и сервис обмена сообщениями как проекты .NET 8.
  • 02Поднимает весь стек через Docker Compose, включая MongoDB и хранилище Silo.
  • 03Поддерживает развертывание с внешними MongoDB, Silo или Garage — примеры конфигураций доступны в репозитории.
  • 04Позволяет подключать дополнительные сервисы тем оформления, CORS-прокси и API входящих сообщений через профиль Compose.
  • 05Позволяет клиентским приложениям Notesnook использовать URL собственного сервера начиная с версии 3.0.18.

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

  • Развернуть собственный бэкенд синхронизации Notesnook, чтобы данные заметок хранились на вашей инфраструктуре.
  • Изучать или дорабатывать реализацию сервера синхронизации на C#.
  • Проверять синхронизацию Notesnook локально через Docker Compose перед развертыванием в более широком масштабе.

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

  1. 1

    Клонируйте репозиторий

    git clone https://github.com/streetwriters/notesnook-sync-server.git
  2. 2

    Перейдите в каталог проекта

    cd notesnook-sync-server
  3. 3

    Восстановите зависимости

    dotnet restore Notesnook.sln
  4. 4

    Соберите все проекты

    dotnet build Notesnook.sln

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

  • Самостоятельный хостинг находится на стадии альфа-версии; официальной документации и поддержки пока нет.
  • Для сборки из исходного кода требуется .NET 8 SDK.
  • Для работы всего стека нужны несколько сервисов, например MongoDB и хранилище, совместимое с S3.
  • Проект распространяется по лицензии AGPL-3.0, которая требует раскрывать исходный код изменённых версий, предоставляемых по сети.

В подборках

Темы

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

Что такое notesnook-sync-server?
Сервер синхронизации для приложения Notesnook, который можно развернуть на своей инфраструктуре; написан на .NET 8, поддерживает Docker, но самостоятельный хостинг пока в альфа-версии. В этом репозитории находится исходный код бэкенда синхронизации, к которому подключаются приложения Notesnook для заметок. В него входят Notesnook API, сервис идентификации и сервис обмена сообщениями для событий синхронизации в реальном времени. Все они оформлены как отдельные проекты .NET 8 в одном решении.
notesnook-sync-server можно использовать бесплатно? Какая у него лицензия?
notesnook-sync-server распространяется с открытым исходным кодом под лицензией AGPL-3.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.
notesnook-sync-server всё ещё поддерживается?
Активно поддерживается. Последний коммит в notesnook-sync-server — 6 нояб. 2026 г..
Для чего можно использовать notesnook-sync-server?
Развернуть собственный бэкенд синхронизации Notesnook, чтобы данные заметок хранились на вашей инфраструктуре. Изучать или дорабатывать реализацию сервера синхронизации на C#. Проверять синхронизацию Notesnook локально через Docker Compose перед развертыванием в более широком масштабе.
Как установить notesnook-sync-server?
Клонируйте репозиторий: git clone https://github.com/streetwriters/notesnook-sync-server.git Перейдите в каталог проекта: cd notesnook-sync-server Восстановите зависимости: dotnet restore Notesnook.sln Соберите все проекты: dotnet build Notesnook.sln
Где скачать notesnook-sync-server?
Исходный код и инструкции по установке — на GitHub: https://github.com/streetwriters/notesnook-sync-server

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

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