常见问题 FAQ

如果你遇到的问题没有在此列出，欢迎在 GitHub 提交 Issue 或 Discussion。

Cloudflare快速部署报错: An unknown error occurd

这可能是GitHub/GitLab 授权问题：

解决步骤：

• 访问 https://github.com/settings/installations
• 找到 Cloudflare Workers and Pages 应用
• 卸载该应用
• 重新通过部署按钮授权

仓库同步

问：如何让自己的 Fork 跟上游保持一致？

• 打开你 Fork 的仓库主页，点击右上角的 Sync fork 按钮即可。
• 或者本地执行 git remote add upstream https://github.com/7Sageer/sublink-worker.git，再通过 git fetch upstream && git merge upstream/main 同步。

访问与域名

问：为什么生成的订阅在国内无法访问？

• *.workers.dev 域名在国内地区经常被阻断。
• 建议在 Cloudflare Pages/Workers 中绑定自定义域名，并将解析托管在 Cloudflare，以便灵活配置 Rules/SSL。
• 如果暂时无法绑定，可使用代理访问或将订阅拉取逻辑部署在海外服务器。

KV 持久化

问：Node/Docker 部署时怎样确保 KV 持久化？

• 推荐使用仓库自带的 docker-compose.yml：它会同时启动 Redis 7，并加载 redis.conf 以启用 RDB 快照，数据写入 redis-data 卷。
• Compose 默认使用 GitHub Actions 推送的镜像 ghcr.io/7sageer/sublink-worker，可通过 SUBLINK_WORKER_IMAGE 改为自建镜像。
• 若倾向托管 KV，可配置 KV_REST_API_URL & KV_REST_API_TOKEN 直连 Upstash/Vercel KV；当两者都未设定时会回退到内存存储，可用 DISABLE_MEMORY_KV=true 禁止。

其他建议

• 保存基础配置或短链前，确保 Worker 已连接到持久化 KV。
• 如果你替换了默认规则集或添加新的语言，请务必在 PR 中更新文档。
• 反馈问题时建议附带：部署方式、运行时日志、输入样例以及 Worker 版本，便于排查。