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, чтобы обновление апстрима не меняло установку незаметно.
Как войти
Возьмите IP сервера в личном кабинете, замените точки на дефисы и добавьте
.fatmetal.net. Например, IP45.15.159.10дает адресhttps://45-15-159-10.fatmetal.net. Откройте адрес после готовности установки.Администратор уже создан: логин
admin@<первоначальный адрес сервера без схемы и пути>, пароль - первоначальный пароль сервера из личного кабинета, тот же, что для SSH. Например, для адресаhttps://45-15-159-10.fatmetal.netлогин будетadmin@45-15-159-10.fatmetal.net. Самостоятельная регистрация закрыта.Нажмите значок аккаунта в боковой панели, введите почту администратора, выберите Continue with email, введите пароль и нажмите Sign in.
Откройте меню текущего рабочего пространства, нажмите Enable Cloud, затем подтвердите Enable AFFiNE Sync кнопкой Enable. Этот шаг переводит локальное пространство браузера в серверное.
Нажмите 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 в готовом образе не установлена.
Свой домен
- Создайте
A-запись своего домена, напримерnotes.example.org, с публичным IP этого сервера. Дождитесь, пока DNS начнет возвращать этот IP. - По SSH откройте
/etc/affine-mp/params.envи задайтеDOMAIN="notes.example.org", подставив собственное имя без схемы и пути. ЗначениеADMIN_EMAILне меняйте. - Выполните
sudo /opt/affine-mp/install.sh. Скрипт обновит адрес приложения, пересоздаст AFFiNE и Caddy и получит HTTPS-сертификат для нового имени. Во время перезапуска доступ кратковременно прервется; существующие документы и доски сохранятся. - Откройте
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. Ориентируйтесь на метрики своего сервера, а не только на число созданных учетных записей.