Fugleramme日常运维指南：4个面板按键、小时级自动更新与管理页安全设置完整清单

Fugleramme日常运维指南：4个面板按键、小时级自动更新与管理页安全设置完整清单

【免费下载链接】fuglerammeBird frame for Raspberry Pi - real-time bird detection by audio, fully local AI, rendered as real, hand-cut 1800s bird illustrations. On an e-ink panel, a TV, or any screen.项目地址: https://gitcode.com/gh_mirrors/fu/fugleramme

Fugleramme是一款运行在树莓派上的鸟类检测画框：通过音频实时识别鸟鸣，用本地 AI（BirdNET-Go）完成分类，并把结果渲染成19世纪手绘风格的鸟类插图，显示在墨水屏、电视或任意屏幕上。日常使用中最常接触的三件事，就是面板背后的4个按键、小时级的自动更新机制，以及管理页的安全设置。这份清单帮你把这三块一次讲清楚。

面板背后的4个按键：一眼看懂每个功能

电纸墨屏面板背面边缘共有4个实体按键，这是 docs/operations.md 中记录的完整行为：

三个显示模式各有特色：

• Collage（拼贴，默认）：展示回看窗口内听到的所有鸟，打包排版
• Latest bird（最近一只）：只在上一次听到不同物种时才换图
• Newest arrival（最新新到）：一直保留最新的"新面孔"，同一只鸟可以挂上几周

💡 两个容易忽略的细节：

1. 按键设置会覆盖管理页设置并自动保存——按了键之后再改网页设置可能"不生效"，这是设计如此。
2. 墨水屏重绘很慢，按键后最多给面板一分钟，不要以为按键失灵了。

小时级自动更新：从检查到安装的全流程

Fugleramme 每小时检查一次是否有新版本，结果直接显示在管理页的System 标签页（实现见 src/fugleramme/updates.py，小时级检查间隔正是为了适配 GitHub 未认证请求的频率限制）。

手动更新：发现新版本后点击Install，页面会显示进度条。安装大约需要一两分钟，画框会自行重启并在新版本上恢复运行；如果更新失败，原因会直接显示在版本号的位置，画框保持原版本继续运行，不会变砖。

全自动更新：勾选Install new releases automatically（自动安装新发布版）后，画框发现新版本会自动升级，完全不用管。注意容器模式下该开关不可用——容器内的进程拉不到镜像。

还有几个运维要点：

• 部分更新会附带新版 BirdNET-Go（几百 MB，下载稍慢），期间检测数据会自动备份到detector/data/birdnet.db.bak；
• 无论手动还是自动，画框必须在线才能检查和安装更新，System 标签页会告诉你网络是否正常；
• 想离线手动指定版本，可通过 SSH 执行git fetch --tags && git checkout <version> && uv sync，最后sudo systemctl restart fugleramme-frame；
• 移动过仓库目录或换过麦克风，重跑一次 run.sh 即可重新应用安装器的全部配置。

管理页安全设置：一份可打勾的清单

默认情况下，网络上任何能访问到画框的人都能改它的设置。推荐按下面顺序逐项处理：

1. 开启登录：Security 标签页勾选Require sign-in for the admin page（管理页需要登录），设置密码并Save。登录状态保持一周；修改密码会让所有设备登出。
2. 反锁机制：同一来源连续 5 次输错密码，15 分钟内拒绝登录（手滑也算数）。等满 15 分钟，或重启服务解除。
3. 反向代理场景：如果画框挂在反向代理后面，所有访客共用代理的 IP，陌生人的乱输会连累你自己被锁。此时勾选The frame is behind a reverse proxy，让系统按访客而非按 IP 计数。若画框端口同时直接暴露在外网，这个选项反而会帮倒忙，保持关闭。
4. 公网访问：密码目前通过纯 HTTP 传输。若画框可从互联网访问，请前置 HTTPS 并勾选代理选项。

忘记管理页密码怎么办？通过 SSH 直接改设置文件即可，画框保存时自动读取，无需重启：

ssh <user>@<host>.local nano ~/fugleramme/detector/data/settings.json # 修改 "admin_password"

容器部署则编辑卷中的/data/settings.json。完整排错流程见 docs/troubleshooting.md。

写在最后：日常巡检清单

Fugleramme 的日常运维远比想象中省心：4 个按键管显示，System 页管更新，Security 页管安全，各管一摊。把这份清单贴在书桌前，你的鸟类画框就能一直安静地"上班"下去了。

【免费下载链接】fuglerammeBird frame for Raspberry Pi - real-time bird detection by audio, fully local AI, rendered as real, hand-cut 1800s bird illustrations. On an e-ink panel, a TV, or any screen.项目地址: https://gitcode.com/gh_mirrors/fu/fugleramme