核心用法
uf2-net 是 uf2.net 短链接服务的 CLI 封装工具，面向开发者和自动化场景设计。主要功能包括：
短链接创建：将长 URL 转换为 https://uf2.net/{code} 格式，支持随机生成或自定义 slug（4-64 字符，仅限小写字母、数字、下划线、连字符）。
链接管理：列出用户创建的所有短链接、查看单条链接的公开元数据（点击次数、原始 URL）、删除指定链接。
统计追踪：通过公共 API 端点获取链接点击数据，无需认证即可查询任意链接的基础统计信息。
使用流程
1. 注册获取 API Key：通过 POST /api/v1/accounts/register 注册账号，响应中包含 api_key；需妥善保管。
2. 配置凭证：通过环境变量 UF2_API_KEY 注入密钥，避免硬编码。
3. 执行操作：使用 uf2.sh 脚本或直接向 https://uf2.net/api/v1/ 发送 HTTP 请求。
显著优点
- API 优先设计：专为机器人和自动化工作流优化，支持 JSON 响应、标准 REST 接口
- 永久有效：创建的短链接永不过期，适合长期分享的文档、资源链接
- 自定义品牌：支持自定义 slug，可创建如
uf2.net/my-project的品牌化短链接 - 公开统计透明：点击数据公开可查，便于快速验证链接使用情况
- 免费可用：开放注册，包含免费使用层级
潜在缺点与局限性
- 完全公开性：所有短链接及其元数据（原始 URL、点击数）均为公开信息，不适合敏感内容或需要访问控制的场景
- 无访问限制：任何人获得短链接即可访问目标地址，无法设置密码、过期时间或访问次数限制
- 私有地址拒绝：服务主动拒绝 localhost、私有 IP 范围的 URL，无法用于内部测试环境
- 自定义 slug 冲突：热门词汇可能已被占用，返回 409 错误
- 依赖外部服务：链接可用性完全依赖 uf2.net 的持续运营
适合人群
- 需要在脚本/CI 流程中自动生成短链接的开发者
- 希望追踪公开资源分享效果的内容运营者
- 追求简洁 API 体验的工程师和 bot 开发者
- 不适合：需要访问控制的企业内链、含敏感参数的长 URL、临时一次性链接场景
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| **凭证泄露** | API Key 硬编码或提交到版本控制 | 强制使用环境变量或系统密钥链 |
| **信息泄露** | 短 URL 被意外传播后无法撤销访问 | 避免缩短含敏感 token 或 PII 的 URL |
| **钓鱼滥用** | 短链接隐藏真实域名，可能被用于钓鱼 | 仅缩短可信域名，告知接收者验证目标 |
| **服务中断** | 第三方服务可用性风险 | 关键场景保留原始长 URL 备份 |
| **slug 抢注** | 品牌相关 slug 被他人占用 | 尽早注册重要自定义 slug |