Docker-Wallabag(网络书签)

[Wallabag](https://wallabag.org/) 是一个用于保存网页的自托管应用程序。与其他服务不同，wallabag是免费的（如自由）和开源的。
使用此应用程序，您将不会再错过内容。点击，保存，在需要时阅读。它保存您选择的内容，以便您可以在有时间时阅读它。

`非常规端口 80/443/8080 这种是无法正常抓取的`，未解决
`MrDoc觅思笔记即便是80端口也无法正常抓取(官方的也不行)`，未解决

**相关链接：**
官网：https://wallabag.org/
官方文档：https://doc.wallabag.org/en/
GitHub：https://github.com/wallabag/wallabag
Docker：https://registry.hub.docker.com/r/wallabag/wallabag
多平台下载：https://wallabag.org/en#download (如果显示位置不对，往上翻)
群晖套件：https://synocommunity.com/package/wallabag
FiveFilters.org 文档：https://help.fivefilters.org/full-text-rss/site-patterns.html#github-repository

**相关工具：**
站点配置文件：https://github.com/fivefilters/ftr-site-config
Xpath采集测试工具(推荐)：https://www.toolnb.com/tools/xpath.html
Xpath在线测试工具：https://tool.ip138.com/xpath/
抓取链接测试：https://f43.me/feed/test
动态测试XPath：http://www.whitebeam.org/library/guide/TechNotes/xpathtestbed.rhtm
站点配置生成器：https://siteconfig.fivefilters.net/

## docker-compose.yml
```bash
mkdir {images,data}		# 创建所需文件夹
```

### 推荐·MariaDB(MySQL) 版
数据库只需要配置root密码，其余数据库相关的Wallabag都会通过root账户自行配置
所以服务首次部署需要等Wallabag自动把数据库配置完成后方可访问到
```yaml
version: '3'
services:
    wallabag:
        image: wallabag/wallabag:2.5.4  # latest的不一定是最新,指定最新的版本
        environment:
            # 服务器去相关配置
            - SYMFONY__ENV__DOMAIN_NAME=http://blynk.space:8123  # 访问地址,页面加载不全检查访问地址一致
            - SYMFONY__ENV__LOCALE=zh  # 默认语言
            - SYMFONY__ENV__FOSUSER_REGISTRATION=false  # 默认true,启用|禁用公共用户注册
            - SYMFONY__ENV__FOSUSER_CONFIRMATION=true  # 默认true,启用|禁用注册邮件确认
            - SYMFONY__ENV__SERVER_NAME=ZWZW  # 为 2FA 颁发者指定用户友好名称
            # 数据库相关
            - MYSQL_ROOT_PASSWORD=ai773203918  # 数据库ROOT用户密码
            - SYMFONY__ENV__DATABASE_DRIVER=pdo_mysql  # 数据库为pdo_sqlite|pdo_mysql|pdo_pgsql
            - SYMFONY__ENV__DATABASE_HOST=mariadb  # 数据库地址
            - SYMFONY__ENV__DATABASE_PORT=3306  # 数据库端口
            - SYMFONY__ENV__DATABASE_NAME=Wallabag_ZWZW  # 数据库名称
            - SYMFONY__ENV__DATABASE_USER=Wallabag_ZWZW  # 数据库用户名
            - SYMFONY__ENV__DATABASE_PASSWORD=Wallabag_ZWZW  # 数据库密码
            - SYMFONY__ENV__DATABASE_CHARSET=utf8mb4  # 数据库编码,utf8:PostgreSQL/SQLite,utf8mb4:MySQL
            # 邮箱相关
            - SYMFONY__ENV__MAILER_HOST=smtp.qq.com  # 邮箱服务器
            # - SYMFONY__ENV__MAILER_PORT=25  # 邮箱服务器端口
            # - SYMFONY__ENV__MAILER_ENCRYPTION=null  # 邮箱服务器加密tls|ssl|null
            - SYMFONY__ENV__MAILER_PASSWORD=<你的密钥>  # SMTP 密钥
            - SYMFONY__ENV__MAILER_USER=ai773203918@qq.com  # SMTP 账户
            - SYMFONY__ENV__FROM_EMAIL=ai773203918@qq.com  # 发件人邮件
            - SYMFONY__ENV__TWOFACTOR_SENDER=ai773203918@qq.com  # Wallabag账户默认邮箱(需WEB UI再配置一遍)
            # - SYMFONY__ENV__TWOFACTOR_AUTH=true  # 默认false,启用|禁用Wallabag双因素身份验证
        volumes:
            - ./images:/var/www/wallabag/web/assets/images  # 本地缓存的图片
            # - parameters.yml:/var/www/wallabag/app/config/parameters.yml  # 默认参数配置文件
        ports:
            # 对外开放的端口
            - 8123:80
        depends_on:
            # 等待数据库启动后启动
            - mariadb
    mariadb:
        image: mariadb
        environment:
            - MYSQL_ROOT_PASSWORD=ai773203918  # 数据库ROOT用户密码
        volumes:
            - ./data:/var/lib/mysql  # 数据库
```
默认管理员账号：wallabag 密码：wallabag
创建时相关参数都会写入到 [parameters.yml](https://doc.wallabag.org/en/admin/parameters.html)，也可通过直接挂在这个文件来部署
主要防范容器挂载的参数泄露账号
>i 如果首次部署时，wallabag容器 一直在刷 `Waiting for database ...`,最后刷完 `Terminated` 就停止运行了
> 这种情况大概率是数据库还没启动好，wallabag 无法连接到数据库，再次启动 wallabag 即可

### redis 版
```yaml
mkdir images		# 创建所需文件夹
version: '3.3'
services:
    wallabag:
        volumes:
            - ./images:/var/www/wallabag/web/assets/images
        ports:
            # 对外开放的端口
            - 8123:80
        environment:
            # 设置访问域名,必须和访问一致,不然会无法加载样式
            - 'SYMFONY__ENV__DOMAIN_NAME=http://blynk.space:8123'
        links:
            # 链接到数据库
            - 'redis:redis'
        # latest的不一定是最新
        image: wallabag/wallabag:2.5.4
        depends_on:
            # 等待数据库启动后启动
            - redis
    redis:
        expose:
            # 开放内部端口给主服务
            - 6379/tcp
        image: 'redis:alpine'
```

## docker-仅做测试
这个单容器使用内置 SQLite 作为数据库，不利于迁移，推荐 +MySQL 使用使用
```bash
mkdir {data,images}		# 创建所需文件夹
docker run -d --name wallabag -v $PWD/data:/var/www/wallabag/data -v $PWD/images:/var/www/wallabag/web/assets/images -p 8880:80 -e "SYMFONY__ENV__DOMAIN_NAME=https://nas.918178.xyz:8880" wallabag/wallabag
```
默认管理员账号：wallabag 密码：wallabag

## 手动配置网站抓取关键字
在 `/var/www/wallabag/vendor/j0k3r/graby-site-config` 下创建，里面也有很多实例文件
如域名：`https://nas.918178.xyz:10086`
这个添加就叫：`918178.xyz.txt`，存在上列文件夹下

## Xpath 编写
可以直接在浏览器按 <kbd>F12</kbd> 打开 `开发者工具`
然后在 `element(元素)` 按 <kbd>Ctrl</kbd>+<kbd>F</kbd>，打开搜索
搜索栏中就可以填写 `Xpath` 指令测试
![](/media/202303/2023-03-02_164202_3229140.05716380510713959.png)

**相关教程：**
[wallabag – 开源网络书签、稍后阅读工具：自托管、RSS、标注、本地保存、中文界面、多客户端、自动标签规则等](https://www.appinn.com/wallabag/)
[2022软件测试技巧 Chrome 谷歌浏览器 开发者工具(F12) 快速调试xpath代码](https://blog.csdn.net/wg8ofk08/article/details/125408946)