AFFiNEv0.27.4

Документы и визуальная доска в одном рабочем пространстве: пишите заметку, переключайтесь на холст и обсуждайте схему с командой - альтернатива связке Notion и Miro.

AFFiNE помогает держать решение и его объяснение рядом. На одной странице можно написать техническую заметку, переключиться в Edgeless и разложить ее на визуальном холсте: добавить фигуры, подписи и связи. Коллеги работают с тем же документом, а серверное рабочее пространство открывается с другого компьютера вместе с сохраненными правками.

После создания сервера установка сама поднимет приложение, базу и кеш, создаст администратора и откроет сайт по HTTPS. На проверенном сервере CPU4-RAM8-DISK100 выполнение рецепта на чистой Ubuntu заняло 4 минуты 50 секунд. Дождитесь уведомления о готовности; затем войдите в браузере и включите синхронизацию рабочего пространства по инструкции ниже.

Что внутри

AFFiNE 0.27.4, Node.js 22.23.2
редактор документов, Edgeless-доска, совместные правки и панель администратора.
PostgreSQL 16.10 с pgvector 0.8.0
пользователи, рабочие пространства и сохраненное состояние документов.
Redis 7.4.11 с AOF
кеш и служебные данные приложения с сохранением между перезапусками.
Caddy 2.10.2
внешний HTTPS-доступ и автоматическое получение и продление сертификата Let's Encrypt.
Docker Engine 29.8.2 и Compose 5.6.0 на Ubuntu 24.04 LTS
запуск стека с закрепленными версиями образов.

Постоянно работают четыре контейнера. Отдельный одноразовый контейнер выполняет миграции базы перед запуском приложения. Файлы установки и данные находятся в /opt/affine.

Безопасность

  • Администратор до открытия сайтаустановщик создает учетную запись локально, прежде чем запустить внешний HTTPS-доступ; посторонний не перехватит первый вход.
  • Закрытая регистрацияновые аккаунты создает администратор; одного знания адреса сервера недостаточно, чтобы зарегистрироваться.
  • База и приложение за CaddyPostgreSQL и Redis не публикуют порты хоста, AFFiNE слушает только 127.0.0.1:3010; наружу приложение доступно по HTTPS.
  • Фаервол и fail2banоткрыты только TCP-порты 22, 80 и 443; пять неудачных входов по SSH за десять минут приводят к блокировке IP на час.
  • Секреты с правами 0600пароль базы, файл доступов и ключ шифрования доступны только владельцу файлов; пароли и ключ сохраняются при повторной установке.
  • Ограничение внешних соединений браузераCSP разрешает обращения к этому серверу и блокирует отправку телеметрии на внешние хосты; серверные параметры GA4 оставлены пустыми.
  • Закрепленные образырецепт использует конкретные digest вместо движущегося latest, чтобы обновление апстрима не меняло установку незаметно.

Как войти

  1. Возьмите IP сервера в личном кабинете, замените точки на дефисы и добавьте .fatmetal.net. Например, IP 45.15.159.10 дает адрес https://45-15-159-10.fatmetal.net. Откройте адрес после готовности установки.

  2. Администратор уже создан: логин admin@<первоначальный адрес сервера без схемы и пути>, пароль - первоначальный пароль сервера из личного кабинета, тот же, что для SSH. Например, для адреса https://45-15-159-10.fatmetal.net логин будет admin@45-15-159-10.fatmetal.net. Самостоятельная регистрация закрыта.

  3. Нажмите значок аккаунта в боковой панели, введите почту администратора, выберите Continue with email, введите пароль и нажмите Sign in.

  4. Откройте меню текущего рабочего пространства, нажмите Enable Cloud, затем подтвердите Enable AFFiNE Sync кнопкой Enable. Этот шаг переводит локальное пространство браузера в серверное.

  5. Нажмите New Doc и напишите первую заметку. Переключитесь в Edgeless, чтобы добавить схему рядом с текстом. Проверьте страницу со второго компьютера, войдя той же учетной записью.

Важно

Для команды откройте /admin/accounts и нажмите Add User: задайте участнику имя, почту и пароль. Затем в настройках рабочего пространства создайте Invite Link. Участник входит своим аккаунтом и нажимает Request to join; владелец одобряет запрос кнопкой Approve в Members. В проверенной конфигурации интерфейс показывает лимит 10 мест на рабочее пространство; для большей команды заранее уточните условия расширения у вендора.

Для приглашений по почте и восстановления пароля подключите свой SMTP: Admin -> Settings -> Notification (/admin/settings). Укажите сервер, порт, логин, пароль и отправителя, затем нажмите Send Test Email и проверьте доставку. В установку почтовые реквизиты не включены. Адрес администратора по умолчанию служит логином, это не готовый почтовый ящик.

ИИ-функции выключены: встроенный BYOK AFFiNE 0.27.4 не получил ответ модели через прокси на стенде. Прокси к внешним API http://api-proxy.fatmetal.net:8080 входит в стоимость VPS, но подключение своего ключа в этой установке не дает готового ИИ-помощника. Для документов, доски и совместных правок ключ модели не требуется.

Браузерные обращения к сторонним API ограничены политикой connect-src в /opt/affine/Caddyfile. Если вам нужны внешние веб-интеграции, потребуется настроить эту политику под их адреса.

Настройте регулярную резервную копию: одной базы недостаточно, нужны также вложения и ключ /opt/affine/config/private.key. Для разовой копии войдите по SSH, выполните sudo -i и следующие команды; на время сохранения приложение остановится:

cd /opt/affine
umask 077
BACKUP_DIR=/root/affine-backups/$(date -u +%Y%m%dT%H%M%SZ)
mkdir -p "$BACKUP_DIR"
docker compose stop affine
docker exec affine_postgres pg_dump -U affine -d affine -Fc > "$BACKUP_DIR/database.dump"
tar -czf "$BACKUP_DIR/files.tgz" data/storage config .env compose.yml Caddyfile
docker compose up -d affine

Сохраните database.dump и files.tgz вне этого VPS. Архив содержит секреты, доступ к нему должен быть закрытым. Автоматическое расписание резервных копий установщик не создает. Журнал установки - /var/log/affine-mp.log.

Лицензия

Редактор распространяется под MIT. У серверного кода разные условия: части Community Edition - MPL-2.0, остальные части - AFFiNE EE, для использования которых в production нужны действующая подписка и соблюдение условий вендора либо отдельный договор. Это не лицензия MIT на весь стек. Перед коммерческим использованием уточните применимость условий к вашим функциям и редакции: текст лицензии серверной части. Граница CE и EE в готовом образе не установлена.

Свой домен

  1. Создайте A-запись своего домена, например notes.example.org, с публичным IP этого сервера. Дождитесь, пока DNS начнет возвращать этот IP.
  2. По SSH откройте /etc/affine-mp/params.env и задайте DOMAIN="notes.example.org", подставив собственное имя без схемы и пути. Значение ADMIN_EMAIL не меняйте.
  3. Выполните sudo /opt/affine-mp/install.sh. Скрипт обновит адрес приложения, пересоздаст AFFiNE и Caddy и получит HTTPS-сертификат для нового имени. Во время перезапуска доступ кратковременно прервется; существующие документы и доски сохранятся.
  4. Откройте https://notes.example.org. Логин остается прежним: admin@<первоначальный адрес сервера вида X-Y-Z-W.fatmetal.net>, пароль - первоначальный пароль сервера из личного кабинета, если вы его не меняли в AFFiNE. Смена домена не переименовывает администратора.

Требования

Тариф CPU4-RAM8-DISK100 - для рабочего пространства с заметками, документами и досками небольшой команды. На таком сервере четыре контейнера в простое занимали около 217 МиБ RAM; при импорте 100 Markdown-файлов наблюдавшийся общий пик составил 306 МиБ. Это память процессов контейнеров по cgroup anon, без файлового кеша; вся ОС с Docker занимает больше.

Запас тарифа позволяет начать с этой конфигурации. Если одновременно выполняемые импорты и активная работа команды приводят к нехватке памяти или постоянной загрузке процессора, выбирайте CPU6-RAM16-DISK100. Ориентируйтесь на метрики своего сервера, а не только на число созданных учетных записей.

Подробный разбор с замерами в Базе знаний →
AFFiNE990 ₽/месЗапустить →