AFFiNE
Редактор на своем сервере, который объединяет заметки и визуальные схемы: текст, фигуры, связи и совместные правки. Развернули 0.27.4 на Fatmetal Cloud Server, замерили ресурсы и проверили работу двух участников.
Вердикт
- Небольшой проектной команде, которая обсуждает решение на схеме и записывает его на той же странице.
- Инженерам, которые ведут технические заметки в Markdown и хотят показывать их коллегам в браузере.
- Владельцу пространства, который готов создавать аккаунты и одобрять доступ участников.
- Для переезда сложных баз Notion или большой библиотеки досок Miro без предварительной проверки переноса.
- Если главный сценарий - готовый ИИ-помощник или большая команда без уточнения условий мест.
Заметки и схемы на одной странице
В Notion обычно записывают итоги встречи, а в Miro рисуют обсуждаемую схему. AFFiNE позволяет держать оба представления одного материала рядом: текстовая страница переключается в бесконечный холст Edgeless.
Представьте обсуждение архитектуры: участники рисуют сервер, базу и связь между ними, а рядом записывают принятое решение. Для следующей встречи достаточно открыть тот же документ.
На стенде второй участник изменил текст через браузер. Владелец увидел новый абзац без перезагрузки; отдельный клиент получил сохраненные фигуры и стрелку с сервера.
Смысл переключения в том, что схема остается рядом с объяснением. Ее не приходится экспортировать картинкой, переносить в другой сервис и каждый раз обновлять ссылку в протоколе встречи.
Что выбрать вместо Notion и Miro
Сравнивать нужно вашу работу, а не число функций. AFFiNE удобен, когда заметка и схема описывают одно решение; отдельные инструменты могут лучше закрывать самостоятельные задачи.
На 6 октября 2026 прайсы вендоров дают следующие цены за участника. Годовую оплату показываем в пересчете на месяц, без конвертации валют и налогов.
| Продукт | Основной сценарий | Прайс |
|---|---|---|
| AFFiNE self-host | Документ и холст на вашем сервере | Free до 10 мест; Team $10/мес при годовой оплате |
| Notion Plus | Страницы и базы в облаке вендора | $10/мес при годовой оплате |
| Miro Starter | Отдельные визуальные доски | $8/мес при годовой оплате |
Десять платных мест в двух сервисах дают $180 в месяц. Это ориентир бюджета двух подписок, а не доказательство, что серверная установка дешевле при любом составе команды.
Самостоятельное размещение добавляет аренду сервера, внешнюю копию данных и работу администратора. Платные места AFFiNE тоже входят в расчет: собственный VPS не отменяет условия вендора.
Для России у Notion действуют ограничения доступа и российского биллинга; Miro объявил прекращение обслуживания российских аккаунтов. Собственный сервер позволяет выбрать размещение основной базы и файлов в РФ.
Источники цен: AFFiNE, Notion, Miro. Доступность конкретного платного плана и способ оплаты уточняйте до переноса команды.
Где лежат документы и вложения
Браузер редактирует страницу и холст, а сервер хранит пользователей, роли и синхронизируемые документы. В установке работают AFFiNE, PostgreSQL, Redis и Caddy; отдельный контейнер выполняет миграции базы.
Приложение слушает только локальный порт 3010. Снаружи запросы принимает Caddy по HTTPS; PostgreSQL и Redis не публикуют порты на сервере.
Текст и состояние документов лежат в PostgreSQL. Вложения находятся в data/storage, конфигурация и ключ шифрования - в config. Поэтому одного архива папки с файлами недостаточно.
Контейнер можно заменить, не удаляя эти каталоги. После полного перезапуска стека независимый браузер прочитал импортированный документ; сохранение не зависело от буфера первого клиента.
| Часть стека | Версия |
|---|---|
| AFFiNE / Node.js | 0.27.4 / 22.23.2 |
| PostgreSQL / pgvector | 16.10 / 0.8.0 |
| Redis / Caddy | 7.4.11 / 2.10.2 |
| Docker / Compose | 29.8.2 / 5.6.0 |
Все постоянные файлы собираем под /opt/affine. Пароль базы храните в .env с правами 0600, а config/private.key включайте в защищенную резервную копию.
Какой сервер взять
Для повторения этого разбора берите CPU4-RAM8-DISK100 и Ubuntu 24.04. Четыре ядра следуют рекомендации вендора; 8 ГБ - конфигурация проверенного тарифа, а не минимальная потребность приложения.
| Память процессов контейнеров в простое | 217 МиБ |
| Контейнеры вместе с файловым кешем | 332 МиБ |
| Занятая память всей машины | 874 МиБ |
| Диск всей установленной системы | 4,1 ГиБ |
| Сумма размеров четырех образов | 1,7 ГиБ |
Показатель 217 МиБ описывает память процессов, а не весь сервер. Для выбора тарифа учитывайте также ОС, кеш и запас на одновременную работу.
По месту первым растут документы и вложения. Регулярная копия на другой компьютер или сервер защищает данные отдельно от системного диска; не считайте свободное место заменой резервированию.
Понадобятся SSH-доступ, базовые навыки Linux и домен с A-записью на IP сервера. До настройки HTTPS проверьте, что входящие TCP 80 и 443 разрешены.
Если используете сервер Fatmetal без своего имени, адрес вида IP-с-дефисами.fatmetal.net разрешается автоматически. Для собственного домена используйте обычную A-запись; сервер и браузер должны видеть одно имя.
В маркетплейсе Fatmetal
Не хотите ставить руками?
Этот стек есть в маркетплейсе Fatmetal - можно не повторять установку из этого разбора вручную. Заказываете сервер, за пару минут получаете рабочий домен, валидный TLS и файл с доступами.
Рекомендуемая конфигурация:
4 vCPU · 8 ГБ RAM · 100 ГБ NVMe от 990 ₽/мес
Развертывание на Fatmetal Cloud Server
Подготовьте чистую Ubuntu 24.04 и откройте root-сессию командой sudo -i. Ниже обычная ручная установка: официальный Compose, понятные правки и запуск без внешнего доступа.
Проверьте путь наружу
Выполняйте команды в root-сессии на чистой Ubuntu 24.04. Если проходит только меньший пакет, уменьшите MTU до скачивания пакетов.
TEST_IP=$(getent ahostsv4 dns.google | awk 'NR==1 {print $1}') if ! ping -4 -M do -s 1472 -c 1 -W 3 "$TEST_IP" && ping -4 -M do -s 1464 -c 1 -W 3 "$TEST_IP"; then ip link set dev "$(ip route get "$TEST_IP" | awk '{for(i=1;i<=NF;i++) if($i=="dev") print $(i+1)}')" mtu 1492; fiУстановите Docker
Официальный репозиторий дает Engine и плагин Compose; отдельный старый docker-compose не нужен.
apt-get update && apt-get install -y ca-certificates curl openssl install -m 0755 -d /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc . /etc/os-release printf 'deb [signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu %s stable\n' "$VERSION_CODENAME" > /etc/apt/sources.list.d/docker.list apt-get update && apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin systemctl enable --now dockerВозьмите официальный Compose
Скачайте файл релиза, закрепите образы и замените доверенную авторизацию базы паролем. Порт приложения оставьте локальным.
mkdir -p /opt/affine/config && cd /opt/affine umask 077 curl -fsSL https://raw.githubusercontent.com/toeverything/AFFiNE/v0.27.4/.docker/selfhost/compose.yml -o compose.yml printf 'POSTGRES_PASSWORD=%s\n' "$(openssl rand -hex 32)" > .env sed -i 's/:stable/:0.27.4/g; s/3010:3010/127.0.0.1:3010:3010/; s|postgresql://affine@|postgresql://affine:${POSTGRES_PASSWORD}@|; s|image: redis$|image: redis:7.4.11|; s|pgvector:pg16|pgvector:0.8.0-pg16|; s/POSTGRES_HOST_AUTH_METHOD: trust/POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}/' compose.ymlНастройте закрытое пространство
Замените ваш-домен своим именем с A-записью на сервер. Аккаунты будет создавать администратор; приглашения доступны сразу.
printf '{"server":{"externalUrl":"https://ваш-домен"},"auth":{"allowSignup":false,"newAccountShareActionDelay":0},"copilot":{"enabled":false,"byok":{"enabled":false}}}\n' > config/config.json sed -i '/AFFINE_INDEXER_ENABLED=false/a\ - DEPLOYMENT_TYPE=selfhosted\n - AFFINE_BACKEND_RUNTIME_CONFIG_PATH=/root/.affine/config/config.json' compose.yml sed -i '/container_name: affine_redis/a\ command: ["redis-server", "--appendonly", "yes"]\n volumes: ["./data/redis:/data"]' compose.yml chmod 700 config && chmod 600 .env config/config.jsonЗапустите приложение без публичного входа
Compose дождется базы и миграций. Примерно полторы минуты на стенде заняло скачивание; пустую базу не открывайте миру до создания администратора.
docker compose config --quiet docker compose --parallel 2 pull docker compose up -d curl --retry 30 --retry-all-errors --retry-delay 2 -f http://127.0.0.1:3010/ -o /dev/null
Если последняя проверка еще отвечает отказом соединения, дождитесь завершения миграций. Посмотреть их состояние можно командой docker compose ps -a; успешный affine_migration_job завершится с кодом 0.
Создайте администратора и откройте HTTPS
Сначала создайте администратора через SSH-туннель. На своем компьютере выполните команду, заменив пользователь и ваш-домен данными SSH-доступа; окно терминала оставьте открытым.
ssh -N -L 3010:127.0.0.1:3010 пользователь@ваш-доменОткройте http://localhost:3010/admin/setup в браузере и нажмите Continue. Укажите имя, почту и сильный пароль, затем нажмите Continue и завершите мастер; эта почта станет логином.
Вернитесь в root-сессию сервера и включите внешний вход. Порт 3010 остается локальным; сертификат получает только Caddy.
Подключите HTTPS после создания администратора
Caddy выпустит сертификат автоматически. Откройте TCP 80/443 в сетевых правилах и проверьте, что домен указывает на этот сервер.
cd /opt/affine cat > compose.override.yml <<'YAML' services: caddy: image: caddy:2.10.2 container_name: affine_caddy network_mode: host volumes: ['./Caddyfile:/etc/caddy/Caddyfile:ro', './data/caddy:/data', './data/caddy-config:/config'] restart: unless-stopped YAML printf 'ваш-домен {\n reverse_proxy 127.0.0.1:3010\n header Content-Security-Policy "connect-src '\''self'\'' wss://ваш-домен blob:"\n}\n' > Caddyfile chmod 600 config/private.key docker compose up -d caddy curl --retry 30 --retry-all-errors --retry-delay 2 -f https://ваш-домен/ -o /dev/null
Войдите по HTTPS: значок аккаунта, почта, Continue with email, пароль, Sign in. Затем откройте меню рабочего пространства, нажмите Enable Cloud и подтвердите Enable AFFiNE Sync.
Создайте документ и откройте его в другом браузере после входа. Если текст появился там, вы работаете с серверным пространством, а не только с локальной копией.
Добавьте коллегу и настройте почту
У сервера и рабочего пространства разные уровни доступа. Аккаунт создается в Admin → Accounts → Add User; права на конкретные документы появляются после вступления в пространство.
Создайте пользователю имя, почту и пароль. В настройках пространства получите Invite Link и передайте коллеге; тот входит своим аккаунтом и нажимает Request to join.
Владелец открывает Members и нажимает Approve. На стенде участник получил роль Collaborator и смог изменить общий документ; владельцу не пришлось давать ему права администратора сервера.
Для писем откройте Admin → Settings → Notification. Заполните SMTP-сервер, порт, логин, пароль и отправителя своего почтового сервиса, оставьте проверку TLS-сертификата включенной.
Нажмите Send Test Email и проверьте доставку в почту текущего администратора. Стенд действительно доставил тестовое письмо; успешный ответ формы сам по себе не заменяет проверку ящика.
Чтобы получить русский интерфейс, выберите Appearance → Display language → Русский. Основные действия документа и участников переведены, но отдельные подписи остаются английскими.
Как стек ведет себя с документами
На стенде импортировали через браузер 100 Markdown-документов с техническими решениями. Исходные файлы заняли 1,3 МБ; после синхронизации они читались другим участником.
| Холодное скачивание образов | 89 с |
| Старт остановленного стека до HTTPS | 33 с |
| Наблюдавшийся пик памяти процессов при импорте | 306 МиБ |
| Простой после импорта | 271 МиБ |
| Рост базы после импорта | 1,2 МБ |
| Отклик главной страницы по HTTPS | 41 мс, медиана |
Практический вывод: текстовые заметки почти не давят на проверенный сервер. Это измерение импорта, а не обещание емкости команды по числу пользователей.
Старт измерен с сохраненными данными и сертификатом. При первой установке добавятся скачивание и ваши действия в форме администратора; планируйте время на настройку домена.
Отклик главной страницы показывает загрузку начального HTML. Для работы команды полезнее другая проверка: правка коллеги появилась у владельца без перезагрузки.
База выросла меньше суммарного размера Markdown: исходные файлы и внутреннее представление документа хранятся по-разному. По этой цифре нельзя линейно рассчитать размер любой будущей библиотеки.
Проверено на версии v0.27.4, 6 октября 2026. На новых версиях результаты могут отличаться.
Где может сломаться
Причина. Редактор создал локальное пространство в браузере. Вход в аккаунт сам по себе не включает серверное хранение.
Решение. Откройте меню workspace → Enable Cloud → Enable AFFiNE Sync. Войдите вторым браузером и повторно откройте документ.
Причина. Новый аккаунт пока не может создавать ссылку приглашения: по умолчанию действует суточная задержка.
Решение. На закрытом сервере оставьте auth.newAccountShareActionDelay=0 в config/config.json и выполните docker compose restart affine. При открытии публичной регистрации верните защитную задержку.
Причина. Caddy еще получает сертификат; такой ответ появлялся на стенде до его выпуска.
Решение. Проверьте A-запись и открытые 80/443, затем прочитайте docker compose logs --tail 80 caddy. После выпуска проверьте curl -f https://ваш-домен/ без отключения проверки сертификата.
Причина. Для одного имени слишком часто выпускали сертификат заново. Такая квота сработала при повторном выделении адреса стенда.
Решение. Сохраняйте data/caddy при переустановке. Если квота уже сработала, используйте другое имя с A-записью на сервер и укажите его в server.externalUrl и Caddyfile; перезапустите affine и caddy.
Если скачивание зависло на TLS, вернитесь к проверке пакетов из первого шага. Прохождение 1464 при отказе 1472 указывает на меньший MTU; слепой повтор pull причину не исправляет.
Сохраните копию и проверьте восстановление
Копируйте базу, вложения и конфигурацию вместе. Для простой согласованной копии остановите весь стек: PostgreSQL должен завершить запись перед упаковкой своего каталога.
cd /opt/affine && umask 077
mkdir -p /root/affine-backup
docker compose down
tar czf /root/affine-backup/affine.tgz data config .env compose.yml compose.override.yml Caddyfile
docker compose up -dНа своем компьютере заберите архив. Ограничьте права файла: внутри пароль базы, документы и ключ шифрования. Не оставляйте единственную копию на системном диске.
ssh пользователь@ваш-домен "sudo cat /root/affine-backup/affine.tgz" > affine-backup.tgz
chmod 600 affine-backup.tgzДля восстановления загрузите архив в /root/affine-backup. Сохраните нынешний каталог для отката и распакуйте копию при остановленном стеке. Используйте те же версии PostgreSQL и образов.
cd /opt/affine
docker compose down
mv data "data.before-restore-$(date +%s)"
tar xzf /root/affine-backup/affine.tgz
docker compose up -dПосле восстановления войдите другим браузером и откройте прежний документ. Физическая копия сохраняет и базу, и ее исходный пароль; на новый сервер переносите всю конфигурацию вместе с данными.
Перед обновлением сохраните копию. Замените оба тега AFFiNE в compose.yml на выбранный релиз, затем выполните команды ниже; миграция должна завершиться без ошибок.
docker compose pull
docker compose up -d
docker compose ps -aЧто подключить к рабочему пространству
SMTP нужен, чтобы отправлять сообщения и восстанавливать доступ к аккаунтам. Для входа по ссылке приглашения он не обязателен, но аккаунты коллег администратор создает заранее.
Markdown-импорт подходит для библиотеки технических заметок. Выберите Import и файлы Markdown; дождитесь синхронизации, затем проверьте одну из страниц через другой аккаунт.
Для переноса сервера сохраняйте PostgreSQL, вложения и config/private.key вместе. После смены имени исправьте server.externalUrl в config/config.json и домен в Caddyfile, затем пересоздайте приложение и Caddy.
Прокси к внешним API http://api-proxy.fatmetal.net:8080 входит в VPS Fatmetal. Параметры HTTP_PROXY и HTTPS_PROXY в данном Compose не назначены; провайдера и ключ для модельного сценария выбирает клиент.
Основные заметки и доска работают без модели. Перед подключением внешнего ИИ отдельно оцените передачу содержимого документов провайдеру и ограничьте, какие материалы участники смогут ему отправлять.
Когда это НЕ ваш выбор
Переезд должен сохранить сложные материалы целиком
Если работа зависит от баз Notion, автоматизаций или инструментов фасилитации Miro, сначала перенесите образец реального материала. Проверенный Markdown и холст не доказывают совместимость всех этих сценариев.
Нужна большая команда без условий за места
Интерфейс установки показывает десять мест. Для расширения вендор предлагает Team; бюджет должен включать подписку, а не только сервер.
Нужен работающий ИИ сразу после установки
Native BYOK этой версии отказал через прокси с ошибкой transport, а напрямую - permission. В инструкции copilot выключен; готового модельного диалога этот сервер не дает.
Весь продукт должен иметь одну свободную лицензию
Редактор распространяется под MIT, backend LICENSE выделяет CE под MPL-2.0 и остальной код под AFFiNE EE. Для выбранной редакции проверьте условия правообладателя; весь сервер нельзя называть MIT.
Первый пилот проведите на заметке и схеме вашей команды. Оцените, хватает ли вам правил доступа и перевода интерфейса, прежде чем переносить общий рабочий архив.
Частые вопросы
Как убедиться, что заметка уже на сервере?
Включите Enable AFFiNE Sync и откройте URL документа в другом браузере после входа. Он должен показать тот же текст без локальных данных первого клиента.
Как добавить участника без почтового приглашения?
Создайте аккаунт через Add User, передайте Invite Link и одобрите Request to join в Members. На стенде Collaborator редактировал документ вместе с владельцем.
Можно ли держать текст и схему в одном документе?
Да. Переключите страницу в Edgeless: текст остается на холсте, рядом размещаются фигуры и соединители. Этот материал сохранился и открылся другим участником.
Куда сохраняются вложения?
В /opt/affine/data/storage. Вместе с ними сохраняйте PostgreSQL и config/private.key: одной папки вложений для восстановления недостаточно.
Зачем закреплять два образа AFFiNE?
Основной сервис и affine_migration используют одну версию. Иначе новая миграция и прежнее приложение могут оказаться несовместимыми.
Нужен ли русский язык браузера?
Нет: язык выбирается в Appearance → Display language. Переключение действует в интерфейсе AFFiNE независимо от настроек браузера.
Итог
AFFiNE подходит для командной заметки, к которой нужна живая схема: оба представления остаются одним документом. Начните с небольшой библиотеки и проверьте работу коллег на реальном материале.
На CPU4-RAM8-DISK100 сервер выдержал импорт ста заметок, а правки и холст сохранились для независимого клиента. Самостоятельная установка требует настройки администратора, синхронизации и почты; готовая карточка выполняет серверную часть автоматически.
Рекомендуемая конфигурация для установки:
4 vCPU · 8 ГБ RAM · 100 ГБ NVMe
Не хотите устанавливать вручную?
Запустите AFFiNE на этой конфигурации автоматически - от 990 ₽/мес.
Этот стек у нас запущен на тарифе CPU4-RAM8-DISK100. Нашли баг в гайде - напишите, поправим в течение дня.