waiwaylee/lzwlab_cn
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: 部署 Beszel 服务器监控（/beszel/ 子路径）并新增首页入口

Browse Source
This commit is contained in:
waiwaylee
2026-08-31 23:01:55 +08:00
parent 70353ef4c4
commit 67caaa428e
6 changed files with 157 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+11 -3
View File
@@ -1,15 +1,16 @@
# lzwlab.cn 站点部署仓库
lzwlab.cn 个人云服务器上的站点部署项目：包含站点欢迎页、nginx 站点配置、TLS 证书、远程运维脚本，以及从首页链接进入的“文件快传”在线文件暂存工具。上线效果：http 请求自动 301 跳转到 https，`https://lzwlab.cn` 与 `https://www.lzwlab.cn` 均正常展示欢迎页，`https://lzwlab.cn/transfer/` 提供登录鉴权的文件上传/下载服务。服务器上还以 Docker 部署了 RustDesk 自建远程桌面服务（hbbs/hbbr，客户端以域名 `lzwlab.cn` 接入）与 Gitea Git 服务（入口 `https://lzwlab.cn/git/`，首页提供“🐙 进入 Git 服务”按钮）。
lzwlab.cn 个人云服务器上的站点部署项目：包含站点欢迎页、nginx 站点配置、TLS 证书、远程运维脚本，以及从首页链接进入的“文件快传”在线文件暂存工具。上线效果：http 请求自动 301 跳转到 https，`https://lzwlab.cn` 与 `https://www.lzwlab.cn` 均正常展示欢迎页，`https://lzwlab.cn/transfer/` 提供登录鉴权的文件上传/下载服务。服务器上还以 Docker 部署了 RustDesk 自建远程桌面服务（hbbs/hbbr，客户端以域名 `lzwlab.cn` 接入）、Gitea Git 服务（入口 `https://lzwlab.cn/git/`，首页提供“🐙 进入 Git 服务”按钮）与 Beszel 服务器监控（入口 `https://lzwlab.cn/beszel/`，首页提供“📊 服务器状态”按钮）。
## 功能特性
- 静态欢迎页：`index.html`，响应式渐变卡片，中文标题“欢迎访问 lzwlab.cn”，并提供“📦 进入文件快传”“🐙 进入 Git 服务”两个入口。
- 静态欢迎页：`index.html`，响应式渐变卡片，中文标题“欢迎访问 lzwlab.cn”，并提供“📦 进入文件快传”“🐙 进入 Git 服务”“📊 服务器状态”三个入口。
- HTTPS 全站：`lzwlab.nginx.conf` 将 80 端口请求 301 跳转到 443；443 端口启用 TLS 1.2/1.3 与 HTTP/2，证书链由 TrustAsia 签发。
- 文件快传（`/transfer/`）：指定用户登录后才能使用，PC/手机自适应；支持多文件上传与下载进度、有效期设置（默认 7 天，最短 1 小时，最长 30 天）、缓存列表与手动删除；过期文件由 systemd 定时器每 10 分钟自动清理。
- 远程运维脚本：`remote.py` 基于 Paramiko，支持执行远程命令（可 sudo）与上传文件，凭据自动从 `Authentication.md` 解析，无需在命令行传密码。
- RustDesk 自建服务器：Docker Compose 部署 hbbs（ID/注册服务器）+ hbbr（中继服务器），host 网络监听 21115-21119，客户端以域名 `lzwlab.cn` 接入，客户端配置说明见 [setup.md](setup.md) 第 9 节。
- Gitea Git 服务（`https://lzwlab.cn/git/`）：Docker 部署 Gitea 1.27.2（SQLite），管理员私有单实例，关闭开放注册；支持 HTTPS 克隆与 SSH 克隆（端口 2222），部署记录见 [setup.md](setup.md) 第 10 节。
- Beszel 服务器监控（`https://lzwlab.cn/beszel/`）：Docker 部署 Beszel hub（容器 `beszel`，仅监听 127.0.0.1:8092），nginx 子路径 `/beszel/` 反代并支持 WebSocket；部署记录见 [setup.md](setup.md) 第 12 节。
- 完整部署记录：`setup.md` 覆盖从环境检查、安装 nginx、上传站点、HTTPS 配置到验证的全过程，并附踩坑记录。
- 文档维护技能：`.dsh/skills/maintain-docs/`，用于在项目修改后自动更新本 README 与 CHANGELOG.md。
@@ -41,6 +42,8 @@ lzwlab.cn 个人云服务器上的站点部署项目：包含站点欢迎页、n
│ └── docker-compose.yml
├── gitea/ # Gitea Git 服务 Compose 配置（容器 gitea，SQLite）
│ └── docker-compose.yml
├── beszel/ # Beszel 服务器监控 Compose 配置（容器 beszel，hub）
│ └── docker-compose.yml
├── setup.md # 完整部署记录
└── .dsh/skills/maintain-docs/ # 文档维护技能（README/CHANGELOG）
└── SKILL.md
@@ -50,7 +53,7 @@ lzwlab.cn 个人云服务器上的站点部署项目：包含站点欢迎页、n
- 本地（运维机）：Python 3 + Paramiko（`pip install paramiko`）。
- 服务器：Ubuntu 24.04 LTS、nginx 1.24（systemd 管理）、Python 3.12、Flask 3.0.2 与 gunicorn 20.1（apt 安装）。
- 服务器：Docker 29.1.3（apt docker.io + docker-compose-v2，已配置 daocloud 镜像加速）运行 RustDesk hbbs/hbbr 与 Gitea Git 服务。
- 服务器：Docker 29.1.3（apt docker.io + docker-compose-v2，已配置 daocloud 镜像加速）运行 RustDesk hbbs/hbbr、Gitea Git 服务与 Beszel hub。
- 域名 `lzwlab.cn` / `www.lzwlab.cn` 的 DNS 已解析到服务器。
## 安装
@@ -85,6 +88,7 @@ LZWLAB_APP_PASSWORD='$PASS' python deploy_transfer.py --username admin
curl -s -o /dev/null -w "%{http_code}\n" https://lzwlab.cn/ # 200
curl -s -o /dev/null -w "%{http_code}\n" https://lzwlab.cn/transfer/ # 200（登录页）
curl -s -o /dev/null -w "%{http_code}\n" https://lzwlab.cn/git/ # 200（Git 服务登录页）
curl -s -o /dev/null -w "%{http_code}\n" https://lzwlab.cn/beszel/ # 200（Beszel 监控面板）
```
## 部署说明
@@ -97,6 +101,7 @@ curl -s -o /dev/null -w "%{http_code}\n" https://lzwlab.cn/git/ # 200（G
- 文件快传：应用代码安装到 `/opt/lzwlab-transfer`，数据目录 `/var/lib/lzwlab-transfer`，配置 `/etc/lzwlab-transfer/config.json`（root:lzwlab 640）；gunicorn 监听 `127.0.0.1:8090`，由 nginx 将 `/transfer/` 反向代理到该端口，systemd 定时器每 10 分钟执行一次过期清理。
- RustDesk：Compose 文件安装在 `/opt/rustdesk`（hbbs+hbbr，host 网络，数据目录 `/opt/rustdesk/data`）；客户端 ID 服务器/中继/Key 配置见 [setup.md](setup.md) 第 9 节。
- Gitea：Compose 文件安装在 `/opt/gitea`（容器 `gitea`，SQLite 数据卷 `/opt/gitea/gitea`，Web 仅监听 `127.0.0.1:3000`，SSH 映射 `2222→22`）；nginx 按 Gitea 官方 sub-path 方案将 `/git/` 反代到 3000 端口；管理员账号与密码记录在 `Authentication.md`，注册已关闭、安装器已锁定。详见 [setup.md](setup.md) 第 10 节。
- Beszel：Compose 文件安装在 `/opt/beszel`（容器 `beszel`，镜像 `henrygd/beszel:latest`，仅监听 `127.0.0.1:8092`，数据卷 `/opt/beszel/beszel_data`）；nginx 按 Beszel 官方 sub-path 方案将 `/beszel/` 反代到 8092，`APP_URL=https://lzwlab.cn/beszel`；管理员账号与密码记录在 `Authentication.md`。添加被监控节点需在 Web 面板“Add System”中生成 Agent 配置，详见 [setup.md](setup.md) 第 12 节。
## 安全与凭据说明
@@ -108,6 +113,7 @@ curl -s -o /dev/null -w "%{http_code}\n" https://lzwlab.cn/git/ # 200（G
- RustDesk 使用 hbbs 首次启动自动生成的自建密钥（服务器 `/opt/rustdesk/data/id_ed25519.pub`），客户端必须配置该 Key 才能连接；Key 需分发给每个客户端使用，本身不属于机密凭据。
- Gitea 关闭开放注册并锁定安装器；管理员密码只记录在 `Authentication.md`，对外文档一律用 `$PASS` 代替。
- Gitea SSH 克隆端口为 2222，需在腾讯云安全组放行 TCP 2222 后才能从公网使用；HTTPS 克隆与网页访问不受影响。
- Beszel hub 容器端口只绑定 127.0.0.1，公网仅经 nginx HTTPS 访问 `/beszel/`；管理员密码只记录在 `Authentication.md`。
## 参考资料
@@ -117,5 +123,7 @@ curl -s -o /dev/null -w "%{http_code}\n" https://lzwlab.cn/git/ # 200（G
- [deploy_transfer.py](deploy_transfer.py)：文件快传部署脚本
- [rustdesk/docker-compose.yml](rustdesk/docker-compose.yml)：RustDesk 自建服务器 Compose 配置
- [gitea/docker-compose.yml](gitea/docker-compose.yml)：Gitea Git 服务 Compose 配置
- [beszel/docker-compose.yml](beszel/docker-compose.yml)：Beszel 服务器监控 hub Compose 配置
- [Beszel 文档](https://www.beszel.dev/zh/guide/what-is-beszel)：安装、[子路径反向代理](https://www.beszel.dev/zh/guide/reverse-proxy) 参考
- [Gitea 官方文档](https://docs.gitea.com/)：安装与反向代理（sub-path）参考
- [transfer/](transfer/)：文件快传应用源码