Just-Moh-it/Pckd：注重分析、可自托管、界面美观的链接缩短工具

Just-Moh-it

796

91 29

MIT License

技术解读

以下内容由 GitRead 中文社区编辑团队基于项目 README 与官方资料整理，结合中文开发者的常见使用场景补充技术选型建议。具体以项目官方文档为准。

深度技术分析：Just-Moh-it/Pckd

项目背景与痛点

在数字化时代，简短的链接不仅仅是美学的追求，更是用户体验和传播效率的保障。传统长链接不仅难以记忆，传播过程中也容易产生错误。Just-Moh-it/Pckd 项目应运而生，它提供了一个高性能、数据可视化支持的自托管链接缩短服务。项目不仅专注于链接的缩短，还通过先进的技术手段，让用户可以进行更深入的数据分析，并提供了一个简洁美观的用户界面。相比于商业化的服务提供商，如 bit.ly，Pckd 提供了更加灵活和成本效益高的方案。

核心技术揭秘

Pckd 的架构设计充分体现了现代微服务和异步处理的理念。后端主要使用了Go语言开发，以确保高性能和高并发处理能力。前端则采用了React框架，提供了用户友好的界面设计。此外，数据库采用了PostgreSQL，以满足其高可用性和高效的数据检索需求。数据流图如下所示，其中展现了关键组件和它们之间的交互：

graph TD A[用户请求] --> B{"API Gateway"} B -->|"路由"| Z1[C[Backend API]] B -->|"路由"| Z2[D[Dashboard API]] C --> E[Link Shortening Service] C --> F[Data Analytics Service] D --> G[Dashboard Service] E --> H[ShortURL Storage] F --> I[Analytics DB] G --> J{"Authentication"} J -->|"认证通过"| K[User Dashboard] J -->|"失败"| L[错误响应]

架构分解与实现细节

API Gateway：作为流量入口，路由用户请求到不同的服务。
Backend API：处理链接缩短、统计等主要业务逻辑。
Dashboard API：提供数据分析的访问接口。
Link Shortening Service：负责生成短链接，并将数据存储到 ShortURL Storage。
Data Analytics Service：收集用户行为数据，通过 Analytics DB 进行数据分析并反馈到前端。

功能亮点与差异

相比于同类产品，Pckd 的独特优势在于其自托管能力和内置数据分析功能。通过使用Pckd，企业无需担心第三方服务商的隐私问题，同时，内建的数据分析功能能够直观地展示链接分发的时效性和地域性，为企业决策提供依据。项目提供了开箱即用的部署脚本，使得部署过程简单高效。

应用场景与落地建议

Pckd 适合各类需要链接管理和数据分析的企业或个人使用。如电商网站、自媒体平台，都可以通过部署Pckd来实现高效的链接管理并洞察读者行为。然而实际部署时需注意，虽然项目文档详尽，但部署中的数据库优化、定时任务设置等问题仍需从业人员具有一定的经验。此外，安全管理也极其重要，以防止潜在的数据泄露风险。

综合评价

优点：

强大的自托管能力与灵活的部署方案。
内建的数据分析工具，助力企业决策。
简洁直观的前端设计，增强用户体验。

缺点：

初步接触的用户可能需要一些时间学习部署流程。
数据库设计需额外优化，以应对大规模并发访问场景。

总体来看，Just-Moh-it/Pckd 在满足新时代用户多元化需求的同时，也为企业提供了强大的分析与管理工具。对于开发者而言，这是一个值得研究和部署的优秀开源项目。

关于

GitHub 原始描述（英文）

The ⚡️ analytics-intensive, self-hostable link-shortener with a beautiful UI | AKA free bit.ly alternative 🚀

描述取自 GitHub 官方 API，保持仓库作者书写的原文。

简要分析

热度分

980

价值分

503

活跃状态

归档

bitly customizable graphql javascript link-shortener nodejs react reactjs redux self-hosted tracking url url-shortener

GitHub

语言占比

Dockerfile

HTML

JavaScript

Shell

贡献者

README

Pckd

🔗 Pckd

Quick start • Demo • Docs • Blog • Twitter • Discord

⛔️🛑 This version of the project is not currently being maintained

We’re focusing our efforts towards creating Pckd V2, since further development/improvements on V1 won’t be sustainable. Therefore, we can’t guarantee solutions to all problems at the time. Please check back in a few months for Pckd V2. Until then, try out other awesome URL shorteners like dub, etc.

Pckd is a free-to-use URL Shortener, that can be easily self-hosted with awesome features like:

🔗 Shorten URLs (or pckds) with, or without an account
🖌️ Customize back-halfs on every pckd
🔌 Deploy to custom URL and Infrastructure
🧤 Customize settings like link back-halfs, link targets, tracking info, etc.
🕵️‍♂️ Track each click on a pckd, and retrieve
- 🌐 IP address (Spoof-resistant)
- 🕸️ ISP Name
- 🗺️ IP-Location
- 💻 Device details like OS Version and Device Model
- 🪟 Browser Name and including version
💯 Custom Loading/Redirecting Screen (self-hosted only)
🏃‍♂️ Quick Redirections in 150ms!
🔐 Fast, Reliable and Secure
👮 Secure Secret Storage and handling using 💻 environment variables
✨ Built on a modern tech stack
💿 Compatible with MySQL, PostgreSQL, MongoDB and many more

This project was created to be the most powerful URL shortener for the public, so no wonder it’s so feature-rich

(back to top)

📸 Screenshots

Here is a sneak peek of the application and it’s visuals 😍:

Dashboard Page
Login	Signup
Account Page	Reset Password
Home Page

Want to create your own iteration? View the designs on Figma

(back to top)

🎗 Supporters

Pckd is made possible by support from some awesome folks including:

😇 One-off Backers

_Geeked

_{Ben Notix}

_{Rizwan Ahmed}

_{[Add your support]}

🤔 Why does Pckd exist?

After looking at all the aka.ms links out there which flood windows, along with the numerous time saving been prompted to buy premium plans from bit.ly while shortening my URLs, the decision of having a reliable, personal URL shortener hosted on a custom domain for free caught wind.

(back to top)

🧮 Comparison

Pckd stacks up well against major URL Shorteners

Comparison Table including other free and paid
shorteners

(back to top)

😲 Built With (Tech Stack)

The following technologies were involved in the making of this project.

⚛️ React JS - Frontend
🚀 Apollo GraphQL Server v3 - Server API
🧩 GraphQL Template By Mohit - Boilerplate for Apollo
💿 Prisma - ORM
😨 Any relational or non-relational database that Prisma supports
🗺️ Redux w/ Redux Toolkit - State management
🌐 IP Registry - Free Geolocation lookups

(back to top)

🤯 Quick Start Guide

To get started with having your own instance of Pckd, follow the steps described in the following section

🚦 Get an API Key first

Pckd uses IP Registry for Geo-location look-ups to track hits (free for 100,000 lookups)

Obtain an API key from the ipregistry.co website

💾 Installation

Pckd supports the following installations

🛠 Build from source code
📦 [Soon] Deploy the release
🐳 [Unstable] Docker-Compose Installation
🐋 [Soon] Docker-Hub Pre-built Image

Read all installation docs here

(back to top)

🛣 Roadmap

This project is far from perfect, and we’ll reach there one day, or at least get close.

Link-in-bio feature (Discussion #49)
Admin Panel Support (Discussion #43)
Multiple Subdomain Support (Discussion #14)
Email Notifications for hits if enabled (Discussion #18)
Custom OG Preview for social-sharing (Discussion #39)
One-Click Deploys (Discussion #44)
Password-protected links (Discussion #41)

Have a look at the 🛣 Roadmap for a full list of proposed features and enhancements.

(back to top)

📐 Architecture

Here’s a diagram explaining exactly how everything fits into place

Here's how everything fits into the scene

🌈 Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag “enhancement”. Don’t forget to give the project a star! Thanks again!