Хостването на wallabag на Managed VPS означава, че статиите, които запазвате за по-късно, остават на ваша собствена машина, която нашите екипи поддържат актуална и наблюдават денем и нощем. wallabag е свободно приложение с отворен код за отложено четене, с лиценз MIT. Това ръководство следва официалната му документация и Docker образа му, във версия 2.6.17: инсталиране с Docker Compose, първият акаунт и тайните, HTTPS, приложенията и разширенията за браузъра, импортът от Pocket и други услуги, имейлът, резервните копия и обновленията.
Автор: Simon Vasconcelos Lee
Публикувано на 18 ноември 2026 г.Време за четене: 14 минути
wallabag/wallabag, MariaDB, Redis и уеб портът, публикуван на 127.0.0.1 зад обратен прокси с HTTPS.SYMFONY__ENV__SECRET и публичния си адрес в SYMFONY__ENV__DOMAIN_NAME; после сменете паролата на акаунта wallabag, която е wallabag.X-Forwarded-Proto: https: така wallabag знае, че посетителите му идват през HTTPS.compose.yaml, после обновявайте, като смените етикета на образа и изпълните миграциите.wallabag е уеб приложение за отложено четене: запазвате страница с едно щракване и я четете, когато имате време. README го обобщава така: щракнете, запазете, прочетете, когато пожелаете. wallabag извлича съдържанието на статията, така че изскачащите прозорци на оригиналната страница не ви разсейват.
wallabag е публикуван с лиценза MIT, с авторски права на Nicolas Lœuillet от 2013 г. Той дава безплатно правото да използвате, копирате, променяте, сливате, публикувате, разпространявате, преотстъпвате и продавате копия на софтуера. Можете следователно да го пускате за себе си, за екипа си или за клиентите си, без да купувате лиценз.
Единственото условие е да запазите бележката за авторските права и текста на лиценза във всички копия или съществени части на софтуера. Текстът предоставя софтуера „такъв, какъвто е“, без гаранция.
Документацията на wallabag не дава число за паметта или процесора. Тя все пак изброява от какво се нуждае приложението, а Docker образът задава няколко стойности, които помагат при оразмеряването:
memory_limit на 256 MB, а променливата PHP_MEMORY_LIMIT я променя.Размерът на сървъра зависи следователно от броя на потребителите, обема на статиите и импортите ви. На Managed VPS ни разкажете как го използвате и ще ви препоръчаме подходящия размер.
Хранилището wallabag/docker публикува официалния образ wallabag/wallabag в Docker Hub и в GitHub Container Registry, с примерен файл Compose: wallabag, база данни MariaDB и Redis. На сървър с инсталиран Docker създайте папка и поставете в нея този 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
127.0.0.1: примерът от хранилището публикува порт 80 на контейнера без адрес, а тогава Docker го отваря на всички адреси на сървъра. Публикуван локално, той е достъпен само през обратния прокси.MYSQL_ROOT_PASSWORD образът създава базата данни и нейния потребител, после изпълнява wallabag:install, която създава таблиците и акаунта wallabag. Редът wallabag is ready! в журнала отбелязва края.wallabag; услугата db я запазва.wallabag-db пази базата данни, wallabag-images изображенията на статиите. Примерът в документацията за инсталиране също използва именувани томове.redis.2.6.17, 2.6, 2 и latest. Пълната версия ви позволява да изберете кога да стане всяко обновяване.За да проверите дали приложението отговаря, направете заявка към маршрута, който използва проверката на състоянието на образа:
curl http://127.0.0.1:8080/api/info
Образът прочита отново променливите SYMFONY__ENV__* при всяко стартиране на контейнера и изчиства кеша. След като промените compose.yaml, docker compose up -d пресъздава контейнера и прилага новите настройки.
/var/www/wallabag/data/db/wallabag.sqlite; в този случай монтирайте том на /var/www/wallabag/data.SYMFONY__ENV__DATABASE_DRIVER=pdo_pgsql, порт 5432, както и POSTGRES_USER и POSTGRES_PASSWORD, за да създаде образът базата данни. Версия 2.6.15 на образа поправя собствеността на базата данни с PostgreSQL 15 и по-нови.POPULATE_DATABASE=False, после я инициализирайте веднъж с docker compose exec --user nobody wallabag php bin/console wallabag:install --env=prod -n. README моли да изпълните тази команда като nobody, за да не остават файлове, притежавани от root.Пътят, който документацията препоръчва на самостоятелен сървър, е 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
wallabag и wallabag.| Променлива | Стойност по подразбиране | За какво служи |
|---|---|---|
SYMFONY__ENV__SECRET | Публичен низ, еднакъв за всички инстанции | Добавя ентропия към операциите по сигурността: документацията иска той да е уникален за вашата инстанция |
SYMFONY__ENV__DOMAIN_NAME | https://your-wallabag-instance.wallabag.org | Пълният адрес на инстанцията ви, без наклонена черта в края |
SYMFONY__ENV__FOSUSER_REGISTRATION | false в Docker образа | Отваря или затваря публичната регистрация |
SYMFONY__ENV__FOSUSER_CONFIRMATION | true | Изпраща имейл за потвърждение при всяка регистрация |
SYMFONY__ENV__LOCALE | en | Езикът по подразбиране на инстанцията, например fr |
SYMFONY__ENV__SERVER_NAME | Your wallabag instance | Името на инстанцията, показвано в приложението ви за двуфакторно удостоверяване |
С Docker образа публичната регистрация следователно е затворена. За да отворите инстанцията за екипа си, създайте акаунтите сами от „Users management“ или отворете регистрацията, докато хората се регистрират, с потвърждение по имейл.
По-чувствителните настройки са в „Internal Settings“, запазени за администратора на инстанцията: публичното споделяне на статии, форматите за експорт, влизането в сайтове с платен достъп, локалното изтегляне на изображения и импортите на заден план.
Контейнерът обслужва wallabag по HTTP, на своя порт 80, чрез вътрешен Nginx. HTTPS се поема от обратния прокси пред него. Този вътрешен Nginx чете заглавката X-Forwarded-Proto: когато тя е https, той казва на PHP, че заявката е шифрована, и wallabag изгражда връзките и бисквитките си съобразно това.
X-Forwarded-Proto: проксито трябва да я изпраща със стойност https.Host: вашето име на домейн, за да сочат пренасочванията на приложението към него.Caddy сам получава сертификата Let’s Encrypt и го подновява. Директивата му reverse_proxy запазва заглавката Host и по подразбиране добавя X-Forwarded-For, X-Forwarded-Proto и X-Forwarded-Host:
read.example.com {
reverse_proxy 127.0.0.1:8080
}
Този блок използва заглавките от примера за Nginx в README на Docker образа, добавя заглавката Host и ограничението за качване на образа и слуша на порт 80, за да остави на Certbot да постави HTTPS:
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://, същия като този на проксито ви.
wallabag работи в браузъра, а проектът публикува също приложения и разширение, които се свързват с инстанцията ви по нейния адрес, без наклонена черта в края.
| Инструмент | За какво служи | От какво се нуждае |
|---|---|---|
| Приложението за Android | Синхронизира списъците ви със статии и ги показва на телефона ви | Адресът на инстанцията, потребителското ви име и паролата ви; приложението само извлича данните за достъп до емисиите |
| Приложението за iOS | Показва статиите ви на iPhone и iPad | Адресът, ID и тайна на API клиент, потребителското ви име и паролата ви |
| Разширението wallabagger, за Firefox и Chrome | Запазва отворената страница, с етикетите ѝ, отбелязана със звезда или архивирана | Адресът, ID и тайна на API клиент, потребителското ви име и паролата ви |
| Букмарклетът „bag it!“ | Запазва отворената страница от лентата с отметки | Нищо: плъзгате го от страницата „Howto“ |
Менюто „Import“ внася статиите ви от друга услуга. wallabag изтегля отново съдържанието на всяка статия, което отнема време при голям експорт. Инструментите за импорт във версия 2.6.17:
| Услуга | Файлът, който да предоставите |
|---|---|
| Pocket, експорт CSV | ZIP архивът на експорта от Pocket, след разархивиране: CSV файл с име като part_000000.csv |
| Pocket, експорт HTML | HTML файлът от по-стария експорт на Pocket, като ril_export.html |
| Instapaper | CSV файлът от страницата с настройки на Instapaper |
| Omnivore | Файловете metadata_x_to_y.json от разархивирания експорт, един по един |
| Pinboard, Delicious | Техният експорт JSON |
| Shaarli | Неговият експорт HTML |
| Firefox, Chrome | JSON резервното копие на отметките от Firefox или файлът Bookmarks на Chrome |
| Readability, elCurator | Техният експорт |
| wallabag 1.x или 2.x | Експортът JSON от друга инстанция |
Версия 2.6.17 носи и поправка на импорта CSV от Pocket. Съществува и импорт през API на Pocket, с ключ за разработчици, който администраторът задава в конфигурацията.
За да не задържа голям импорт страницата, wallabag го предава на Redis, който compose.yaml по-горе вече осигурява:
1.pocket_csv; той обработва опашката, после продължава да слуша, докато го спрете.docker compose run --rm wallabag import pocket_csv
Другите типове са pocket, readability, instapaper, wallabag_v1, wallabag_v2, firefox и chrome.
wallabag изпраща имейли за потвърждение на регистрацията, за смяна на паролата и за двуфакторните кодове по имейл. Изпраща ги през сървъра, описан в SYMFONY__ENV__MAILER_DSN, който по подразбиране е smtp://127.0.0.1.
На VPS на Simafri конфигурирайте SMTP сървър с удостоверяване, на порт 587 или 465: пощенската услуга на домейна ви или услуга за изпращане. Документацията дава формата на един ред, с потребител, парола, сървър и порт:
- 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
@ става %40. Ако кодиран знак спре стартирането, документацията предлага да удвоите знака за процент: %%40.FROM_EMAIL е подателят на всички имейли на wallabag, TWOFACTOR_SENDER е подателят на двуфакторните кодове. Използвайте адрес на вашия домейн, от който SMTP сървърът ви приема да се изпраща.:465 в края на реда.След това пресъздайте контейнера с docker compose up -d и тествайте с връзката „Forgot your password?“ от страницата за вход.
Страницата за резервните копия в документацията посочва три елемента: настройките, базата данни и изображенията. С Docker образа ето къде се намира всеки от тях:
| Елемент | Къде се намира | Как да го копирате |
|---|---|---|
| Настройките | Вашият compose.yaml: образът изгражда от него parameters.yml при всяко стартиране | Копие на файла, пазено на сигурно място, защото съдържа тайните ви |
| Базата данни | Томът wallabag-db | Експорт с mariadb-dump |
| Изображенията | Томът wallabag-images, монтиран на web/assets/images | Архив на папката |
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 моли да изпълните миграциите на базата данни, когато дадена версия носи такива:
docker compose pull
docker compose up -d
docker compose exec --user nobody wallabag php bin/console doctrine:migrations:migrate --env=prod --no-interaction
var/import, а бележките към версията молят да изпразните старата папка web/uploads/import. В този compose.yaml тази папка се намира в контейнера: контейнерът, създаден от новия образ, стартира без нея.make update, която на инстанции с 2.6.15 или по-стара версия избираше алфа версия, публикувана същата сутрин. За инсталация от Git, която е останала блокирана, бележките към версията дават поправката: git checkout 2.6.17 --force, после make update.make update, която изпълнява и миграциите и изчиства кеша.Прочетете бележките към всяка версия преди обновяване: те посочват стъпките, специфични за тази версия, като папката за изпразване във версия 2.6.16.
Самостоятелното хостване изисква да поддържате сървъра освен приложението. На Managed VPS нашите екипи поемат сървъра и следят проактивно вашата инстанция; wallabag остава ваш софтуер, с неговите настройки и вашите статии.
| Тема | Нашите екипи | Вие |
|---|---|---|
| Сървърът | Обновления на системата и на сигурността, включително намеси на сървъра | Моментът, който пасва на вашата дейност |
| Наблюдението | Сървър, следен денонощно, 7 дни в седмицата, с намеса, без да се чака обаждането ви | Четенето на журналите на вашата инстанция |
| wallabag | Проактивно проследяване: грешки, забавяния, базата данни и дисковото пространство се откриват, препоръчва се корекция | Инсталирането, обновяванията и настройките му, които прилагате вие или вашият AI асистент |
| Акаунтите и статиите | Сървърът, който ги носи, наблюдаван и архивиран | Потребителите, регистрацията, API клиентите и импортите |
| Резервните копия | Всяка нощ, криптирани и пазени извън машината; възстановяването е включено | Експортите на самия wallabag и заявката за възстановяване, когато ви потрябва |
| Миграцията | Сегашният ви сървър е мигриран, безплатно | Моментът на превключването |
Ако предпочитате нашите екипи да се намесват в самото приложение, тази услуга се фактурира на час или на фиксирана цена, с оферта, съобщена преди намесата.
С Managed VPS от Simafri нашите екипи поддържат актуален сървъра на вашата инстанция на wallabag, наблюдават го денем и нощем и се намесват, без да чакат обаждането ви; те следят проактивно и вашата инстанция и ви препоръчват полезните корекции, които прилагате вие или вашият AI асистент. Резервните копия се криптират всяка нощ и се пазят извън машината, възстановяването им е включено, а миграцията от сегашния ви сървър е безплатна.
Да. wallabag е с лиценз MIT: можете да го използвате, променяте и разпространявате, във фирма и другаде, без да купувате лиценз, стига да запазите бележката за авторските права. Остава цената на сървъра, на който работи.
Започнете от примерния compose.yaml на образа wallabag/wallabag, с MariaDB и Redis. Задайте SYMFONY__ENV__SECRET, паролите и адреса си в SYMFONY__ENV__DOMAIN_NAME, публикувайте порта на 127.0.0.1, после изпълнете docker compose up -d и поставете пред него обратен прокси с HTTPS.
Инсталирането създава администратор, чиито потребителско име и парола са wallabag. Сменете паролата в Config, раздел Password, и имейл адреса в User information, преди да отворите инстанцията за публиката.
Разархивирайте ZIP файла на експорта от Pocket: той съдържа CSV файл като part_000000.csv. В менюто Import изберете Pocket CSV и качете този файл. След това wallabag изтегля съдържанието на всяка статия; при голям експорт включете Redis във вътрешните настройки.
Проектът публикува приложения за Android и iOS и разширението wallabagger за Firefox и Chrome, които се свързват с инстанцията ви по нейния адрес, без наклонена черта в края. За iOS и за wallabagger е нужен API клиент, създаден в API clients management.
Образът чете заглавката X-Forwarded-Proto, за да знае, че заявката е през HTTPS. Накарайте проксито си да я изпраща със стойност https, заедно със заглавката Host на вашия домейн, и поставете адреса с https:// в SYMFONY__ENV__DOMAIN_NAME.
Копирайте три елемента: базата данни, с mariadb-dump за MariaDB, тома с изображенията, монтиран на web/assets/images, и своя compose.yaml, който съдържа настройките и тайните. Изпращайте тези копия извън сървъра.
Managed VPS покрива сървъра: система, сигурност, наблюдение и резервни копия. Нашите екипи следят проактивно и вашата инстанция и ви препоръчват полезните корекции, които прилагате вие. Намеса в самото приложение се фактурира на час или на фиксирана цена.
Simafri
Да поговорим за Вашия проект
Кажете ни с няколко думи от какво имате нужда: отговаряме Ви бързо.
Благодарим! Вашето запитване е изпратено. Ще се свържем с вас скоро.
Предпочитате имейл? Пишете ни на support@simafri.com.