122 lines
8.8 KiB
Markdown
122 lines
8.8 KiB
Markdown
# 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 服务”按钮）。
|
||
|
||
## 功能特性
|
||
|
||
- 静态欢迎页：`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 节。
|
||
- 完整部署记录：`setup.md` 覆盖从环境检查、安装 nginx、上传站点、HTTPS 配置到验证的全过程，并附踩坑记录。
|
||
- 文档维护技能：`.dsh/skills/maintain-docs/`，用于在项目修改后自动更新本 README 与 CHANGELOG.md。
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
.
|
||
├── Authentication.md # 服务器凭据（机密，勿公开/勿提交）
|
||
├── index.html # 站点欢迎页
|
||
├── lzwlab.nginx.conf # nginx 站点配置（HTTP→HTTPS、TLS、HTTP/2）
|
||
├── lzwlab.cn_nginx/ # TLS 证书与私钥（私钥勿公开/勿提交）
|
||
│ ├── lzwlab.cn.csr
|
||
│ ├── lzwlab.cn.key
|
||
│ ├── lzwlab.cn_bundle.crt
|
||
│ └── lzwlab.cn_bundle.pem
|
||
├── remote.py # Paramiko 远程执行/上传脚本
|
||
├── deploy_transfer.py # 文件快传一键部署脚本（幂等，可重复执行）
|
||
├── transfer/ # 文件快传应用源码
|
||
│ ├── app.py # Flask 应用入口（gunicorn 启动）
|
||
│ ├── auth.py # 配置加载、scrypt 密码哈希、登录限流
|
||
│ ├── storage.py # SQLite 元数据 + 磁盘缓存存储层
|
||
│ ├── cleanup.py # 过期文件/孤儿缓存清理 CLI
|
||
│ ├── templates/index.html # 响应式单页前端（登录/上传队列/下载进度/文件列表）
|
||
│ └── systemd/ # systemd 服务与清理定时器单元
|
||
│ ├── lzwlab-transfer.service
|
||
│ ├── lzwlab-transfer-cleanup.service
|
||
│ └── lzwlab-transfer-cleanup.timer
|
||
├── rustdesk/ # RustDesk 自建服务器 Compose 配置（hbbs/hbbr）
|
||
│ └── docker-compose.yml
|
||
├── gitea/ # Gitea Git 服务 Compose 配置（容器 gitea，SQLite）
|
||
│ └── docker-compose.yml
|
||
├── setup.md # 完整部署记录
|
||
└── .dsh/skills/maintain-docs/ # 文档维护技能（README/CHANGELOG）
|
||
└── SKILL.md
|
||
```
|
||
|
||
## 环境要求
|
||
|
||
- 本地（运维机）：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 服务。
|
||
- 域名 `lzwlab.cn` / `www.lzwlab.cn` 的 DNS 已解析到服务器。
|
||
|
||
## 安装
|
||
|
||
本项目无需本地构建。站点文件与 nginx 配置通过 `remote.py` 上传到服务器后安装；文件快传应用通过 `deploy_transfer.py` 一键部署，完整步骤见下文“部署说明”。
|
||
|
||
## 使用说明
|
||
|
||
`remote.py` 用法：
|
||
|
||
```bash
|
||
# 执行远程命令（sudo 命令需加 --sudo）
|
||
python remote.py "sudo nginx -t" --sudo
|
||
python remote.py "sudo systemctl reload nginx" --sudo
|
||
|
||
# 上传文件（LOCAL 为本地路径，REMOTE 为远端路径）
|
||
python remote.py --put index.html /tmp/lzwlab-index.html
|
||
```
|
||
|
||
- 凭据由脚本从 `Authentication.md` 解析，无需在命令行传密码。
|
||
- Windows Git Bash 提示：MSYS 会把以 `/` 开头的参数转换成 Windows 路径，上传远端路径时请加 `MSYS_NO_PATHCONV=1`。
|
||
|
||
部署文件快传（应用登录密码经环境变量传入，仅密码哈希会写入服务器配置）：
|
||
|
||
```bash
|
||
LZWLAB_APP_PASSWORD='$PASS' python deploy_transfer.py --username admin
|
||
```
|
||
|
||
验证站点：
|
||
|
||
```bash
|
||
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 服务登录页）
|
||
```
|
||
|
||
## 部署说明
|
||
|
||
完整步骤见 [setup.md](setup.md)（环境检查 → 安装 nginx → 上传站点 → 配置 HTTP/HTTPS → 验证）。要点：
|
||
|
||
- 站点根目录：`/var/www/lzwlab.cn`；
|
||
- nginx 配置安装到 `/etc/nginx/sites-available/lzwlab.cn` 并软链到 `sites-enabled/`，改配置后执行 `sudo systemctl reload nginx`；
|
||
- 证书安装到 `/etc/nginx/ssl/`（私钥权限 600、root:root）；
|
||
- 文件快传：应用代码安装到 `/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 节。
|
||
|
||
## 安全与凭据说明
|
||
|
||
- `Authentication.md` 含服务器凭据，属机密：不要提交到公开仓库、不要写入任何对外文档；文档中密码一律以 `$PASS` 代替。
|
||
- `lzwlab.cn_nginx/lzwlab.cn.key` 为私钥，上传到服务器后权限应为 600（root:root）。
|
||
- 站点已启用 HTTPS 并强制 301 跳转，nginx 配置限定 TLS 1.2/1.3。
|
||
- 文件快传登录密码只以 scrypt 哈希形式保存在 `/etc/lzwlab-transfer/config.json`，应用不保存明文密码；会话 Cookie 带 `Secure`、`HttpOnly`、`SameSite=Lax`，登录接口带按 IP 限流，写接口要求 `X-Requested-With` 头。
|
||
- 文件快传缓存文件按有效期自动删除，请在服务器上自行控制磁盘空间。
|
||
- RustDesk 使用 hbbs 首次启动自动生成的自建密钥（服务器 `/opt/rustdesk/data/id_ed25519.pub`），客户端必须配置该 Key 才能连接；Key 需分发给每个客户端使用，本身不属于机密凭据。
|
||
- Gitea 关闭开放注册并锁定安装器；管理员密码只记录在 `Authentication.md`，对外文档一律用 `$PASS` 代替。
|
||
- Gitea SSH 克隆端口为 2222，需在腾讯云安全组放行 TCP 2222 后才能从公网使用；HTTPS 克隆与网页访问不受影响。
|
||
|
||
## 参考资料
|
||
|
||
- [setup.md](setup.md)：完整部署记录与踩坑记录
|
||
- [CHANGELOG.md](CHANGELOG.md)：变更日志（遵循 Keep a Changelog 与 SemVer）
|
||
- [index.html](index.html)：站点页面源码
|
||
- [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 配置
|
||
- [Gitea 官方文档](https://docs.gitea.com/)：安装与反向代理（sub-path）参考
|
||
- [transfer/](transfer/)：文件快传应用源码
|