Хостване на Listmonk на Managed VPS: вашите бюлетини на ваш сървър

Какво прави Listmonk

Listmonk управлява вашите пощенски списъци и бюлетини през уеб интерфейс. Това е единична програма, написана на Go, чиято единствена зависимост е PostgreSQL. Списъците му са еднопосочни: вие пишете на абонатите си, а не става дума за дискусионен списък между тях.

• Списъците: списъци с просто или двойно opt-in, до милиони абонати, и сегментиране чрез SQL изрази върху атрибутите им.
• Кампаниите: визуален редактор с влачене и пускане, WYSIWYG редактор, Markdown, HTML или чист текст, и шаблони на езика Go с над 100 функции.
• Статистиката: отваряния, кликове, отхвърлени писма и най-следваните връзки, кампания по кампания.
• Транзакционните съобщения: API за изпращане на съобщение по шаблон, например потвърждение на поръчка. „Messengers“ чрез HTTP webhook отварят и SMS или WhatsApp, за свързване с услугата по ваш избор.
• Абонатите: страница, на която всеки управлява предпочитанията си, експортира данните си или ги изтрива.
• Екипът: точни роли и разрешения, единствено влизане OIDC и ограничени API токени.
• Медиите: библиотека с изображения на диска или на хранилище, съвместимо със S3.

Какво позволява лицензът AGPL-3.0

Listmonk е публикуван с лиценз GNU AGPL версия 3. Можете да го използвате, включително във фирма, и да изпращате своите кампании и тези на клиентите си, без да купувате лиценз. Остава цената на сървъра и тази на вашата услуга за изпращане.

Член 13 добавя условие, присъщо на AGPL: ако променяте програмата, вашата версия трябва ясно да предложи на всеки, който я използва от разстояние, през мрежата, да получи безплатно изходния ѝ код. Ако разпространявате копия, прилагат се и задълженията на лиценза за споделяне на кода. Пускането на Listmonk без промяна не задейства този член.

Коя версия на Listmonk да инсталирате?

Нещо, което трябва да знаете, преди да започнете. В GitHub етикетът „Latest“ в момента сочи v7.0.0-beta.2 от 10 ноември 2026 г., която самият проект представя като бета. Последната стабилна версия е v6.2.0, която носи поправки за сигурността на разрешенията. Към 11 ноември 2026 г. образът на Docker latest сочи тази v6.2.0.

Версия 7 заменя целия административен интерфейс, променя някои от адресите му, превръща настройката app.from_email в списък от адреси и променя ключове за превод, което засяга персонализираните шаблони. Прочетете бележките към нея, преди да преминете.

Файлът Compose на проекта изпълнява --upgrade --yes при всяко стартиране: нов образ мигрира базата, без да ви пита. А мигрирана база не се чете повторно от по-стара версия и връщането назад налага възстановяване на резервно копие. С фиксиран етикет, като v6.2.0, смяната на версията остава ваше решение.

Инсталиране с Docker Compose

Проектът препоръчва Docker Compose: неговият файл стартира Listmonk и PostgreSQL заедно. На сървър с инсталиран Docker създайте папка и изтеглете този файл:

mkdir listmonk
cd listmonk
curl -LO https://github.com/knadh/listmonk/raw/master/docker-compose.yml

Проектът моли да приспособите този файл към вашата среда. Ето единствените редове, които да промените, останалото не се променя:

x-db-credentials: &db-credentials
  POSTGRES_USER: &db-user listmonk
  POSTGRES_PASSWORD: &db-password un-mot-de-passe-long
  POSTGRES_DB: &db-name listmonk

services:
  app:
    image: listmonk/listmonk:v6.2.0
    ports:
      - "127.0.0.1:9000:9000"
    hostname: listmonk.example.com

• Паролата на базата: файлът доставя listmonk като начална стойност. Сменете я преди първото стартиране, защото образът на PostgreSQL чете тази променлива само върху празна папка с данни.
• Образът: конкретна версия вместо latest, по причината, видяна по-горе.
• Порт, публикуван на 127.0.0.1: това е нашето приспособяване. Файлът на проекта публикува порт 9000 без ограничение на адреса и вече ограничава PostgreSQL до локалния адрес. Третиран по същия начин, Listmonk е достъпен само през обратния прокси.
• Името на хоста: файлът съветва пълно име на домейн.

Стартирайте после услугите, като създадете предварително акаунта Super Admin. Тези две променливи служат само при първото стартиране, а без тях акаунтът се създава при първото посещение на интерфейса: по-добре да съществува, преди да отворите домейна си.

LISTMONK_ADMIN_USER=votre-identifiant LISTMONK_ADMIN_PASSWORD=votre-mot-de-passe docker compose up -d

Без Docker: двоичният файл

Listmonk работи и като самостоятелна програма, до вашия собствен сървър PostgreSQL, версия 12 или по-нова, където базата вече е създадена.

1. Изтеглете архива на v6.2.0 от страницата с версиите на проекта, например listmonk_6.2.0_linux_amd64.tar.gz, като избягвате бетата, показвана най-отгоре, и извлечете двоичния файл.
2. Генерирайте конфигурационния файл, после въведете достъпа до базата в config.toml.
3. Инсталирайте таблиците, после стартирайте Listmonk.

./listmonk --new-config
./listmonk --install
./listmonk

По подразбиране config.toml слуша на localhost:9000, което е подходящо зад обратен прокси. Хранилището доставя файл за услуга listmonk@.service за systemd.

Размерът на сървъра

Сайтът на проекта цитира продукционна инстанция, която изпраща кампания от над 7 милиона имейла с част от ядро на процесор и пик от 57 MB памет. Той не публикува нито минимум, нито число за PostgreSQL, чийто обем расте с абонатите, отварянията и кликовете ви. На Managed VPS ни опишете как го използвате и ще ви препоръчаме подходящия размер.

HTTPS и обратният прокси

Абонатите ви кликват върху връзки, които сочат към вашата инстанция: отписване, потвърждение, проследяване на кликовете. Тя се предоставя следователно по HTTPS на собствено име на домейн. Създайте записите A и AAAA на това име към сървъра ви, където посетителите пристигат на портове 80 и 443. Документацията на Listmonk оставя избора на прокси, ето две често срещани конфигурации.

С Caddy

Caddy сам получава и подновява сертификата:

listmonk.example.com {
    reverse_proxy 127.0.0.1:9000
}

С Nginx и Certbot

Nginx по подразбиране отказва заявки над 1 MB, с грешка 413. За да внесете файл с абонати или изображения, вдигнете това ограничение според размера на файловете си:

server {
    listen 80;
    listen [::]:80;
    server_name listmonk.example.com;
    client_max_body_size 100m;

    location / {
        proxy_pass http://127.0.0.1:9000;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

След това Certbot поставя сертификата Let’s Encrypt и пренасочването към HTTPS, а после сам подновява сертификата:

sudo certbot --nginx -d listmonk.example.com

Първите настройки

Влезте в https://listmonk.example.com/admin, после отворете „Settings“:

• „General“, „Root URL“: публичният адрес на вашата инстанция, без крайна наклонена черта, като https://listmonk.example.com. Listmonk извлича от него връзките за отписване, потвърждение и проследяване във вашите имейли. Началната му стойност, http://localhost:9000, не би работила при абонатите ви.
• „General“, „Default from email“: адресът на подателя по подразбиране, на вашия домейн, вместо предоставения пример.
• „Media“, „Upload path“: /listmonk/uploads, папката, която файлът Compose монтира на сървъра.
• „General“: публичната страница за абонамент и публичният архив са активни в началото. Запазете ги, ако имате нужда от тях.
• „Security“, „Enable CAPTCHA“: изключено в началото, то защитава публичния формуляр за абонамент.

Какво остава публично и какво може да се затвори

За да филтрирате достъпа, по IP адрес или чрез прокси за удостоверяване, документацията разделя маршрутите така:

Изпращането: Listmonk минава през вашите SMTP сървъри

Listmonk подготвя и дозира имейлите ви, после ги поверява на SMTP сървърите, които декларирате в „Settings“, „SMTP“. Той не ги доставя сам до пощенските кутии на абонатите ви: качеството на доставката зависи следователно от този сървър, от вашия домейн и от вашите списъци.

За масово изпращане изберете специализирана услуга за изпращане: тя носи репутацията на изпращанията ви и подписите на домейна ви и умее да връща отхвърлените писма. От VPS на Simafri изпращането минава през удостоверено SMTP реле, на порт 587: тук, на тази услуга.

За ориентир, документацията на Listmonk описва отхвърлените писма на Amazon SES, Azure Communication Services, SendGrid, Postmark, Forward Email и Lettermint. Сравнете ги според вашия обем и получатели.

Кликнете после „Test connection“: Listmonk изпраща пробно съобщение и показва грешката на сървъра, ако изпращането пропадне. Можете да декларирате няколко сървъра, да изберете един от тях за кампания или да насочвате изпращанията според адреса или домейна на подателя.

Скоростта

Настройте я в „Settings“, „Performance“, под ограничението на вашата услуга:

• „Concurrency“ и „Message rate“: броят нишки за изпращане и съобщения в секунда за всяка. Началните стойности, 10 и 10, позволяват до 100 съобщения в секунда.
• „Batch size“: броят абонати, четени от базата при всяко преминаване, 1 000 в началото, който да е над желаната скорост. По-висок, той консумира повече памет.
• „Enable sliding window limit“: таван на съобщенията за период, полезен, когато вашата услуга брои на час.
• „Maximum error threshold“: броят грешки, след който кампанията се паузира.

Съобщение, което пропадне, се повтаря според настройката „Retries“, през други връзки на сървъра. Ако пропадне отново, Listmonk го отбелязва като грешка и продължава със следващото: следете тези грешки по време на голяма кампания.

Доставяемост, отписване и съгласие

Хостването на приложението ви оставя господар на тези теми, а те решават дали имейлите ви пристигат.

SPF, DKIM и DMARC

Изпращайте от адрес на вашия домейн и публикувайте в неговата DNS зона записите SPF и DKIM, които вашата услуга за изпращане ви дава, заедно със запис DMARC. Google изисква трите от подателите на повече от 5 000 съобщения на ден към акаунти в Gmail, с домейн на подателя, подравнен със SPF или DKIM, отписване с един клик за маркетинговите съобщения и дял на докладвания спам под 0,30 %, в идеалния случай под 0,10 %.

Отписването

• В съобщението: поставете {{ UnsubscribeURL }} в долния колонтитул на шаблона си. Тази връзка води към управлението на предпочитанията и към отписването.
• В заглавките: опцията „Include List-Unsubscribe header“ в „Settings“, „Privacy“, активна в началото, позволява на пощенските програми да предложат отписване с един клик.
• Данните: същата страница с настройки оставя на абоната правото да експортира данните си, да ги изтрие и да се включи в списък за блокиране. Тези опции са активни в началото.

Съгласието на получателите ви

Listmonk прилага типа списък, който изберете. В списък с просто opt-in абонат, добавен без потвърждение, получава кампаниите ви въпреки това. В списък с двойно opt-in той получава първо имейл за потвърждение и само потвърдените абонати получават кампаниите ви. Това е изборът, който най-добре защитава репутацията ви при изпращане и който пази ясна следа от съгласието.

Правилата зависят от държавата на получателите ви. Във Франция, например, CNIL изисква предварително съгласие на частните лица, чрез положително действие, като неотметнато предварително квадратче, с изключение за вашите клиенти за сходни продукти или услуги. Между професионалисти проучването може да се основава на легитимен интерес, ако засяга тяхната професия. Във всички случаи всяко съобщение идентифицира подателя и предлага лесен начин за отказ от следващите.

Пишете само на хора, които очакват съобщенията ви. Купен или стар списък вдига отхвърлените писма и докладите за спам, а последиците понася вашият домейн.

Проследяването на отварянията и кликовете

Пикселът за проследяване и проследяването на кликовете засягат личния живот и документацията моли да се използват при спазване на правила като GDPR. По подразбиране това проследяване не е свързано с всеки абонат: опцията „Individual subscriber tracking“ го свързва, а „Disable tracking“ го изключва напълно, в „Settings“, „Privacy“.

Отхвърлените писма

Да продължавате да пишете на адрес, който отхвърля съобщенията ви, уврежда репутацията ви при изпращане. Обработката на отхвърлените писма е изключена в началото: включете я в „Settings“, „Bounces“, после изберете един от тези два пътя.

• Webhook на вашата услуга за изпращане: включете „Enable bounce webhooks“ и опцията на вашата услуга. Listmonk получава отхвърлените писма на SES, Azure Communication Services, SendGrid, Postmark, Forward Email и Lettermint на адрес като https://listmonk.example.com/webhooks/service/ses, като последната дума се сменя според услугата. Този адрес трябва да остане публичен.
• Пощенска кутия POP3: Listmonk чете повторно кутия, която получава отхвърлените писма, тази на адреса на подателя или специална кутия. Той отгатва тогава типа на отхвърленото писмо по съдържанието на съобщението и смята за леко това, което не разпознава.

За специална кутия декларирайте я като адрес за връщане в „Settings“, „SMTP“, „Custom headers“:

[
  {"Return-Path": "your-bounce-inbox@example.com"}
]

Началните настройки са тези, които документацията дава за SES, и те са добра основа:

PostgreSQL, единствената зависимост

Listmonk изисква PostgreSQL 12 или по-нов. Файлът Compose носи postgres:17-alpine, с данните му в тома на Docker listmonk-data. Абонати, кампании, шаблони, статистика и повечето настройки живеят там; в конфигурацията остават само достъпът до базата и адресът за слушане.

За да насочите към съществуващ сървър PostgreSQL, променете променливите LISTMONK_db__host, LISTMONK_db__port, LISTMONK_db__user, LISTMONK_db__password и LISTMONK_db__database на услугата app.

Listmonk е създаден за големи списъци. С нарастването на базата тя може да забави интерфейса: с милиони абонати таблото и броячите могат да се показват десетки секунди. Проектът съветва тогава два действия:

• „Cache slow database queries“, в „Settings“, „Performance“: броячите се изчисляват на равни интервали, всяка нощ в 3 ч. по подразбиране.
• VACUUM ANALYZE върху голяма база, например всяка седмица. Командата блокира заявките за времето на преминаването си, като цяло няколко секунди.

docker compose exec db psql -U listmonk -d listmonk -c 'VACUUM ANALYZE;'

Резервни копия и обновления

Два елемента съставляват вашата инстанция: базата PostgreSQL и папката uploads, ако изображенията ви остават на диска. pg_dump прави съгласуван експорт, без да спира Listmonk и без да блокира другите достъпи до базата:

docker compose exec -T db pg_dump -U listmonk listmonk > listmonk-$(date +%F).sql
tar -czf listmonk-uploads-$(date +%F).tar.gz uploads

За да възстановите, спрете Listmonk, изпразнете базата, после заредете наново експорта. Както уточнява документацията, това действие изтрива базата на място:

docker compose stop app
docker compose exec db psql -U listmonk -d listmonk -c 'DROP SCHEMA public CASCADE; CREATE SCHEMA public;'
docker compose exec -T db psql -U listmonk -d listmonk < listmonk-2026-11-01.sql
docker compose start app

Обновяване

1. Прочетете бележките към новата версия: Listmonk ви сигнализира за новите версии в интерфейса си, а някои носят поправки за сигурността.
2. Експортирайте базата, както проектът изисква преди всяко обновяване.
3. Сменете етикета на образа в docker-compose.yml.
4. Изпълнете командите от документацията. Файлът Compose мигрира базата при стартиране.

docker compose down app
docker compose pull
docker compose up app -d

С двоичния файл спрете Listmonk, заменете двоичния файл, изпълнете ./listmonk --upgrade, после го стартирайте наново. За да се върнете към по-ранна версия, възстановете експорта, направен преди обновяването, после върнете стария етикет.

Кой какво прави на Managed VPS

Самостоятелното хостване изисква да поддържате сървъра освен приложението. На Managed VPS нашите екипи поемат сървъра и следят проактивно вашата инстанция; Listmonk остава ваш софтуер, с неговите настройки, вашите списъци и вашите кампании.

Ако предпочитате нашите екипи да се намесват в самото приложение, тази услуга се фактурира на час или на фиксирана цена, с оферта, съобщена преди намесата.