HWHL博客 https://blog.hwhl.fun/ HWHL的博客 Thu, 04 Dec 2025 06:35:13 GMT https://validator.w3.org/feed/docs/rss2.html https://github.com/jpmonette/feed zh-CN All rights reserved 2025, hwhl <![CDATA[S3协议访问其他云对象存储]]> https://blog.hwhl.fun/article/21b210e3-2d57-802d-b35e-d7af1149e47c https://blog.hwhl.fun/article/21b210e3-2d57-802d-b35e-d7af1149e47c Mon, 23 Jun 2025 00:00:00 GMT
😀
AWS S3是第一批也是最广泛使用的云存储服务之一，大量的工具和开发都是围绕着AWS API构建的，因此，S3的API自然而然地成为了对象存储的事实标准，它健壮、文档完善，并得到了庞大开发者社区的理解。
 

📝 各类对象存储

Google Cloud Storage(GCS)

首先在GCP HMAC获取下 access key / secret key: https://cloud.google.com/storage/docs/authentication/managing-hmackeys
使用Boto3 访问: https://cloud.google.com/storage/docs/aws-simple-migration

火山云 volcengine

在文档中提到了可以使用 S3 工具访问: AWS S3 协议兼容性说明, 但没有给出python boto3 的代码示例。
参考 文档中提到的 VirtualHost 访问方式: https://www.volcengine.com/docs/6349/651320 以及 使用 Rclone 访问 TOS 使用 S3 Browser 管理 TOS 资源 文档中说明:

MinIO

开源的对象存储，从项目初始对S3 API的支持。不过最近出现了企业版本和社区版本的区别，好多S3权限管理的功能放到了企业版中，需要提前决策是否使用。

其他云

B2(Blackblaze): https://www.backblaze.com/docs/cloud-storage-use-the-aws-sdk-for-python-with-backblaze-b2
CloudFlare R2: https://developers.cloudflare.com/r2/examples/aws/boto3/

🤗 总结归纳

上面主要讨论了几种对象存储的Python SDK配置和使用。了解了之后，也可以使用相同的选项来配置其他语言的SDK，或是其他的S3工具（如 Rclone / s3fs / hadoop 等等).

📎 参考文章

 
💡
有关Notion安装或者使用上的问题，欢迎您在底部评论区留言，一起交流~
]]> <![CDATA[使用ESP32S3来做个FIDO Passkey]]> https://blog.hwhl.fun/article/esp32-s3-pico-fido https://blog.hwhl.fun/article/esp32-s3-pico-fido Wed, 19 Mar 2025 00:00:00 GMT

前言

偶然发现了 Pico FIDO 这个项目，可以使用 RP2350/ESP32S3 等设备来做 FIDO Passkey，用作个人的物理安全密钥。
下面使用 ESP32S3 来做一个YubiKey密钥。

TLDR;

编译过程需要一定的Linux基础，可以选择下面的固件，跳过编译过程，直接来到烧写步骤。
  • pico_fido_esp32-s3-origin.bin 官方6.4原始代码编译的固件。
  • pico_fido_esp32-s3-Yubikey5.bin 修改成YubiKey5，并将LED亮度调到最低，烧录后没有其他需要可忽略 Phy Settings步骤。
pico_fido_esp32-s3-origin.bin
550.0KB
pico_fido_esp32-s3-Yubikey5.bin
550.0KB
💡
下载不了？试试网盘: https://pan.baidu.com/s/1nrnu4hxUnQS-bd17lGTxzQ?pwd=linu 提取码: linu

编译固件

克隆代码
然后在目录下启动Docker构建环境，创建 docker-compose.yaml:
然后启动: docker compose up -d
进入Docker 构建环境
下面的命令是在Docker 构建的容器内运行，执行时分步执行，注意检查有没有错误。
最后提示有合并 bin 文件 pico_fido_esp32-s3.bin，即说明编译成功。

Flash

烧写 ESP32-S3

按住 BOOT 键，再按下 RESET，进入烧录模式
由于上面编译最后一步一景合并了bin，所以，直接从 0 地址烧写即可。
看到输出出现 "Hash of data verified." 表示烧写成功，设备也会自动重启。

Phy Setting

查看设备

MAC 上弹出 "键盘设置助理"，关闭即可
从关于里面查看 USB，USB2.0 Hub下有 "Pico Key":

定制FIDO设备

安装 libfido2， MacOS中安装命令为: brew install libfido2
动态工具修改的使用方法，来自 GitHub讨论区。 Run these commands:
  1. fido2-token -L
  1. fido2-token -S <device> for which <device> is found in the previous step.
  1. python3 -m pip install fido2
  1. git clone this repo.
  1. cd pico-fido
  1. python3 tools/pico-fido-tool.py --help to see the options for configuration, and what command is necessary to run to configure them.
下面是详细的步骤和解释：
由于 pico-fido-tool 需要输入PIN，而新烧写的还没有设置过，所以通过:
LED 灯闪烁，亮度太高，调整亮度
设置为 Yubikey5 类型 (VID 0x1050 / PID: 0x0407)

使用

使用 Yubico Authenticator

上面已经设置成 Yubikey5，这里使用 Yubico Authenticator 来管理，支持MacOS, Windows, Linux, Android, iOS 系统。
下载软件： https://www.yubico.com/products/yubico-authenticator/
官方详细的介绍 Using your YubiKey as a smart card in macOS, 其他设备也可以在页面中找到。
安装完成后，打开 Yubico Authenticator，显示出 "YubiKey 5A"，正是刚刚的设备。
设置中有语言选项，但是社区的翻译不知道是什么语言的，还是继续用默认的英语。
在左侧的PassKeys中，输入 PIN后，查看保存的密钥，同时显示只有8次修改PIN的机会。
 
更多 Yubico 的使用方法参见文末的链接。

额外话

安全选项

ESP32 支持 OTP，只能烧入一次，且加密，更加安全。

定制 ROM

  1. pico-keys-sdk/src/led/led.h, 设置亮度到1(默认是15) #define MAX_BTNESS 1
  1. 在构建时指定 VIDPID

    📎 参考文章

    • Pico-FIDO: https://github.com/polhenarejos/pico-fido
     
    ]]>         <![CDATA[Docker 安装 Mosquitto Server]]> https://blog.hwhl.fun/article/iot-mosquitto-server https://blog.hwhl.fun/article/iot-mosquitto-server Tue, 25 Feb 2025 00:00:00 GMT
    😀
    Eclipse Mosquitto 是一个开源的MQTT解决方案，本文介绍在Linux下使用docker方式部署一个broker，并设置不同的用户，为Homeassitant和ESPHome等提供MQTT服务。
     

    简介

    Eclipse Mosquitto 是一个开源的MQTT解决方案，用来自建MQTT broker，支持 MQTT 5.0，3.1 和 3.1.1 等版本的协议。是一个非常轻量的方案，适合部署在Armbian和Raspberry Pi上。
     
    Mosquitto 除了broker服务器外，也提供了客户端工具，如 mosquitto_pub / mosquitto_sub 命令来连接测试MQTT。

    安装

    docker-compose

    这里使用docker-compose来启动服务，docker-compose.yaml 配置如下：
    解释：
    1. 使用 eclipse-mosquitto 作为docker镜像。
    1. 当前目录下的 mosquitto 目录作为 mosquitto 的配置目录。
    1. 向外提供 1883 端口 和 9001 端口。
    1. user: "1000:1000" 指定了容器内的运行身份，如果不指定，默认使用root身份运行。通过 id 命令来获取实际的用户id和组id。

    配置

    在当前目录下创建 mosquitto 文件夹，并创建配置文件:
    1. ./mosquitto/passwd 文件中保存MQTT client的用户名和密码，文件必须设置为 700 权限。
    1. ./mosquitto/mosquitto.conf 是mosquitto的配置文件，禁止了匿名访问，更多的配置参加文末的参考链接。
     
    启动 mosquitto 服务
     
    创建用户密码
    默认情况下没有用户，需要执行下面的命令添加，多个用户需要针对每个用户分别执行下面的命令：
    ⚠️注意，添加完用户或修改mosquitto配置后，需要重启容器才能生效:

    使用

    下面使用mosquitto容器内自带的 mosquitto_pub/mosquitto_sub 来测试下MQTT服务，假设上一步创建的用户名和密码为：`user, password`
    发布消息后，在订阅的窗口将有对应的输出：

    🤗 总结

    上面通过Docker启动了一个非常轻量的 Mosquitto 服务器，以便在HomeAssistant和ESPHome等设备上使用。
    除了Mosquitto外，还有 EMQX 等也可以通过 docker 来部署，大家根据实际的需要来安装。

    📎 参考文章

     
    ]]>         <![CDATA[解决Terraform下载失败]]> https://blog.hwhl.fun/article/terraform-provider-timeout https://blog.hwhl.fun/article/terraform-provider-timeout Wed, 19 Feb 2025 00:00:00 GMT
    😀
    今天在构建coder template时，总是因为网络原因导致 terraform构建失败，查阅了部分资料和ChatGPT后，通过 filesystem_mirror: consult a directory on the local disk for copies of providers 方式预缓存provider，解决构建时总遇到的网络问题。
     

    📝 遇到的问题

     
    因为网络的问题，terraform在下载coder provider时超时出错：

    手动下载 kreuzwerker/docker provider

    📌 找到 kreuzwerker/docker provider 的最新版本
    • 打开 Terraform Registry：
    🔗 https://registry.terraform.io/providers/kreuzwerker/docker/latest
    • 复制最新的 版本号（如 3.0.2）。
    📌 下载 kreuzwerker/docker provider
    在 外网服务器 上运行：

    文件方式设置 mirror

    传输到 内网服务器 上后，重命名并移动到 Terraform 插件目录：
    在 内网服务器 上，创建或修改 ~/.terraformrc 文件：
     
    再次执行构建能够快速的加载并构建成功。

    🤗 总结归纳

    上面介绍的方式只能解决一个包的下载问题，如果需要多个包，重复进行多次。
     
    除了上面的方式外，Terraform 提供了 providers mirror 命令，可以把 provider 下载到本地，然后配置 Terraform 使用本地 provider，而不访问 registry.terraform.io。在这里没有进一步的尝试。

    📎 参考文章

     
    ]]>         <![CDATA[Kindle上使用Koreader]]> https://blog.hwhl.fun/article/kindle-koreader-tips https://blog.hwhl.fun/article/kindle-koreader-tips Tue, 11 Feb 2025 00:00:00 GMT
    😀
    转发保存一份Kindle上使用Koreader的文章，只摘取Koreader部分。

    Koreader简介

    1、小屏设备上阅读PDF文档的体验大幅提升

    KOReader支持自动/手动切边、屏幕全方位旋转，以及（最重要的）文字重排。
    notion image
    重排后的文字不仅变大，还能对字号、行高、对比度等样式进行调整。
    notion image
    演示：默认尺寸/自动裁边/文字重排
    KOReader的重排功能即使在KPW3这样的老机器上速度也很快。当然，如果PDF原文档清晰度就很差，或者影印得歪七扭八，或者图文混排比较复杂，那么对最终重排的效果会大打折扣，此时建议开启“自动裁边＋横向旋转屏幕+连续翻页”这三项。
    notion image
    我习惯加载支架看书，旋转后可以边充电边看，还能分成两列，便于我“一目十行”！

    2. 为KPW3等老机型增加深色模式

    深色模式会大幅增加残影，但是昏暗环境下肉眼的分辨能力下降，残影不易察觉，因此无须频繁手动刷新（拇指斜着短滑即可刷新消除残影）。而在明亮环境下也没有使用深色模式的必要。
    notion image
    只对背景和文字反色，图片依然保持原样。

    3、实现文字/段落样式/状态栏/屏保的全面自定义

    文字行高、段落间距、段首缩进、文档边距……几乎可以覆盖掉书籍原有的所有样式。可以充分利用6英寸小屏的边边角角，显示更多内容。
    notion image
    自定义设置：文字样式
    屏幕上下两边都有自定义程度很高的状态栏（如上图），包括多种样式的书籍信息、阅读进度，以及丰富的系统信息，比如电量、灯光亮度、内存占用、WiFi状态都一目了然。
    notion image
    自定义设置：底部状态栏/顶部备选状态栏
    notion image
    自定义设置：屏保
    我设置“最近一本书的封面+已读进度+剩余电量”显示在待机屏保中，当我“合上书”的时候不仅知道看了多少，还知道是否该充电了。
    notion image
    屏保中显示最近一本书的已读进度和休眠前的剩余电量（不会刷新）

    4、极其丰富的手势操作

    手机上有的手势操作，KOReader都有，甚至更多。除了屏幕的左右区域，上下区域以外，屏幕的四角、四边甚至对角线，也都可以触发事件。
    再配合点击/滑动、单指/双指这些动作，可以排列组合出超多手势！只要你记得住，基本可以做到“不见菜单”。
    我自己磨合出一套很顺手的手势设置，放在文章最后。
    notion image
    触发区域/手势动作

    5、超级方便的传书方式和文件管理

    kindle的传书方式对电子书的格式有要求，比如自家的.azw3格式以及.mobi就不支持。亚马逊服务器会把.epub等格式的文档转成.kfx格式，再推送到kindle上，因此用户需要等待一两分钟。
    OKReader支持除了.azw3以外的常见电子书/文档格式。自带五种无线传书功能的插件，其中SSH/FTP方式很适合专业用户，OPDS/Wallabag/calibre这三种方式实在太重了，没必要。所以还是推荐大家安装另一个超好用的插件——File Browser，这个后面的插件环节详细说。
    kindle原生系统想归类书籍只能用“收藏夹”功能，一本一本地操比较麻烦。KOReader里直接创建文件夹，分类管理图书，非常方便。
    notion image
    文件管理

    6、大幅提升划线/笔记的体验

    用kindle划过线的都知道有多崩溃，尤其是跨页划线时，有来有往，忽高忽低，指哪不打哪，非常磨炼定力。
    使用OKReader跨页划线时，它会把内容整体上滑半页，露出下面几段，这样就能轻松划选到下页的内容。
    notion image
    跨页标注
    即便漏划了几个字也不用删除重新划，只需要单击划选文字，就能轻松调整划选范围。
    notion image
    调整标注范围/四种标注样式/为标注添加笔记（输入法挺好用）
    与kindle不同的是，OKReader内置的输入法更高效，而且还能将任意复制的文字，生成一个二维码，然后用手机一扫，就能复制到手机里。
    如果你想用kindle记事甚至写作，越狱前是不可能的。越狱后，OKReader自带一个文本编辑器，可以创建和编辑.txt文件，熟练操作后完全没问题。
    此外，还能将书籍中的标注和笔记，导出为多种格式的文件，传输到手机上。
    notion image
    笔记导出格式选择/txt导出效果/自带的文本编辑器

    7、其他

    各种屏保玩法、丰富的插件、阅读计时提醒、书籍地图和阅读统计……就不多说了，详见书伴网或自行搜索。

    字典和字体安装

    1、字典单独安装

    KOReader自带的字典适合中国人的不多，而且和kindle原生系统的字典也不共用。可以在这里https://kdr2.com/resource/stardict.html 下载需要的字典（一般新华字典/现代汉语/成语/中英双向这几个就够了）
    解压后复制到Kinder的（根目录/koreader/data/dict）这个文件夹里。然后在KOReader主菜单中依次点击：“🔍（放大镜）> 设置 > 词典设置 > 管理词典”，然后选中你需要的字典，并按自己的需求排序。排序很重要，常用的排上面。
    notion image
    字典管理

    2、字体与kindle共享

    最新版KOReader会自动关联kindle原生系统（根目录/font）的字体。也就是说，越狱前怎么装字体，越狱后还怎么装，无需安装其他插件。
    注意，不要删除“根目录/koreader/fonts”文件夹中的任何字体（除非你有把握并做好备份），尤其是noto文件夹（系统会用到，乱删会导致KOReader无法正常启动）。
    另外，维基百科和翻译（谷歌的API）国内无法访问，暂时没有找到有效的解决方法，回头研究明白了再来发文，可以关注我。

    我的自定义手势设置建议

    KOReader的手势组合极其丰富，下图是我自己反复调教、优化后的手势方案（好记又好用），仅供参考，别忘点个赞。
    notion image
    仅供参考，全部支持自定义
    小技巧：
    长按菜单中的某些功能选项，可以看到该功能的具体说明。
    如系统卡死，长按电源键（40秒）重启设备。

    📎 参考文章

     
    💡
    有关Notion安装或者使用上的问题，欢迎您在底部评论区留言，一起交流~
    ]]>         <![CDATA[重启群晖Driver服务]]> https://blog.hwhl.fun/article/restart-synology-driver-service https://blog.hwhl.fun/article/restart-synology-driver-service Mon, 10 Feb 2025 00:00:00 GMT
    😀
    这里写文章的前言： 最近偶尔遇到群晖中的 Driver 无响应，无法查看文件的情况，平时采用重启群晖机器来解决，最近一想，是否有重启服务的方式。
     

    📝 主旨内容

    经过查询，发现从 DSM 7 版本后，群晖服务改用了 systemctl 的方式，经常用Linux环境的一定对这个非常熟悉。
    通过查看系统服务状态，找到是 pkgctl-SynologyDrive.service 服务，执行重启命令：
    再次查看 Driver 已经可以正常使用了。

    🤗 总结归纳

    使用群晖的 systemctl 命令行来重启服务，能够在避免重启群晖主机，保证其他服务正常运行。
    此外，群晖常用的服务还有：
    1. 存储 & 磁盘管理
    • scemd - 存储控制管理服务
    • synostoraged - 存储管理相关服务
    • synofstool - 文件系统工具
    • synodiskport - 磁盘端口管理
    • synodrivedb - 存储数据库管理
    1. 文件共享 & 网络服务
    • nmbd - NetBIOS 名称服务（Samba 相关）
    • smbd - Samba 服务（Windows 文件共享）
    • afpd - Apple 文件协议（AFP）
    • nfsd - NFS 服务
    • pkgctl-SFTP - SFTP 服务
    • pkgctl-FTPD - FTP 服务
    1. 远程访问 & 网络管理
    • synovpnserver - VPN 服务器
    • synosnmpd - SNMP 监控
    • pkgctl-OpenVPN - OpenVPN 服务
    • pkgctl-WireGuard - WireGuard VPN 服务
    • pkgctl-CloudSync - Cloud Sync 云同步服务
    1. 多媒体 & 备份
    • pkgctl-SynologyDrive - Synology Drive 服务
    • pkgctl-CloudSync - Cloud Sync
    • pkgctl-ActiveBackup - Active Backup for Business

    📎 参考文章

    ]]>