Хостване на wallabag на Managed VPS: списъкът ви за четене на ваш сървър

Хостването на wallabag на Managed VPS означава, че статиите, които запазвате за по-късно, остават на ваша собствена машина, която нашите екипи поддържат актуална и наблюдават денем и нощем. wallabag е свободно приложение с отворен код за отложено четене, с лиценз MIT. Това ръководство следва официалната му документация и Docker образа му, във версия 2.6.17: инсталиране с Docker Compose, първият акаунт и тайните, HTTPS, приложенията и разширенията за браузъра, импортът от Pocket и други услуги, имейлът, резервните копия и обновленията.

Simon Vasconcelos Lee Автор: Публикувано на 18 ноември 2026 г.Време за четене: 14 минути

Всички ръководства

Накратко

  1. Лицензът MIT позволява свободно да използвате, променяте и разпространявате wallabag, във фирма и другаде, стига да запазите бележката за авторските права.
  2. Инсталирайте го с Docker Compose: официалният образ wallabag/wallabag, MariaDB, Redis и уеб портът, публикуван на 127.0.0.1 зад обратен прокси с HTTPS.
  3. Преди първото стартиране задайте SYMFONY__ENV__SECRET и публичния си адрес в SYMFONY__ENV__DOMAIN_NAME; после сменете паролата на акаунта wallabag, която е wallabag.
  4. Обратният прокси изпраща X-Forwarded-Proto: https: така wallabag знае, че посетителите му идват през HTTPS.
  5. Архивирайте базата данни, тома с изображенията и своя compose.yaml, после обновявайте, като смените етикета на образа и изпълните миграциите.

Какво прави wallabag

wallabag е уеб приложение за отложено четене: запазвате страница с едно щракване и я четете, когато имате време. README го обобщава така: щракнете, запазете, прочетете, когато пожелаете. wallabag извлича съдържанието на статията, така че изскачащите прозорци на оригиналната страница не ви разсейват.

Какво позволява лицензът MIT

wallabag е публикуван с лиценза MIT, с авторски права на Nicolas Lœuillet от 2013 г. Той дава безплатно правото да използвате, копирате, променяте, сливате, публикувате, разпространявате, преотстъпвате и продавате копия на софтуера. Можете следователно да го пускате за себе си, за екипа си или за клиентите си, без да купувате лиценз.

Единственото условие е да запазите бележката за авторските права и текста на лиценза във всички копия или съществени части на софтуера. Текстът предоставя софтуера „такъв, какъвто е“, без гаранция.

Ресурсите, които да предвидите

Документацията на wallabag не дава число за паметта или процесора. Тя все пак изброява от какво се нуждае приложението, а Docker образът задава няколко стойности, които помагат при оразмеряването:

Размерът на сървъра зависи следователно от броя на потребителите, обема на статиите и импортите ви. На Managed VPS ни разкажете как го използвате и ще ви препоръчаме подходящия размер.

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

Хранилището wallabag/docker публикува официалния образ wallabag/wallabag в Docker Hub и в GitHub Container Registry, с примерен файл Compose: wallabag, база данни MariaDB и Redis. На сървър с инсталиран Docker създайте папка и поставете в нея този compose.yaml, базиран на този пример:

compose.yaml
services:
  wallabag:
    image: wallabag/wallabag:2.6.17
    restart: unless-stopped
    environment:
      - MYSQL_ROOT_PASSWORD=root-password
      - SYMFONY__ENV__DATABASE_DRIVER=pdo_mysql
      - SYMFONY__ENV__DATABASE_HOST=db
      - SYMFONY__ENV__DATABASE_PORT=3306
      - SYMFONY__ENV__DATABASE_NAME=wallabag
      - SYMFONY__ENV__DATABASE_USER=wallabag
      - SYMFONY__ENV__DATABASE_PASSWORD=database-password
      - SYMFONY__ENV__DATABASE_CHARSET=utf8mb4
      - SYMFONY__ENV__SECRET=random-secret-string
      - SYMFONY__ENV__DOMAIN_NAME=https://read.example.com
      - SYMFONY__ENV__MAILER_DSN=smtp://user:password@smtp.example.com:587
      - SYMFONY__ENV__FROM_EMAIL=read@example.com
      - SYMFONY__ENV__TWOFACTOR_SENDER=read@example.com
    ports:
      - "127.0.0.1:8080:80"
    volumes:
      - wallabag-images:/var/www/wallabag/web/assets/images
    depends_on:
      - db
      - redis
  db:
    image: mariadb
    restart: unless-stopped
    environment:
      - MYSQL_ROOT_PASSWORD=root-password
    volumes:
      - wallabag-db:/var/lib/mysql
    healthcheck:
      test: ["CMD", "/usr/local/bin/healthcheck.sh", "--innodb_initialized"]
      interval: 20s
      timeout: 3s
  redis:
    image: redis:alpine
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 20s
      timeout: 3s

volumes:
  wallabag-images:
  wallabag-db:

Сменете трите тайни стойности преди първото стартиране. Шестнадесетичните низове работят навсякъде, включително в SQL командите, които образът пише, за да създаде базата данни:

Терминал
openssl rand -hex 32
docker compose up -d
docker compose logs -f wallabag

За да проверите дали приложението отговаря, направете заявка към маршрута, който използва проверката на състоянието на образа:

Терминал
curl http://127.0.0.1:8080/api/info

Образът прочита отново променливите SYMFONY__ENV__* при всяко стартиране на контейнера и изчиства кеша. След като промените compose.yaml, docker compose up -d пресъздава контейнера и прилага новите настройки.

Със SQLite или PostgreSQL

Без Docker

Пътят, който документацията препоръчва на самостоятелен сървър, е Git хранилището и неговият Makefile, с Composer, инструмента make и PHP разширенията от страницата с изисквания:

Терминал
git clone https://github.com/wallabag/wallabag.git
cd wallabag && make install

След това уеб сървърът обслужва папката web, с app.php като входна точка: страницата за виртуалните хостове дава конфигурации за Nginx, Apache, Caddy и lighttpd. Нейните примери обслужват wallabag в корена на домейн или поддомейн, конфигурацията, която поддържащите проекта поддържат.

Първият акаунт, тайните и регистрациите

Инсталирането създава администраторски акаунт, чиито потребителско име и парола са wallabag, с адрес wallabag@wallabag.io. Сменете ги, преди да отворите инстанцията за публиката. SSH тунел довежда порт 8080 на сървъра до вашия компютър, на http://localhost:8080; добавете -p и SSH порта, показан в клиентската ви зона.

Терминал, на вашия компютър
ssh -L 8080:127.0.0.1:8080 user@read.example.com
  1. Влезте с wallabag и wallabag.
  2. В „Config“, раздел „Password“, изберете нова парола от поне 8 знака.
  3. В раздела „User information“ заменете имейл адреса със своя: на него идват връзките за смяна на паролата.
  4. В същия раздел включете двуфакторното удостоверяване. Документацията препоръчва приложение за еднократни кодове, като FreeOTP, вместо кода, изпратен по имейл; wallabag предлага и резервни кодове.
ПроменливаСтойност по подразбиранеЗа какво служи
SYMFONY__ENV__SECRETПубличен низ, еднакъв за всички инстанцииДобавя ентропия към операциите по сигурността: документацията иска той да е уникален за вашата инстанция
SYMFONY__ENV__DOMAIN_NAMEhttps://your-wallabag-instance.wallabag.orgПълният адрес на инстанцията ви, без наклонена черта в края
SYMFONY__ENV__FOSUSER_REGISTRATIONfalse в Docker образаОтваря или затваря публичната регистрация
SYMFONY__ENV__FOSUSER_CONFIRMATIONtrueИзпраща имейл за потвърждение при всяка регистрация
SYMFONY__ENV__LOCALEenЕзикът по подразбиране на инстанцията, например fr
SYMFONY__ENV__SERVER_NAMEYour wallabag instanceИмето на инстанцията, показвано в приложението ви за двуфакторно удостоверяване

С Docker образа публичната регистрация следователно е затворена. За да отворите инстанцията за екипа си, създайте акаунтите сами от „Users management“ или отворете регистрацията, докато хората се регистрират, с потвърждение по имейл.

По-чувствителните настройки са в „Internal Settings“, запазени за администратора на инстанцията: публичното споделяне на статии, форматите за експорт, влизането в сайтове с платен достъп, локалното изтегляне на изображения и импортите на заден план.

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

Контейнерът обслужва wallabag по HTTP, на своя порт 80, чрез вътрешен Nginx. HTTPS се поема от обратния прокси пред него. Този вътрешен Nginx чете заглавката X-Forwarded-Proto: когато тя е https, той казва на PHP, че заявката е шифрована, и wallabag изгражда връзките и бисквитките си съобразно това.

С Caddy

Caddy сам получава сертификата Let’s Encrypt и го подновява. Директивата му reverse_proxy запазва заглавката Host и по подразбиране добавя X-Forwarded-For, X-Forwarded-Proto и X-Forwarded-Host:

Caddyfile
read.example.com {
  reverse_proxy 127.0.0.1:8080
}

С Nginx

Този блок използва заглавките от примера за Nginx в README на Docker образа, добавя заглавката Host и ограничението за качване на образа и слуша на порт 80, за да остави на Certbot да постави HTTPS:

Блок на Nginx
server {
    listen 80;
    listen [::]:80;
    server_name read.example.com;
    client_max_body_size 100M;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Host $server_name;
        proxy_set_header X-Forwarded-Proto https;
        proxy_set_header X-Forwarded-For $remote_addr;
    }
}
Терминал
sudo nginx -t
sudo certbot --nginx

След това проверете дали SYMFONY__ENV__DOMAIN_NAME съдържа адреса с https://, същия като този на проксито ви.

Приложения, разширения за браузъра и RSS емисии

wallabag работи в браузъра, а проектът публикува също приложения и разширение, които се свързват с инстанцията ви по нейния адрес, без наклонена черта в края.

ИнструментЗа какво служиОт какво се нуждае
Приложението за AndroidСинхронизира списъците ви със статии и ги показва на телефона виАдресът на инстанцията, потребителското ви име и паролата ви; приложението само извлича данните за достъп до емисиите
Приложението за iOSПоказва статиите ви на iPhone и iPadАдресът, ID и тайна на API клиент, потребителското ви име и паролата ви
Разширението wallabagger, за Firefox и ChromeЗапазва отворената страница, с етикетите ѝ, отбелязана със звезда или архивиранаАдресът, ID и тайна на API клиент, потребителското ви име и паролата ви
Букмарклетът „bag it!“Запазва отворената страница от лентата с отметкиНищо: плъзгате го от страницата „Howto“

Импорт на статиите ви от Pocket и от други услуги

Менюто „Import“ внася статиите ви от друга услуга. wallabag изтегля отново съдържанието на всяка статия, което отнема време при голям експорт. Инструментите за импорт във версия 2.6.17:

УслугаФайлът, който да предоставите
Pocket, експорт CSVZIP архивът на експорта от Pocket, след разархивиране: CSV файл с име като part_000000.csv
Pocket, експорт HTMLHTML файлът от по-стария експорт на Pocket, като ril_export.html
InstapaperCSV файлът от страницата с настройки на Instapaper
OmnivoreФайловете metadata_x_to_y.json от разархивирания експорт, един по един
Pinboard, DeliciousТехният експорт JSON
ShaarliНеговият експорт HTML
Firefox, ChromeJSON резервното копие на отметките от Firefox или файлът Bookmarks на Chrome
Readability, elCuratorТехният експорт
wallabag 1.x или 2.xЕкспортът JSON от друга инстанция

Версия 2.6.17 носи и поправка на импорта CSV от Pocket. Съществува и импорт през API на Pocket, с ключ за разработчици, който администраторът задава в конфигурацията.

Големи импорти на заден план

За да не задържа голям импорт страницата, wallabag го предава на Redis, който compose.yaml по-горе вече осигурява:

  1. В „Internal Settings“, раздел „Import“, включете Redis със стойност 1.
  2. Стартирайте импорта от менюто „Import“: wallabag поставя статиите в опашка.
  3. Стартирайте обработващия процес (worker) за избрания тип импорт, например pocket_csv; той обработва опашката, после продължава да слуша, докато го спрете.
Терминал, в папката на compose.yaml
docker compose run --rm wallabag import pocket_csv

Другите типове са pocket, readability, instapaper, wallabag_v1, wallabag_v2, firefox и chrome.

Имейл: конфигурацията на SMTP

wallabag изпраща имейли за потвърждение на регистрацията, за смяна на паролата и за двуфакторните кодове по имейл. Изпраща ги през сървъра, описан в SYMFONY__ENV__MAILER_DSN, който по подразбиране е smtp://127.0.0.1.

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

compose.yaml, услугата wallabag
      - SYMFONY__ENV__MAILER_DSN=smtp://read%40example.com:password@smtp.example.com:587
      - SYMFONY__ENV__FROM_EMAIL=read@example.com
      - SYMFONY__ENV__TWOFACTOR_SENDER=read@example.com

След това пресъздайте контейнера с docker compose up -d и тествайте с връзката „Forgot your password?“ от страницата за вход.

Резервните копия

Страницата за резервните копия в документацията посочва три елемента: настройките, базата данни и изображенията. С Docker образа ето къде се намира всеки от тях:

ЕлементКъде се намираКак да го копирате
НастройкитеВашият compose.yaml: образът изгражда от него parameters.yml при всяко стартиранеКопие на файла, пазено на сигурно място, защото съдържа тайните ви
Базата данниТомът wallabag-dbЕкспорт с mariadb-dump
ИзображениятаТомът wallabag-images, монтиран на web/assets/imagesАрхив на папката
Терминал, в папката на compose.yaml
docker compose exec -T db sh -c 'exec mariadb-dump -uroot -p"$MYSQL_ROOT_PASSWORD" wallabag' > wallabag-$(date +%F).sql
docker compose exec -T wallabag tar -czf - -C /var/www/wallabag/web/assets images > wallabag-images-$(date +%F).tar.gz
cp compose.yaml compose-$(date +%F).yaml

Планирайте тези копия и ги изпращайте извън сървъра. Поставени на диска му, тези архиви влизат и в нощните му резервни копия. Със SQLite документацията моли да копирате папката data/db.

Възстановяване

При нова инсталация стартирайте стека със същия compose.yaml, после заредете обратно базата данни и изображенията:

Терминал
docker compose exec -T db sh -c 'exec mariadb -uroot -p"$MYSQL_ROOT_PASSWORD" wallabag' < wallabag-2026-11-18.sql
docker compose exec -T wallabag tar -xzf - -C /var/www/wallabag/web/assets < wallabag-images-2026-11-18.tar.gz

Всеки потребител може също да експортира статиите си в JSON, от списъка „All entries“, и да ги импортира отново в друга инстанция с инструмента за импорт wallabag 2.x. За администраторите командата wallabag:export експортира статиите на даден потребител във файл.

Обновленията

С Docker сменете етикета на образа в compose.yaml, направете резервно копие, после изтеглете новия образ и пресъздайте контейнера. След това README моли да изпълните миграциите на базата данни, когато дадена версия носи такива:

Терминал, в папката на compose.yaml
docker compose pull
docker compose up -d
docker compose exec --user nobody wallabag php bin/console doctrine:migrations:migrate --env=prod --no-interaction

Прочетете бележките към всяка версия преди обновяване: те посочват стъпките, специфични за тази версия, като папката за изпразване във версия 2.6.16.

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

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

ТемаНашите екипиВие
СървърътОбновления на системата и на сигурността, включително намеси на сървъраМоментът, който пасва на вашата дейност
НаблюдениетоСървър, следен денонощно, 7 дни в седмицата, с намеса, без да се чака обаждането виЧетенето на журналите на вашата инстанция
wallabagПроактивно проследяване: грешки, забавяния, базата данни и дисковото пространство се откриват, препоръчва се корекцияИнсталирането, обновяванията и настройките му, които прилагате вие или вашият AI асистент
Акаунтите и статиитеСървърът, който ги носи, наблюдаван и архивиранПотребителите, регистрацията, API клиентите и импортите
Резервните копияВсяка нощ, криптирани и пазени извън машината; възстановяването е включеноЕкспортите на самия wallabag и заявката за възстановяване, когато ви потрябва
МиграциятаСегашният ви сървър е мигриран, безплатноМоментът на превключването

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

wallabag, на сървър, поддържан вместо вас

С Managed VPS от Simafri нашите екипи поддържат актуален сървъра на вашата инстанция на wallabag, наблюдават го денем и нощем и се намесват, без да чакат обаждането ви; те следят проактивно и вашата инстанция и ви препоръчват полезните корекции, които прилагате вие или вашият AI асистент. Резервните копия се криптират всяка нощ и се пазят извън машината, възстановяването им е включено, а миграцията от сегашния ви сървър е безплатна.

Разгледайте Managed VPS

Често задавани въпроси

Безплатен ли е wallabag?

Да. wallabag е с лиценз MIT: можете да го използвате, променяте и разпространявате, във фирма и другаде, без да купувате лиценз, стига да запазите бележката за авторските права. Остава цената на сървъра, на който работи.

Как се инсталира wallabag с Docker Compose?

Започнете от примерния compose.yaml на образа wallabag/wallabag, с MariaDB и Redis. Задайте SYMFONY__ENV__SECRET, паролите и адреса си в SYMFONY__ENV__DOMAIN_NAME, публикувайте порта на 127.0.0.1, после изпълнете docker compose up -d и поставете пред него обратен прокси с HTTPS.

Какви са данните за достъп по подразбиране на wallabag?

Инсталирането създава администратор, чиито потребителско име и парола са wallabag. Сменете паролата в Config, раздел Password, и имейл адреса в User information, преди да отворите инстанцията за публиката.

Как се импортират статиите от Pocket в wallabag?

Разархивирайте ZIP файла на експорта от Pocket: той съдържа CSV файл като part_000000.csv. В менюто Import изберете Pocket CSV и качете този файл. След това wallabag изтегля съдържанието на всяка статия; при голям експорт включете Redis във вътрешните настройки.

Кои приложения работят с wallabag?

Проектът публикува приложения за Android и iOS и разширението wallabagger за Firefox и Chrome, които се свързват с инстанцията ви по нейния адрес, без наклонена черта в края. За iOS и за wallabagger е нужен API клиент, създаден в API clients management.

Защо връзките на wallabag остават на http зад прокси?

Образът чете заглавката X-Forwarded-Proto, за да знае, че заявката е през HTTPS. Накарайте проксито си да я изпраща със стойност https, заедно със заглавката Host на вашия домейн, и поставете адреса с https:// в SYMFONY__ENV__DOMAIN_NAME.

Как се архивира wallabag?

Копирайте три елемента: базата данни, с mariadb-dump за MariaDB, тома с изображенията, монтиран на web/assets/images, и своя compose.yaml, който съдържа настройките и тайните. Изпращайте тези копия извън сървъра.

Покрива ли Managed VPS wallabag?

Managed VPS покрива сървъра: система, сигурност, наблюдение и резервни копия. Нашите екипи следят проактивно и вашата инстанция и ви препоръчват полезните корекции, които прилагате вие. Намеса в самото приложение се фактурира на час или на фиксирана цена.

Източници и официална документация

Свързани ръководства

Хостване на FreshRSS на Managed VPS: RSS емисиите ви на ваш сървърХостването на FreshRSS на Managed VPS означава вие и екипът ви да четете RSS емисиите си от своя собствена машина, която нашите екипи поддържат актуална и наблюдават денем и нощем. FreshRSS е свободен софтуер с лиценз AGPL-3.0. Това ръководство следва официалната му документация: инсталиране с Docker Compose, HTTPS, опресняване на емисиите, акаунти и влизане, API за мобилните приложения, база данни, резервни копия и обновления.Резервни копия на VPS: какво да проверите, преди да подпишетеПочти всяко предложение за VPS обявява „включени резервни копия“. Зад тези думи може да стои копие всяка нощ, пазено извън машината и възстановявано от експерти, или моментна снимка, поставена на същия диск като сървъра. Това ръководство дава въпросите, които правят разликата, какво означава всеки отговор и как да проверите, че едно резервно копие наистина се възстановява.Разлика между управляван и неуправляван VPS: кой какво правиРазликата между управляван и неуправляван VPS се свежда до един въпрос: кой се грижи за сървъра, след като той вече работи. Думата „управляван“ обаче няма официално определение и от един хостинг доставчик до друг обхваща всичко от простото инсталиране на системата до цялостното стопанисване на сървъра. Това ръководство показва кой какво прави, ред по ред, заедно с междинното ниво на експертното съдействие, и дава въпросите, които премахват двусмислието, преди да подпишете.
Свържете се с нас