Wallabag安装与使用-自建网页收藏服务-手机APP和浏览器离线保存网页
平时在上网的时候,我们经常会将有用的网页收藏在浏览器的收藏夹中,但是这样作存在两个问题:一是当url失效时自己辛苦保存的网页就直接无法打开了,二是当你更换浏览器时或者换了电脑后,你的原有的收藏夹的数据就可能无法恢复了。
为了解决此类问题,我们非常有必要搭建一个在线网页收藏服务,可以随时保存我们的所要收藏的网页。Wallabag是一个开源免费的自建网页收藏服务的程序,它不仅仅可以实现收藏和保存任意网页,还可以将收藏的网页生成RSS订阅源,让在RSS阅读器查看。

当然,Wallabag也提供了免费的手机APP和浏览器扩展,方便你在电脑PC上和手机浏览网页时收藏和离线保存网页。这篇文章就来分享一下Wallabag安装和使用方法,更多的自建服务和实用工具,你可以查看:
- EMBY自建个人影音播放系统-使用免费开源Emby打造个人影视媒体库
- 自建免费在线思维导图工具-用Docker安装draw.io在线思维导图程序
- RSSHub给不支持RSS网站制作RSS订阅源-支持B站,知乎,微博,豆瓣,今日头条
PS:2026年11月16日更新,修正Docker持久化与反代示例、手动安装Web根目录和root绕过建议,补充PHP兼容、默认密码及完整备份。
PS:更新记录。
1、我们在写文章或者制作海报时经常要用到图片,搜索引擎找来的图片都是有水印或者是不能随便用的,这里分享十个免费高清无版权的图库网站:十大免费高清图库网站-免费图片素材网站推荐-无版权可商用的图片。2021.10.6
一、Wallabag安装准备
网站:
- 官网:https://wallabag.org/
- 项目:https://github.com/wallabag/wallabag
- 镜像: https://hub.docker.com/r/wallabag/wallabag/
1.1 安装准备
准备一个VPS。Wallabag可以安装在虚拟主机上,也可以安装在VPS主机,但是建议大家安装在VPS主机上,因为有些虚拟主机不一定可以满足Wallabag对PHP的要求。关于VPS主机参考:VPS主机排行榜单。
准备一个域名。想要长期使用Wallabag,必须要有自己的域名,而且不要使用免费域名。关于域名注册请参考:域名服务。
1.2 配置Nginx
配置Nginx是为了反代Wallabag,这样可以实现域名+SSL的访问形式,建议使用LNMP一键包或者Oneinstack来快速安装Nginx,同时如果你的网站是用了BT宝塔面板,也可以直接开启反代的。相关教程:
二、Docker快速安装
2.1 Docker快速运行
如果你的VPS主机已经有了docker环境(关于Docker环境搭建可以参考:安装Docker部署。),直接使用Docker+Nginx反代的策略来搭建Wallabag。官方的镜像给出了多种运行方式,这里有一个最简单的运行就是使用SQLite,代码如下:
docker pull wallabag/wallabag:2 docker run --name wallabag --restart=unless-stopped -d \ -v /opt/wallabag/data:/var/www/wallabag/data \ -v /opt/wallabag/images:/var/www/wallabag/web/assets/images \ -p 127.0.0.1:8080:80 \ -e SYMFONY__ENV__DOMAIN_NAME=https://wallabag.example.com \ -e SYMFONY__ENV__SECRET=REPLACE_WITH_YOUR_RANDOM_SECRET \ wallabag/wallabag:2
以上是新建SQLite实例的例子,先把域名换成自己的外部HTTPS地址,并用openssl rand -hex 32生成随机值替换SECRET,之后保持不变。端口只绑定本机127.0.0.1供同机Nginx反代,不必向公网开放8080。两个持久化目录都要保留;已有同名容器或数据库时先备份并按升级文档处理,不能当成全新实例重复初始化。初始账号若为wallabag/wallabag,首次登录立即修改。
2.2 Nginx反代域名
对于Docker来说,反向绑定域名可以变得更简单:Nginx反向绑定域名管理工具-无需修改Nginx规则一键添加反向绑定域名。2022.10.20更新
Nginx反代:下例将自己的域名解析到服务器,准备对应证书,再转发到127.0.0.1:8080。DOMAIN_NAME须与浏览器使用的完整外部地址一致;不要继续使用原例中相互混杂的mima、wallbag域名。证书路径也要替换,下面是配置示例,不是本站现网配置。
使用宝塔面板,直接在后台添加网站,做好DNS解析,绑定自己的域名,在后台给域名申请好SSL证书。 最后,直接在宝塔面板的网站管理中添加反代即可。如下图:

使用Oneinstack或者LNMP一键包的朋友使用命令添加虚拟机或者绑定好域名,然后添加反向代@理。反向配置方法和Bitwarden自建密码存储系统图文教程绑定域名反代类似,主要调整你的反代部分,如下:
server {
listen 80;
server_name wallabag.example.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
server_name wallabag.example.com;
ssl_certificate /实际证书路径/fullchain.pem;
ssl_certificate_key /实际证书路径/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
三、Wallabag手动安装
3.1 准备PHP环境
不想使用docker环境,并且自己的服务器已经安装好了LNMP环境,希望Wallabag与其它的网站共存,这时采用手动安装方法是最合适的。首先,请先查看Wallabag对建站环境的要求:
https://doc.wallabag.org/admin/installation/requirements/
对于Oneinstack,最主要的是安装好Composer。Oneinstack已经提供了一键安装方法了,直接调用Oneinstack安装包的附加组件即可安装好Composer。

Wallabag在安装的过程中会自动检测你的PHP是否满足要求,如果你出现如下错误,就表示你没有配置好tidy。
Your lock file does not contain a compatible set of packages. Please run composer update.
Problem 1
- Root composer.json requires PHP extension ext-tidy * but it is missing from your system. Install or enable PHP's tidy extension.
Problem 2
- j0k3r/graby is locked to version 2.2.5 and an update of this package was not requested.
- j0k3r/graby 2.2.5 requires ext-tidy * -> it is missing from your system. Install or enable PHP's tidy extension.
To enable extensions, verify that they are enabled in your .ini files:
- /usr/local/php/etc/php.ini
- /usr/local/php/etc/php.d/02-opcache.ini
- /usr/local/php/etc/php.d/03-imagick.ini
- /usr/local/php/etc/php.d/05-memcached.ini
- /usr/local/php/etc/php.d/05-redis.ini
You can also run `php --ini` inside terminal to see which files are used by PHP in CLI mode.
PHP Warning: require(/root/wallabag/bin/../vendor/autoload.php): failed to open stream: No such file or directory in /root/wallabag/bin/console on line 15
PHP Fatal error: require(): Failed opening required '/root/wallabag/bin/../vendor/autoload.php' (include_path='.:/usr/local/php/lib/php') in /root/wallabag/bin/console on line 15
下面保留PHP 7.3时期编译tidy的历史过程,不能据此安装已经停止维护的PHP。当前2.x文档要求PHP至少7.4,2.6.15起加入PHP 8.4支持,实际选仍受维护且与所用Wallabag版本兼容的PHP;CLI与FPM扩展都要核对。优先用同版本扩展包,手动编译也必须匹配当前PHP源码、phpize和php-config。遇到缺扩展先补齐,不用composer update或忽略平台要求来绕过。
apt install libtidy-dev cd /root/oneinstack/src tar zxvf php-7.3.29.tar.gz ## 解压已经安装的php版本 cd php-7.3.29/ext/tidy /usr/local/php/bin/phpize ./configure --with-php-config=/usr/local/php/bin/php-config make && make install cd /usr/local/php/lib/php/extensions ls ## 看到no-debug-non-zts-20180731类似文件夹 cd no-debug-non-zts-20180731 ls ## 查看有没有 tidy.so,如果有,证明编译成功 加载 tidy echo 'extension=tidy.so' > /usr/local/php/etc/php.d/ext-tidy.ini
3.2 创建Mysql数据库
直接使用PHPMyAdmin创建一个Wallabag的数据库。

3.3 手动安装过程
执行以下命令开始安装Wallabag,命令如下:
git clone https://github.com/wallabag/wallabag.git cd wallabag && make install
如果遇到以下错误:
root@DMIT-dViQvbFxiK:~# cd wallabag && make install Do not run this script as root! Use --ignore-root-warning to ignore this error. GNUmakefile:21: recipe for target 'install' failed make: *** [install] Error 1
这里应换成站点普通用户执行安装,不能继续用–ignore-root-warning跳过。先准备该用户拥有写权限的安装目录,切换到该用户后进入目录,执行下面命令;只用于新建的空数据库,已有数据按升级流程操作。
# 以站点普通用户在Wallabag目录执行;不要以root运行 make install
安装过程中会要你填写一些配置信息,最主要的就是填写正确的数据库账号、密码、域名和设置好管理员账号,其它的例如邮箱等可以直接回车,不想填写也可以。



下面是原文2021年安装过程的历史日志,保留作排错对照;其中root绕过警告不是当前推荐步骤,旧数据库密码也已改成示例占位,不能照抄凭据。
root@DMIT-dViQvbFxiK:~# cd /root/wallabag
root@DMIT-dViQvbFxiK:~/wallabag# ./scripts/install.sh prod --ignore-root-warning
composer.phar not found, we'll see if composer is installed globally.
HEAD is now at 919d7da5 Merge pull request #5155 from wallabag/release/2.4.2
Do not run Composer as root/super user! See https://getcomposer.org/root for details
Continue as root/super user [yes]? yes
Installing dependencies from lock file
Verifying lock file contents can be installed on current platform.
Package operations: 162 installs, 0 updates, 0 removals
- Downloading composer/package-versions-deprecated (1.11.99.1)
- Downloading symfony/polyfill-mbstring (v1.22.1)
- Downloading symfony/polyfill-ctype (v1.22.1)
- Downloading twig/twig (v2.14.4)
- Downloading symfony/polyfill-intl-icu (v1.22.1)
- Downloading symfony/polyfill-apcu (v1.22.1)
- Downloading psr/simple-cache (1.0.1)
> Incenteev\ParameterHandler\ScriptHandler::buildParameters
Creating the "app/config/parameters.yml" file
Some parameters are missing. Please provide them.
database_driver (pdo_mysql): pdo_mysql
database_host (127.0.0.1): localhost
database_port (null): 3306
database_name (wallabag): wzfouwa
database_user (root): wzfouwa
database_password (null): REDACTED_EXAMPLE_PASSWORD
database_path (null):
database_table_prefix (wallabag_): wallabag_
database_socket (null):
database_charset (utf8mb4):
domain_name ('https://your-wallabag-url-instance.com'): https://dmit.wzfou.me
server_name ('Your wallabag instance'): wzfoumm
mailer_transport (smtp):
mailer_user (null):
mailer_password (null):
mailer_host (127.0.0.1):
mailer_port (false):
mailer_encryption (null):
mailer_auth_mode (null):
locale (en):
secret (CHANGE_ME_TO_SOMETHING_SECRET_AND_RANDOM):
twofactor_auth (true):
twofactor_sender (no-reply@wallabag.org):
fosuser_registration (true):
fosuser_confirmation (true):
fos_oauth_server_access_token_lifetime (3600):
fos_oauth_server_refresh_token_lifetime (1209600):
from_email (no-reply@wallabag.org):
rss_limit (50):
rabbitmq_host (localhost):
rabbitmq_port (5672):
rabbitmq_user (guest):
rabbitmq_password (guest):
rabbitmq_prefetch_count (10):
redis_scheme (tcp):
redis_host (localhost):
redis_port (6379):
redis_path (null):
redis_password (null):
sentry_dsn (null):
> Sensio\Bundle\DistributionBundle\Composer\ScriptHandler::buildBootstrap
> Sensio\Bundle\DistributionBundle\Composer\ScriptHandler::clearCache
手动安装应放到站点用户可管理的应用目录,例如/var/www/wallabag,Nginx公开根目录只能指向其中的web子目录,不能把app/config、vendor及数据库配置暴露出来。旧截图的/root/Wallabag路径只作历史记录。

手动安装走PHP-FPM,不是上面的Docker端口反代。下面根目录、证书与FPM套接字均需按实际安装替换,80端口可沿用前面跳转HTTPS的server段;官方虚拟主机说明:https://doc.wallabag.org/admin/installation/virtualhosts/。
server {
listen 443 ssl;
server_name wallabag.example.com;
root /var/www/wallabag/web;
ssl_certificate /实际证书路径/fullchain.pem;
ssl_certificate_key /实际证书路径/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3;
location / { try_files $uri /app.php$is_args$args; }
location ~ ^/app\.php(/|$) {
include fastcgi_params;
fastcgi_pass unix:/实际PHP-FPM套接字路径/php-fpm.sock;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_param HTTPS on;
}
location ~ \.php$ { return 404; }
}
现在打开你的域名地址,就可以看到Wallabag的界面了。

四、Wallabag管理使用
这个就是Wallabag的界面,支持中文。(点击放大)

这是Wallabag的设置页面。

4.1 离线收藏保存
抓取效果受网页结构、登录权限和动态加载影响,不是任意网页都能完整保存。先打开保存后的正文和图片核对,再决定是否删除原书签;不要把原文的演示当成当前对所有网站的测试结论。
想要收藏某一个网页,直接输入这个网页的url即可,Wallabag会自动抓取该网页保存在你的服务器上。

这个是Wallabag的离线保存网页阅读页面。

Wallabag支持将离线保存的网页导出为PDF、XML、TXT等格式。

4.2 RSS订阅生成
Wallabag支持将你保存的网页生成RSS订阅源,这样你就可以使用任意的RSS阅读器来阅读你的Wallabag保存的文章了。

Wallabag生成的RSS订阅源后,你就可以添加到其它的RSS阅读器中了。

4.3 保存图片本地
开启下载图片后,还要确认新保存文章的图片确实落到本地;开关不会保证补齐所有历史失效图片。备份需包括数据库、配置及web/assets/images,Docker版还要保留data和images两个目录。恢复时使用匹配版本,详见https://doc.wallabag.org/admin/backup/。RSS地址与API密钥也不要公开分享。
Wallabag默认保存的网页的图片不是保存在本地,如果图片的链接丢失的话就很容易失去图片了,为此我们可以在“内部设置”中将图片设置为“1”,即缓存图片到本地。

4.4 浏览器扩展
首先是在Wallabag的“客户端API”中生成一个api。

然后,打开你的浏览器Wallabag扩展,进入设置页面,输入你的Wallabag域名。

接着就是填写你刚刚生成的Wallabag的API的ID和密钥,同时填写你的Wallabag的账号和密码。确定。

现在你就可以在你的浏览器上一键点击Wallabag按钮收藏保存网页了。

4.5 手机APP
直接在手机上安装Wallabag APP,首次进入要填写你的Wallabag域名和管理员账号。

接着你就可以使用Wallabag APP来阅读你保存的网页了。

Wallabag手机阅读界面如下:

Wallabag手机APP支持导出。

五、总结
Wallabag是一个非常优秀的离线保存网页的服务,自建Wallabag服务也不是很麻烦,Wallabag提供的手机APP也可以直接收藏和保存网页,包括微信文章。
文章出自:挖站否 https://wzfou.com/wallabag/,部分内容参考自spiritx https://spiritx.xyz/993.html 版权所有。本站文章除注明出处外,皆为作者原创文章,可自由引用,但请注明来源。










支持自动/定时保存就好了