• 作者: 作者
  • 时间:
  • 分类: 文章

最近在折腾服务器监控工具的时候，发现 Beszel 这款轻量级的项目非常受欢迎。界面清爽，资源占用低，用来监控家里的几个小盒子再合适不过了。不过，有不少朋友（包括我也差点踩坑）在部署好 Beszel 后，遇到了一个非常头疼的问题：登录界面能打开，但只要一点登录或者刚进去就闪退/刷新，死活进不去后台。

今天就把导致这个问题的常见原因和解决办法捋一捋，希望能帮到正在抓狂的你。

为什么会“闪退”？

其实这种所谓的“闪退”，在 Web 端通常的表现就是页面一直循环跳转，或者报错后瞬间重置。Beszel 基于 Go 开发，前后端的交互如果出现异常，往往会导致这种体验。根据目前的社区反馈和实测，主要可能有以下几个“元凶”：

  1. 浏览器缓存/Local Storage 冲突 这是最常见但也最容易被忽视的原因。如果你之前登录过旧版本或者其他的 Beszel 实例，浏览器本地存储的 Token 或配置文件可能和现在的服务端版本不兼容，导致登录逻辑死循环。

  2. 反向代理配置问题 很多 Nginx 大佬喜欢把 Beszel 塞在反向代理后面，套个 SSL 也就是 HTTPS。如果 WebSocket 配置得不对，或者 Header 头部信息丢失，就会导致握手失败，从而出现类似“闪退”的现象。

  3. 数据库状态异常 Beszel 的数据（包括用户信息、连接历史等）都存在本地的 SQLite 数据库里。如果更新过程不干净，或者容器非正常关闭，可能会导致数据锁定或损坏，程序读取失败就会重启连接。

  4. Docker 日志权限与卷挂载 如果你修改了默认的挂载路径，或者权限没给好，Beszel 无法正常写入 Session 数据，也会导致登录态无法保持。

实战修复教程

既然知道原因了，咱们就对症下药。建议大家按照以下顺序尝试，通常第一步就能解决 80% 的问题。

第一步：清理浏览器缓存（必做！）

浏览器开发者工具清理 Local Storage 和 Cookies 示意图

在开发者工具的 Application 标签页中，清空 Local Storage 和 Cookies 是解决登录闪退的关键一步。

不要觉得这是废话，很多疑难杂症都是这就搞定的。

  • 打开浏览器开发者工具（F12）。
  • 切换到 Application 或 应用程序 标签页。
  • 在左侧找到 Local Storage，选中你 Beszel 的域名。
  • 右键点击，选择 Clear（清空）。
  • 同时，顺手把 Cookies 也清一下。
  • 刷新页面，重新尝试登录。

Nginx 反向代理支持 WebSocket 的配置代码片段

确保 Nginx 配置包含 WebSocket 相关的 Header 设置，否则监控功能容易异常。

注：或者直接试一下浏览器的“无痕模式/隐私模式”，如果在无痕模式下能正常登录，那百分之百就是缓存问题了。

第二步：检查 Nginx 反向代理配置

如果你是用 Nginx 反代 Beszel，请确保配置文件中包含了对 WebSocket 的支持。Beszel 的实时监控功能依赖 WebSocket，如果这部分断开，前端就会异常。

参考配置片段：

location / {
    proxy_pass http://127.0.0.1:你的端口;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    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;
}

修改完配置记得 nginx -s reload 重载一下。

第三步：重建容器与数据卷（大招）

如果前两步都不行，那可能是数据真的脏了。为了保险起见，我们可以重建一下容器。注意：此操作会清空当前的监控配置，请做好心理准备。

  1. 停止并删除现有容器： 
    docker stop beszel
docker rm beszel
  2. 检查你的挂载卷目录（假设是 /opt/beszel），把里面的数据文件夹先备份一下，或者直接清空重来（建议先备份）。
  3. 拉取最新的镜像重新运行： 
    docker pull henrygd/beszel:latest
docker run -d --name beszel \
  --restart=unless-stopped \
  -p 你的端口:8080 \
  -v /opt/beszel:/beszel_data \
  henrygd/beszel
  4. 重新初始化账号，登录看看是否正常。

第四步：查看实时日志

如果以上都不行，那就得当一回“福尔摩斯”看日志了。

docker logs -f beszel
``

观察输出信息，看看有没有报错 `panic`、`database is locked` 或者 `permission denied`。如果有 `permission denied`，记得检查宿主机挂载目录的权限，使用 `chown -R 1000:1000 /opt/beszel` 修复一下所有权（具体用户组视你的镜像配置而定）。

### 总结

Beszel 虽然好用，但毕竟是开源项目，偶尔也会有一些小脾气。大部分登录闪退的问题，其实只要**清个浏览器缓存**就能解决。如果是为了追求稳定，在反代配置上多花点心思也是值得的。

希望这篇简单的排查笔记能帮你省去几个小时的折腾时间，大家有遇到其他的坑也欢迎在评论区分享！

标签: none

评论已关闭