Skip to content

Repository files navigation

PUEH WebOS Open Source Edition

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。

WebDAV

在 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。

About

WebOS初始标签页

Topics

Resources

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages