Repository navigation
Releases
StashKit v0.1.24
StashKit v0.1.24
本版发布 v0.1.23 之后已合并至主分支的修复,精简无用入口与过期工作流。规则内容不变。
- 新导入的主配置将
Proxy的REJECT放在第一位。确认订阅节点加载后,需手动选择Auto或实际节点。旧设备保留过的选择需要单独检查;已选择 Auto/Fallback 且节点集为空时,仍存在 DIRECT 回退风险。 - 删除与主配置完全重复的
StashKit-Subscription.yaml。日常使用统一导入StashKit.yaml。 - 不再单独发布 Privacy 和 Local 配置。DNS 隐私继续通过
overrides/dns-privacy.stoverride.example启用;离线 ZIP 会按需生成StashKit-Local.yaml,仍需手动部署规则资源。 - 修复离线 ZIP 安装说明中的规则版本路径,并固定发布任务的 Python 3.12 和依赖安装步骤。
- 删除仅供 v0.1.22、v0.1.23 迁移使用的两份 one-time-sync GitHub Actions 工作流。
本次仅更新配置版本至 v0.1.24。54 份基础规则继续使用 v0.1.23 的固定提交与缓存路径,Crypto 单独沿用 v0.1.13 的规则来源和 v0.1.18 的离线路径。40 个策略组、55 份远程规则、133 条内嵌 Private-local 匹配器、DNS 默认行为、13 条 WebRTC 拦截规则及整体分流顺序均不变。
离线 ZIP 不支持一键导入。请按 README-OFFLINE.txt 部署 55 份规则并核对 SHA256SUMS。配置含无效 Airport 订阅占位符,需在本地换成自己的订阅地址。
GitHub CI 仅覆盖静态规则与资源校验。WebRTC 泄露、空节点回退和真实网络出口应在 Stash 真机及控制器日志中验收。
StashKit v0.1.23
StashKit v0.1.23
本版按 LoonKit v7.0.16 完成 Apple Intelligence、New Siri 和 Stripe 的远程分流同步。
- Apple 规则库增加 Apple PCC 的
apple-relay.cloudflare.com、apple-relay.fastly-edge.com、cp4.cloudflare.com。既有 Siri 域名继续由 Apple 后缀覆盖。 - AppleOTA、Apple 两份
RULE-SET移到通用 Cloudflare 之前,保持 AppleOTA 优先于 Apple;其余 Cloudflare 流量不变。 SharedInfrastructure-domain增加+.stripe.com、+.stripe.network,由原有 Proxy 接管 Stripe 支付和风控。- 四条 Apple EdgeKey 旧规则已经被原有上级后缀完全覆盖,故删除冗余。
- 40 个策略组、55 份远程规则 Provider、133 条 Private-local 内嵌规则、最终
MATCH,Final以及个人节点绑定方式不变。 - 默认 Stash、Privacy、Local、兼容 ALL 与 Preview 配置统一更新,离线规则包可在正式 Release 中获取。
更新 Stash 配置后刷新远程规则缓存。修改过 Airport 私人订阅的用户应备份配置并在新版填回原 URL。CI 只能验证静态配置与下载资源,真机 DNS、GeoIP 和出口结果以 Stash 记录为准。
StashKit v0.1.22
StashKit v0.1.22
- 夸克网盘继续直连,规则已加入原有国内补充规则库。
- 维基百科和多邻国国际站继续走代理,规则已加入原有通用代理规则库。
- 远程规则仍为 55 份。没有新增策略组,也没有向主配置写入本地域名规则。
- 更新配置后刷新远程规则即可。其他服务、节点和 DNS 设置保持原样。
StashKit v0.1.21
StashKit v0.1.21 — 统一订阅配置入口
本版取消公开 StashKit-SelfHosted.yaml 独立自建模板,唯一推荐的在线入口为 StashKit.yaml。在本地把 proxy-providers.Airport.url 换成真实 HTTPS Clash/Stash YAML 节点订阅;示例 example.invalid 不可用。
- 保留 40 个策略组(
Proxy固定 Auto、Fallback、REJECT),38 个需节点组继续使用AirportProvider。 - 不修改 DNS、路由规则、55 份远程规则快照及图标。
- 需要在本机维护个人静态节点时,可使用
scripts/build_loon_selection.py --layout flat生成私人配置;仓库不再提供单独自建版下载入口。 - CI 能验证配置结构,但无法模拟 iOS Stash VPN。应在受影响设备对照 VPN 开关、节点刷新前后的选项。
私人订阅地址、节点密码和 Token 不应提交到公开仓库。
StashKit v0.1.20
StashKit v0.1.20 — 自建节点明确引用
这次修复针对用户在 VPN 启动后 Proxy 只显示真实节点、丢失 Auto/Fallback/REJECT 的实际反馈:用户确认 v0.1.13 工作正常,v0.1.19 仍失败。
版本差异:v0.1.13 使用具名 Airport Provider;v0.1.16–v0.1.19 的自建单文件方案改用 include-all: true。这次自建版不再让 Stash 运行时同时处理固定选项和 include-all 节点。
- StashKit-SelfHosted.yaml 改为一份明确引用
SelfHosted占位节点的单节点模板;默认节点参数无效,应替换。可直接修改该节点参数,但名称必须保持SelfHosted。 - 使用自己的多个节点或希望重命名时,运行
python scripts/build_loon_selection.py --layout flat --nodes-from dist/nodes-source.yaml --output dist/StashKit-Personal.yaml,由工具从个人节点 YAML 自动填充所有需要节点的策略组,并保持 Auto、Fallback、REJECT 在上方;不用将私人节点名硬编码进仓库。 - v0.1.13 的
use: [Airport]节点订阅模式继续在 StashKit-Subscription.yaml 保留,适合不方便运行本地生成器、具有自己的 Clash/Stash YAML 订阅 URL 的用户。 - 远程规则仍为 55 份独立固定快照(包括 219 条 Crypto);原有 DNS 与路由顺序保持不变,无需粘贴或本地化全部规则。
验收边界:静态校验和 CI 不能模拟 iOS Stash VPN。必须在受影响设备检查 VPN 关闭、开启和节点更新后是否始终显示完整策略;若仍失败,请以运行时 API 对照 UI 继续定位。
StashKit v0.1.19
StashKit v0.1.19
策略组可读格式与选择顺序修正候选:针对 VPN 启动后 Proxy 只列出节点、丢失 Auto/Fallback/REJECT 的报告。
- 40 个策略组恢复多行 YAML,Proxy 明确先写
Auto → Fallback → REJECT,然后才引用Airport或自建节点。各业务组同样先列固定策略,再声明节点来源。 - 高级原生生成器修复曾将 REJECT 排在具体节点之后的问题,输出顺序现在固定为
Auto → Fallback → REJECT → 节点。 - 保留 v0.1.18 的远程规则架构:55 个固定提交的远程规则 Provider,其中 Crypto 为 LoonKit v7.0.13 的 219 条规则;不新增大批本地域名。
- 加入 CI 组字段顺序校验及 Stash 控制器运行时检查,检测固定选项被动态节点覆盖或错序的情况。
必须真机确认: YAML 的 Flow Mapping 与 Block Mapping 语义相同,格式回退不保证能修复 Stash 在 VPN 启动后的动态组加载故障。请实际对比 VPN 开启前/后的 Proxy 成员及 Stash 网络设置中的排序方式;若运行时只剩节点,仍须继续定位 App 具体行为。
兼容回退:如果动态 Provider 混用的运行时问题仍存在,可以按 README 使用 --layout flat 从自己的节点来源生成明确选项的个人配置。此方法只将个人节点明确列在配置中,55 份业务规则仍为远程引用。静态节点需手动重新生成,不要把生成的私人配置提交到公共仓库。
StashKit v0.1.18
StashKit v0.1.18
同步 LoonKit v7.0.13 的 Crypto 远程规则,同时保留 StashKit 原有 40 策略组、节点来源和 54 份冻结分类资源。
本次变更
- Crypto 远程规则 29 → 219:将 LoonKit 的
DOMAIN/DOMAIN-SUFFIX精确转成 Stashdomain文本规则;使用固定 40 位提交的 GitHub Raw URL,path为./rules/v0.1.18/Crypto.v7.0.13.domain.txt;将其与主 YAML 解耦。 - 广告优先级:AdBlock 在 Crypto 前匹配;但旧 AdBlock 仍含
coincheck.com主页误拦,故在 AdBlock 前增加仅该主机的一条DOMAIN,coincheck.com,Crypto,不向整域或公共 CDN 扩大例外。 - 可复现构建:新增 Crypto 源锁、已审核源的独立 CI checkout、SHA256/条目数/原 29 根域保留回归;更新自建、订阅、隐私、离线及兼容配置。
- 文档改版:README 对齐 LoonKit 的展示结构,突出导入方式、规则按需远程引用、使用风险和故障排查。
升级注意
公开模板不包含真实节点,仍需手动填写私有订阅或自建节点。首次运行需要加载 55 个远程规则文件;Local 离线版必须单独安装全部资源。版本缓存目录已更换,旧 v0.1.17/Crypto.domain.txt 不再作为当前 Crypto Provider 的目标;请更新并启用新配置,检查 Stash 实际下载结果和请求记录。
验证边界:CI 校验 YAML 结构、静态规则顺序、冻结来源与远程字节;无法证明某一版本 Stash App 的真机匹配、DNS/IPv6 漏洞防护、节点可用性或分流性能。推荐按 验收指南 测试。
StashKit v0.1.17
StashKit v0.1.17 — 远程规则解耦与精简 YAML
为什么改
主配置 v0.1.16 长达 983 行:40 个策略组全部展开、54 个远程规则 Provider 每个占多行、内嵌 133 条私网匹配器,Crypto 29 条规则还直接写在 rules 中。规则实际上已经部分远程化,但声明重复占据绝大多数文件行数。
本次
- 主配置减少到约 280 行。40 个策略组的名称、类型、优先顺序、默认选项、图标以及 Provider 引用保持不变;54 个原有远程规则的 URL、缓存、interval、类型全部保留,只将重复的 YAML 声明改成紧凑的 Flow Mapping。
- Crypto 独立远程规则集:29 个 LoonKit v7.0.12 Crypto 后缀匹配变为
Crypto-domain+RULE-SET,Crypto-domain,Crypto。以behavior: domain和format: text使用不可变远程地址,离线版本包含相同规则字节,优先级保持在通用业务和 CN 直连之前。 - 安全的 Private-local 保持内嵌:133 个私网 DNS / LAN 条目仅压缩排列,不改匹配器,不把首次启动时的私网识别变成远程依赖。
- 双节点模式不受影响:订阅版和自建多节点版均压缩到约 280 行,自建版仍用 Stash 官方
include-all: true自动载入全部本地节点。 - 自动化验证:检查 54 份原有冻结规则 SHA 和 Provider 精确一致、Crypto 29 条与上游完全对应、所有公开变体的策略与路由顺序保持一致、在线 Crypto 文件 HTTP 字节一致、离线 ZIP 55 份规则文件齐全。
注意事项
主文件中的规则声明比 Loon 配置略长是 Stash 的 rule-providers 模式要求:要在 rules: 中按策略引用,须先声明具名远程规则集。这并不意味着规则数据被塞回主 YAML。
v0.1.17 离线资源包除旧的 rules/v0.1.4/ 54 个文件外,还包括 rules/v0.1.17/Crypto.domain.txt;单纯导入 ZIP 不会自动复制缓存资源。设备端连接、DNS 及首次远程规则下载仍需使用 Stash 检查。
StashKit v0.1.16
StashKit v0.1.16 — 修复自建多节点不显示
修复
- 问题:v0.1.15 的
StashKit-SelfHosted.yaml将 38 个需要节点的策略组固定为单个SelfHosted,因此用户向顶层proxies:复制额外节点后,策略组不会自动列出新名字。 - 改进:依照 Stash 官方策略组说明,自建版的 38 个节点策略组改为
include-all: true,自动引用顶层proxies:的全部本地节点(无远程 Provider)。保留 Auto / Fallback、业务分流组和原有固定候选选项;AdBlock / Final 保持原样。 - 使用方法:下载
StashKit-SelfHosted.yaml,仅在顶层proxies:中填写 1 个或多个 Stash/Clash 格式节点,名称可以不同但不得重复;保持单个顶层proxies:字段。重新从本地文件导入 Stash,选择并启用新导入的配置,再检查 Proxy / Auto / ChatGPT 等策略组。 - 安全:公开样例的地址与密码均无效;请仅在个人本地副本填写真实订阅与自建节点认证凭据。
保持不变
- 40 个原生策略组和分流规则;29 条 Crypto 规则及对应专属图标;已固定的 54 份远程规则;DNS 与 STUN / TURN 处理。
StashKit-Subscription.yaml和StashKit.yaml仍为 Airport 动态订阅,使用方式不变。兼容配置只同步版本号。- 增加了任意三个不同节点名称及重名拒绝的结构回归。通过 CI 不等于 Stash App 已对实际节点连接和 DNS 做真机验收。
请勿把个人服务器地址、UUID、密码、订阅 Token 或其他密钥推送到公开仓库。
StashKit v0.1.15
StashKit v0.1.15 — 订阅 / 自建双入口
- README 首页提供两条明确下载路径:StashKit-Subscription.yaml(修改 proxy-providers.Airport.url)和 StashKit-SelfHosted.yaml(修改顶层 proxies 的 SelfHosted 节点定义)。
- 新增完整单文件自建节点配置:保留 40 个策略组、54 份远程规则资源及原有 DNS / STUN 防护;移除订阅版 Airport Provider,将 38 个需节点策略组直接绑定单个静态 SelfHosted 节点,Auto / Fallback 使用相同节点池。无需改动每个组,也无需额外本地代理文件。
- 自建版公开文件使用无效服务器地址和密码占位符;必须在本地替换真实协议、地址、端口和认证参数,节点名称应保持 SelfHosted。示例为 Shadowsocks,其他协议需按对应 Stash 语法填写。
- 订阅版依旧自动更新;StashKit.yaml 与 StashKit-Subscription.yaml 内容一致。其他正式和兼容配置只同步配置版本号,没有变更规则、DNS、策略组选项或图标。
- 将自建版加入确定性派生与结构回归;CI 不能代替真实 Stash App 对协议连接、DNS 和断线行为的设备验收。
请勿将私人订阅链接、凭证、UUID、私钥或自建服务器秘密提交到公开仓库。