开源  ·  自托管  ·  Apache 2.0

邀请归因,
开箱即用

用户点击邀请链接并安装 App 后,邀请码在首次启动时自动识别回填。无需剪贴板权限,无需用户登录,无需第三方 SDK 绑定。

无需用户感知 无需用户登录 数据完全自控 iOS · Android · Web 三端 SDK Apache 2.0 开源
POST /v1/resolutions — 首次启动自动识别邀请码
// 移动端 SDK — 首次启动时调用
POST /v1/resolutions
Authorization: Bearer sk_live_•••
 
200 OK  ·  置信度 0.94
{
  "inviteCode": "INV-2024-K9X",
  "channel": "fuzzy",
  "confidence": 0.94,
  "matchedAt": "2024-01-15T08:32:11Z"
}
工作原理

五步完成,零摩擦。

设备指纹技术弥合了网页点击与 App 安装之间的鸿沟 — 无需 Cookie,无需登录,无需剪贴板权限。

分享链接

用户 A 生成并分享邀请链接

点击访问

用户 B 打开落地页

采集指纹

JS SDK 采集浏览器多维特征信号

安装 App

用户 B 安装并首次打开

自动匹配

邀请码精准识别并自动回填

核心功能

一切所需,
恰到好处。

专为不想被第三方锁定的开发者设计,精准追踪邀请归因,数据永远归你所有。

完全自托管

数据永远不离开你的基础设施。一条 docker compose up 命令即可部署完整服务栈(API + PostgreSQL + Redis)。无供应商锁定,无月租费用,永久免费。

三通道归因引擎

Redis 精确哈希匹配(高速缓存,零延迟)→ PostgreSQL 模糊评分(多维特征加权)→ Android 剪贴板兜底。三级降级确保最大化匹配率。

智能设备指纹

综合 IP 子网、时区、屏幕分辨率、语言、操作系统版本、硬件并发数等多维信号加权匹配。置信度阈值(0–1)可自由配置,匹配窗口期默认 72 小时。

全平台原生 SDK

iOS 原生 Swift SDK、Android Kotlin SDK、TypeScript Web SDK,三端全覆盖,全部开源。生产就绪,几行代码完成接入,无需额外依赖。

自定义邀请码

带上你自己的邀请码,原样存储与返回。生成规则、校验逻辑、使用次数限制完全由你控制。支持自定义元数据字段随邀请码一同传递。

多租户 & 用量配额

以共享 SaaS 模式运行,支持按项目 API 密钥管理、用量配额分层控制(Free / Pro / Unlimited);或以单租户模式部署,零鉴权开销,适合私有团队。

SDK 集成

几分钟完成接入

覆盖全平台的官方 SDK,即插即用。全部开源,无黑盒依赖。

Web / JavaScript

TypeScript · 浏览器 + Node.js
npm install @share-installs/js-sdk

iOS

Swift 5.9+ · CocoaPods
pod 'ShareInstalls' # SPM: swift package add share-installs/sdk-ios

Android

Kotlin · Gradle
implementation("com.share-installs:sdk-android:0.0.1")
价格方案

从免费开始,
按需升级。

不管是独立开发者还是成长中的团队,都有适合你的方案。自托管版永久免费开源。

自托管
免费 / 永久

部署在你自己的服务器,数据完全自控,无任何使用限制。

  • 无限项目 & API 调用
  • 数据永远不离开你的服务器
  • 一键 Docker Compose 部署
  • 含 PostgreSQL + Redis
  • Apache 2.0 开源协议
  • 完整源码可 Fork / 修改
查看 GitHub 文档
免费版
$0 / 月

适合个人开发者和小型项目,无需信用卡,注册即用。

  • 每分钟 10 次归因解析
  • 1 个项目
  • GitHub OAuth 登录
  • Dashboard 基础数据
  • 全平台 SDK 支持
  • 无优先支持
免费注册
Unlimited
$29 / 月

适合高流量应用和企业级团队,无限扩展,专属支持。

  • 每分钟 600 次归因解析
  • 无限项目
  • 专属客服 & 响应 SLA
  • 自定义配额限制
  • Pro 版全部功能
  • 发票 & 团队账单管理
立即升级

需要超出 Unlimited 的定制配额?联系我们 获取企业方案。 或直接选择自托管,零成本无限使用。

部署方式

你的基础设施,你来选

零配置自托管,或带 GitHub OAuth 和用量配额的完整 SaaS — 一个环境变量切换。

自托管

自己跑,完全掌控

部署在你自己的服务器或私有云,数据不出你的基础设施。适合隐私要求严格的团队和单应用场景,无任何使用上限。

  • 一键 Docker Compose 部署
  • 无需身份认证,开箱即用
  • 可选 Admin Secret 管理项目
  • 内含 PostgreSQL + Redis
  • Apache 2.0,源码完全开放
SaaS 托管

开箱即用,专注业务

无需维护服务器,注册即用。为团队启用多租户模式,GitHub OAuth 登录,按项目 API 密钥管理,基于订阅计划的用量配额。

  • GitHub OAuth 一键登录
  • 按项目 API 密钥管理
  • Free / Pro / Unlimited 三档
  • Dashboard 可视化 + 用量分析
  • 无需运维,随时扩容
快速开始

60 秒跑起来

自托管模式三步完成部署,SaaS 模式注册即可使用 — 无需配置服务器。

自托管部署 — bash
# 1. 克隆仓库
git clone https://github.com/ceeyang/share-installs.git
cd share-installs

# 2. 启动所有服务(API + PostgreSQL + Redis + Dashboard)
docker compose up --build -d
验证部署
curl http://localhost:6066/health
→ {"status":"ok","mode":"self-hosted","version":"1.0.0"}

# 3. 创建你的第一个项目
curl -X POST http://localhost:6066/v1/projects \
  -H "Content-Type: application/json" \
  -d '{"name":"my-app"}'
→ {"id":"proj_xxx","apiKey":"sk_live_•••"}
完整部署文档
常见问题

你可能想知道的

找不到答案?在 GitHub Issues 上提问,我们会尽快回复。

自托管和 SaaS 托管的核心区别是什么?
自托管意味着你在自己的服务器上运行全部服务,数据不会离开你的基础设施,无任何使用上限,永久免费。SaaS 托管由我们运维,你无需管理服务器,注册即用,适合不想维护基础设施的团队。两者使用的是同一套代码,功能完全一致。
设备指纹归因的准确率有多高?
在正常网络环境下,精确哈希匹配(Redis 通道)准确率接近 100%;模糊指纹匹配(PostgreSQL 通道)置信度通常在 0.85 以上。你可以通过配置 FINGERPRINT_MATCH_THRESHOLD(默认 0.75)来调整接受匹配的最低置信度阈值,在精准度与覆盖率之间取得平衡。
免费版有哪些限制?升级后能立即生效吗?
免费版限制为每分钟 10 次归因解析、1 个项目,适合个人项目和初期验证。升级到 Pro 或 Unlimited 后,新的配额限制立即生效,无需重启服务或重新配置 API 密钥。如果你的流量需求更高,也可以随时切换到自托管方案,完全没有限制。
不用 SDK,能直接调用 REST API 吗?
完全可以。share-installs 提供标准的 RESTful API,任何能发 HTTP 请求的语言或平台都可以直接对接,无需安装 SDK。SDK 只是对 API 的封装,方便快速集成,但不是必须的。API 文档和示例见 GitHub 仓库。
我的数据安全吗?会被用于其他目的吗?
自托管模式下,你的所有数据都存储在自己的服务器,我们完全无法访问。SaaS 模式下,你的归因数据仅用于为你提供服务,不会被用于任何广告或第三方目的。代码完全开源,你可以随时审计所有数据处理逻辑。

开源,永久免费

自托管零成本运行,或在 SaaS 免费版上快速验证你的想法。

免费开始使用 在 GitHub 上 Star