这是一篇在内网服务器上部署 wallabag 的踩坑过程记录，使用 docker compose 部署，并使用内网其他机器上已有的 PostgreSQL 数据库和 Redis 缓存，同时使用 traefik 作为前置的反向代理。

wallabag 是一个可以自己部署的网页剪藏 / 稍后读应用，可以方便地保存各种网页资源，不仅能保存链接，还可以抓取页面内容（从此不怕 404），同时支持 tag 和全文搜索，确实非常方便。然而网上搜到的 wallabag 部署教程多数都是基于 官方示例 ，使用 MySQL / MariaDB 作为数据库，而且没有配置 Redis 缓存。这应该是为数不多使用 PostgreSQL 作为数据库的教程（用的人少，坑自然多些，不过俺已经替各位趟平了，可以放心阅读）。

至于为什么要用 PostgreSQL 作为数据库，是因为：

言归正传，下面开始踩坑之旅。

首先新建一个文件夹，用来部署 wallabag：

此时再次刷新 wallabag 网页，使用刚才创建的用户名和密码登录就可以正常使用了。

理论上可以不用先执行迁移数据库的命令，直接进入安装流程，然后在提示是否重置数据库和表结构的时候，都选择 yes ，来让 wallabag 重新生成数据库和表结构，然后再新增管理员账户，也是一样的效果。但是俺懒得试了，看到这篇的网友们如果愿意尝试一下，可以在评论中分享一下结果，方便后来的网友们

然而，到这里问题还是没有全部解决，如果此时尝试保存一篇带图片的文章，那么图片内容是没法保存的（无论源网页有没有反爬措施），然后再尝试删除这篇文章，又会跳出来一个 500 错误。这是因为在 docker-compose.yml 文件中，将容器内的 /var/www/wallabag/web/assets/images 目录挂载到了 data 这个宿主机文件夹，但是不知为何容器内的应用对这个路径没有写入权限。俺尝试在 docker-compose.yml 文件中增加 user: '1000:1000' 配置，但重建容器后发现容器压根启动不起来了，查看日志能看到这个报错：

推测是因为镜像构建过程中使用了其他用户，导致指定的 1000 用户并没有权限操作其中的文件，不过问题解决到这里，俺已经麻了，并不想再去翻 wallabag 官方的 dockerfile 。。最终俺选择简单粗暴地解决这个问题——先删掉刚才在 docker-compose.yml 文件中增加的 user: '1000:1000' 配置，然后在宿主机执行下面这个命令，将宿主机挂载目录的权限调整至 777 ，也就是允许（任何）其他用户读写：

终究还是翻了一下官方的 dockerfile ，原来容器内的用户和组都是 nobody 。。。最根本的办法，就是在宿主机将挂载目录的归属指定为 nobody 用户和组。但是这个特殊的用户和组直接 sudo chown nobody:nobody data 是不行的，需要指定 uid 和 gid 才行：

最后再执行一下 docker compose up -d 重建容器就可以了（因为刚才修改了 compose 配置文件）。

进入 wallbag 网页界面，登录后，点击右上角的头像，选择【内部设置】，点击【杂项】标签，下方的 在本地缓存图片 值默认是 0 ，改为 1 后点击“应用”按钮，就可以将网页中的图片缓存至本地（挂载出来的容器目录）了。

进入 wallbag 网页界面，登录后，点击右上角的头像，选择【内部设置】，点击【导入】标签，下方的 启用 Redis 来异步导入数据 值默认是 0 ，改为 1 后点击“应用”按钮，就可以开启 Redis 作为异步导入的缓存了。

此时再次点击右上角的头像，选择【导入】，应该能看到页面顶部有一行很显眼的提示：

导入是异步进行的。一旦导入任务开始，一个外部 worker 就会一次处理一个 job。目前的服务是： Redis

此时选择一个导入途径，比如俺选择了【Firefox】，然后点击“导入内容”，选择待导入的文件，点击“上传文件”，此时右上角应该会提示：

导入情况摘要: 1 个项目正在等待导入。

此时如果刷新一下【导入】页面，会发现右上角有个提示：

Messages in queue: 1

多次刷新也之后提示这一句，看上去导入任务并没有开始的样子。。

此时需要去手动执行一下同步任务才能开始：

导入完成后，刷新一下 wallabag 网页，应该能看到导入的内容了。

参考链接：