Skip to content
11zePublic

About

部署在 Cloudflare Workers 的聚合搜索页。

Resources

Security policy

Stars

0 stars

Watchers

1 watching

Forks

Repository files navigation

so

基于 Cloudflare Workers 的搜索入口聚合站:一次输入,选一个站点继续搜。

功能

  • 自定义搜索引擎列表(src/config.js),入口按综合、社区、影音、动漫分组
  • 搜索历史,数据只存浏览器本地
  • 免服务器部署
  • 简洁卡片视觉,深浅色可手动切换,默认跟随系统
  • 没有关键词时保持顶部对齐,中部留一句提示,不再列出最近搜索
  • 输入验证、输出转义、CSP 等安全防护

使用

  • 输入关键词,按 Enter 搜索
  • 按 / 快速聚焦搜索框
  • 右上角按钮切换浅色/深色,选择会存到本地
  • 点击搜索历史项重新搜索;历史面板可一次清空
  • 搜索与点历史都在当前页更新入口,不整页刷新;地址栏同步,浏览器前进后退可用
  • 可设为浏览器搜索引擎:https://so.wangze.tech?q=%s,关键字 so(自部署请换成自己的地址)

自部署

推荐 clone 后用 wrangler 部署:

git clone https://github.com/11ze/so.git
cd so
npx wrangler deploy

部署完成后拿到访问地址;修改 src/config.js 里的搜索引擎列表,再部署一次即可。

也可以在 Cloudflare 控制台操作,流程如下:

创建 Worker

在线编辑代码并部署

部署成功,拿到访问地址

Worker 设置页

部署产物为零构建的单文件 HTML,架构决策见 docs/adr/0001。

开发

项目结构

so/
├── src/
│   ├── worker.js            # Cloudflare Worker 入口
│   ├── result.js            # 页面组装与服务端渲染
│   ├── template.html        # 页面骨架(含槽位占位符)
│   ├── styles.css           # 页面样式
│   ├── client.js            # 客户端脚本(以文本内联)
│   ├── result.test.js       # 页面渲染测试
│   ├── ui.test.js           # 浏览器回归测试(需 Node 22+ / Chrome)
│   ├── config.js            # 搜索引擎配置
│   └── utils/
│       ├── security.js      # 安全工具模块
│       ├── security.test.js # 安全测试
│       └── test-harness.js  # 自研最小测试框架(三套测试共用)
├── docs/                    # 文档目录(含 adr/)
├── text-loader.mjs          # 测试专用文本导入 loader(不参与部署)
├── register-text-loader.mjs # 测试入口:注册上面的 loader(不参与部署)
├── SECURITY.md              # 安全策略文档
├── HOW_TO_TEST.md           # 测试说明
├── wrangler.toml            # Wrangler 配置(含文本模块 rules)
└── package.json             # 项目配置

测试

npm test

包含安全、页面渲染与浏览器回归三套测试。浏览器回归覆盖空态顶部对齐与提示、12 条历史面板、清空回空态、390px 无溢出;需要 Node 22+(内置 WebSocket)和本机 Chrome,Chrome 默认查找 macOS/Linux 常见路径,找不到时用 CHROME_PATH 指定。只跑浏览器回归:npm run test:ui。手动测试步骤见 HOW_TO_TEST.md。

自定义搜索引擎

编辑 src/config.js,添加或修改搜索引擎:

{
  name: '搜索引擎名称',
  url: 'https://example.com/search?q=%s',
  icon: 'https://example.com/favicon.ico', // 可选,支持 URL 或 base64
}

安全性

  • 输入验证:关键词长度限制(500 字符)、XSS 模式检测、URL 仅允许 HTTP/HTTPS
  • 输出转义:HTML 内容与属性值转义,优先使用 textContent 等安全 DOM API
  • 安全响应头:CSP、nosniff、X-Frame-Options、HSTS、Referrer-Policy、Permissions-Policy
  • 本地数据:localStorage 读取验证,损坏数据自动清理

详见 SECURITY.md。

技术栈

  • Cloudflare Workers(Serverless)
  • 原生 JavaScript,零框架、零构建
  • localStorage 存搜索历史

许可证

MIT

About

部署在 Cloudflare Workers 的聚合搜索页。

Resources

Security policy

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages