lumen-bridge

无状态本地边缘桥接。它在本机提供入口，但不创建数据库 schema、数据目录或本地 blob 缓存；页面、静态资源和接口响应都直接读取远端缓存服务。

运行

npx @aocoding/lumen-bridge --remote http://copy.bangdao-tech.com --port 8787

快速体验

要求 Node.js 20 或更高版本。

cd apps/lumen-bridge
npm start -- --remote https://easy.bangdao-tech.com/capture --port 8787

然后打开：

http://127.0.0.1:8787

首页会实时读取远端站点列表。进入镜像后仍使用 http://<原站域名>.localhost:8787，以保持不同站点的 Cookie、localStorage 和路径隔离。

也可以作为 npm CLI 使用：

npx lumen-bridge \
  --remote https://easy.bangdao-tech.com/capture \
  --port 8787

环境变量与 CLI 参数等价：

LUMEN_BRIDGE_REMOTE_URL=https://easy.bangdao-tech.com/capture
LUMEN_BRIDGE_PORT=8787
LUMEN_BRIDGE_HOST=127.0.0.1

设计边界

• 不连接数据库。
• 不创建本地数据目录。
• 不把页面、资源、接口响应或站点元数据写入磁盘或内存缓存。
• 首次访问一个 *.localhost 镜像域名时实时调用远端 hostname 查询接口；站点 ID 随后只保存在该域名的 HttpOnly 路由 Cookie 中，避免每个图片请求都重复查询。这个 Cookie 不保存缓存内容。
• 本地首页只负责展示远端站点入口，响应带 Cache-Control: no-store。
• 当前只转发 HTTP/HTTPS 请求，不支持 WebSocket 升级；远端当前的回放能力本来也未覆盖 WebSocket/SSE 完整还原。

验证

npm test
npm run pack:check