uraniadev/snapp

Snapp

概述

Snapp是一款自托管的URL缩短解决方案，适用于重视URL管理控制权并希望探索新技术的用户。该项目最初为个人技术探索项目，0.7版本因开发问题进行了完全重构，0.8版本为后续1.0版本奠定了基础。现通过Prisma确保平台稳定可维护，支持ARM、ARM64等多架构，并可通过环境变量轻松集成多种数据库。

核心功能

• 直观用户界面：提供友好的操作界面，简化链接缩短流程。
• 安全认证：保障用户会话安全，保护用户信息。
• 自定义短码：支持个性化短码设置，使链接更易记忆和分享。
• 过期日期管理：可设置链接过期时间以增强安全性，或选择永久有效。
• 私密链接：通过唯一密钥实现私密分享，仅限特定受众访问。
• 使用分析：提供详细的***访问数据，洞察链接参与度。
• 扩展指标集成：支持与自托管或云托管的Umami Analytics集成，获取高级统计数据。
• URL信誉检查：通过VirusTotal API验证链接安全性。
• REST API支持：提供社区需求的API端点用于远程管理，Swagger文档见此处。

使用场景

Snapp适合需要自主管理URL缩短服务的个人、团队或组织，尤其适用于：

• 需要品牌化短链接的营销场景
• 需控制链接生命周期的安全敏感场景
• 重视隐私的链接访问数据分析需求
• 需集成自托管分析工具的场景
• 需要私密分享或链接安全验证的场景

使用方法与配置

部署示例

通过Docker Compose部署0.8版本的配置示例：

yaml
services:
  snapp:
    image: uraniadev/snapp:0.8
    ports:
      - 3000:3000
    environment:
      DATABASE_URL: "file:./db.sqlite"  # 数据库连接URL
      DATABASE_PROVIDER: sqlite         # 数据库类型(mysql|sqlite|pg)
      TOKEN_SECRET: ""                  # 使用`openssl rand -base64 32`生成
      ORIGIN: "https://example.com"     # 实例基础URL

环境变量说明

迁移说明

支持通过CSV导出工具在版本间迁移URL，但仅适用于相邻版本直接迁移（如0.7→0.8），跨版本导出文件不兼容。建议迁移前备份数据，使用Prisma确保数据结构一致性。

技术栈

• 前端框架：Svelte Kit
• ORM工具：Prisma
• 认证系统：Lucia Auth
• 样式框架：Tailwind CSS
• 地理定位：MaxMind
• 图标库：Phosphor Icons
• API文档：SwaggerUI
• 图表工具：AMCharts、ChartJS