Repository navigation
v2.23.0
This release introduces target URL deduplication for short links and improves the project documentation.
New Features
- Added domain-level duplicate URL policies:
deny: Return an existing short link for the same target URL.allow: Always create a new short link.by_request: Let each creation request decide. This is the default policy.
- Added the
find_if_existsparameter to single and batch short-link creation APIs. - Added the
is_existingresponse field to indicate whether an existing short link was returned. - Added duplicate URL policy settings and a deduplication switch to the admin interface.
- Short links with custom codes are excluded from deduplication.
- Deduplication only reuses active, unexpired, non-deleted links within the same workspace and domain.
Database Changes
- Added the
url_hashcolumn and a composite index to theshort_linkstable. - Added the
duplicate_policycolumn to thedomainstable. - URL hashes for existing short links are backfilled asynchronously after the upgrade.
- MySQL, PostgreSQL, and SQLite are supported.
Other Improvements
- Refactored the README and deployment documentation.
- Added test coverage for short-link deduplication.
Upgrade Instructions
Back up your database, configuration, and data directories before upgrading:
docker compose pull
docker compose up -dDatabase migrations run automatically when the service starts. Existing domains use the by_request policy by default, so short-link creation behavior remains unchanged unless deduplication is enabled.
For installations with a large number of short links, index creation and URL hash backfilling may temporarily increase database load. Upgrading during off-peak hours is recommended.