Yu9191 / sub-store-workers

하위 매장 직원

Sub-Store 后端的 Cloudflare Workers 移植版

注意:一键部署按钮仅供参考,由于项目需要本地构建(esbuild + Sub-Store 源码),实际无法直接通过此按钮完成部署。 请参照下方手动部署步骤。

자동 배치:本仓库已内置 GitHub Actions 工作流,每天自动检测上游 Sub-Store 更新并部署到 Cloudflare. 只需配置 Secrets 即可开启,无需本地操作。 详见 GitHub Actions 자동 同步上游.

简介

将 Sub-Store 后端部署到 Cloudflare Workers / Pages,无需服务器,免费使用。

• 零服务器:运行在 Cloudflare 边缘网络
• KV 지속화:데이터저장在 Cloudflare KV
• 完整功能：复用原始后端全部业务逻辑（订阅管理、格式转换、下载、预览等）
• 预编译解析器:p eggy 文法在构建时编译,避免运行时 eval()

目录

• 部署（核心流程，建议从这里开始）
• 进阶配置 / 平台说明（推送、环境变量、本地开发等，已折叠）
• 자주 묻는 질문
• 同步更新
• Surge 面板脚本
• 致谢 ｜ 许可证

架构说明（如果你只想部署可跳过）

仅替换了平台相关层，核心逻辑零修改：

Workers 文件	作用
'판매자/open-api.js'	KV 替换 fs,fetch 替换 undici
'벤더/express.js'	Workers fetch handler 替换 Node express
'핵심/app.js'	导入 Workers 版 OpenAPI
'utils/env.js'	环境检测
'휴식/token.js'	允许 Workers 签发 토큰
'index.js'	Workers 입구

더 详细的项目总图见 'mydocs/codemap/project-overview.md'.

部署

部署总览:1.준비 → 2.上传 Workers/Pages → 3.设密码(必做)→ 4.连接前端

왜 두 개의 都要部?'.workers.dev' 在国内被 GFW 封锁,'.pages.dev' 走 Cloudflare CDN 通常可直连。

• 有自定义도메인:只用 Workers 即可
• 无自定义域名:P ages 对外提供 API,Workers 在后台跑 Cron.

1. 克隆仓库

2. 로그인 Cloudflare

3. 创建 KV 이름 공간

将返回的 'id' 填입 'wrangler.toml':

4. 构建 & 部署

两者都需要部署：

部署方式	域名	用途
노동자들	'*.workers.dev' 또는 自定义도메인	API + Cron 定时同步
페이지	'*.pages.dev'	API(国内可直连)

⚠️ **执行下方部署命令前，请先确认已完成「1. 克隆仓库」「2. 登录 Cloudflare"「3. 创建 KV 이름 空间」三步

---

🌐 본 텍스트는 빠른 이해를 돕기 위한 요약 번역본입니다. 정확한 기술 정보 및 전체 코드는 GitHub 원문에서 확인하실 수 있습니다.