PUEH WebOS 是一个类似桌面操作系统的浏览器初始标签页,包含窗口管理、多工作区、桌面自定义、文件管理、照片、音乐、便签和配置同步等功能。
这个目录是专门用于公开发布的独立版本,不会覆盖私有部署版本。
- 已删除 PUEH 云盘、Cloudreve OAuth 和全部相关 API 路由。
- 已删除云盘客户端 ID、客户端密钥、Cookie 密钥和回调地址配置。
- 保留 WebDAV 上传、自动同步、文件浏览、下载和删除。
- WebDAV 地址、用户名和密码由用户在浏览器中自行填写,仅保存在当前浏览器本机,不进入账号配置同步。
- 仓库不包含
.env、数据库文件、日志、Token、实际账号、密码或私钥。
startpage.html、startpage.js、startpage.css:可独立查看的前端文件。assets/:前端静态资源。server/:Express + MySQL 后端和可直接部署的public/目录。server/.env.example:仅包含配置字段和空密码,不包含实际凭据。
只查看桌面界面时,可以直接打开 startpage.html。配置同步、网站图标代理、随机音乐和文件快递柜需要启动后端:
cd server
npm ci启动前通过部署平台或系统环境变量配置数据库。不要把真实值写入源码或提交到仓库:
DB_HOST=<database-host>
DB_USER=<database-user>
DB_PASS=<database-password>
DB_NAME=<database-name>
然后运行:
npm start默认访问地址为 http://localhost:3000/。更多后端配置见 server/README.md。
在 WebOS 中进入“设置 -> 数据与账号 -> WebDAV 存储”,填写自己的 WebDAV 服务地址、用户名、密码和根目录。
WebDAV 服务需要:
- 使用 HTTPS;
- 允许当前 WebOS 来源跨域访问;
- 支持
PROPFIND、MKCOL、PUT、GET和DELETE; - 在 CORS 中允许
Authorization、Depth和Content-Type请求头。
浏览器本地保存的密码只是 Base64 编码,不等同于加密。不要在公共设备中保存 WebDAV 凭据。
cd server
npm test
npm audit同时确认仓库中不存在 .env、数据库导出、日志、私钥或部署备份。建议在托管平台开启 Secret Scanning 和依赖安全更新。
程序代码使用 MIT License。项目中的品牌名称和第三方主题图片不自动获得 MIT 授权;公开分发或商业使用前,应确认相应素材的授权,或替换为你拥有权利的资源。详见 THIRD_PARTY_ASSETS.md。