iShortn URL缩短与链接分析平台使用教程

iShortn URL缩短与链接分析平台使用教程

ishortn.ink Dynamic Links, URL Shortening, Link Analytics & QR Code Platform: Elevate your link strategy with custom dynamic links for targeted user experiences and QR codes for seamless offline-to-online transitions and Link Shortening with powerful analytics 项目地址: https://gitcode.com/gh_mirrors/is/ishortn.ink

1. 项目介绍

iShortn是一个基于开源技术的URL缩短与链接分析平台。它不仅可以帮助用户缩短长链接，提高链接的易用性和传播效率，还提供了强大的链接追踪分析功能，包括地理位置数据、设备和浏览器统计、来源追踪、独立访客计数等。此外，它还支持自定义域名、自定义别名、友好的链接名称、二维码生成、密码保护、过期设置和链接停用等功能。

2. 项目快速启动

环境准备

• Node.js (推荐使用LTS版本)
• MySQL数据库
• Redis缓存

克隆项目

git clone https://github.com/AmoabaKelvin/ishortn.ink.git
cd ishortn.ink

安装依赖

npm install

配置环境变量

在项目根目录下创建.env文件，并填写以下内容：

DB_HOST=localhost
DB_USER=root
DB_PASS=password
DB_DATABASE=ishortn
REDIS_HOST=localhost
REDIS_PORT=6379

请确保将以上信息替换为您的MySQL和Redis的实际配置。

初始化数据库

运行以下命令以创建数据库和表结构：

npx prisma migrate dev --create-only
npx prisma migrate dev

启动项目

npm run start

现在，您可以通过浏览器访问http://localhost:3000来查看应用。

3. 应用案例和最佳实践

使用自定义域名

为了使用自定义域名，您需要在.env文件中设置CUSTOM_DOMAIN变量，并在您的DNS设置中添加CNAME记录指向您的服务器的IP地址。

利用API进行链接管理

iShortn提供了API接口，允许您通过编程方式创建和管理链接。这可以集成到您的应用程序或自动化流程中，例如：

curl -X POST "http://localhost:3000/api/links" -H "Content-Type: application/json" -d '{"originalUrl": "http://example.com", "alias": "example", "password": "mypassword"}'

4. 典型生态项目

• 前端框架：使用Next.js进行服务端渲染，提供更好的性能和SEO支持。
• 类型系统：采用TypeScript，增强代码的可维护性和开发体验。
• 样式框架：使用Tailwind CSS，快速开发响应式和美观的用户界面。
• 数据库ORM：使用Drizzle ORM管理数据库交互，简化数据操作。
• 缓存：通过Redis提升应用性能，减少数据库负载。

ishortn.ink Dynamic Links, URL Shortening, Link Analytics & QR Code Platform: Elevate your link strategy with custom dynamic links for targeted user experiences and QR codes for seamless offline-to-online transitions and Link Shortening with powerful analytics 项目地址: https://gitcode.com/gh_mirrors/is/ishortn.ink