Kutt
一款现代化、可自托管的 URL 缩短器，支持自定义域名、链接统计和用户管理。
智能下载
前往项目主页
该项目暂未提供安装包，请直接访问源代码仓库
自建短链接服务，自定义域名，统计点击，管理用户。
核心功能
- 支持自定义域名，打造品牌短链
- 为链接设置密码、过期时间和描述
- 内置点击统计，查看每个链接的详细数据
- 管理后台可管理用户和所有链接
- 支持 SQLite / PostgreSQL / MySQL 多种数据库
避坑指南
- •生产环境必须设置 JWT_SECRET 环境变量（一个长随机字符串）否则无法正常运行。2. 原官方域名 kutt.it 因注册问题已停用，现在默认使用 kutt.to，自托管时请配置你的域名。3. 需要一定的技术基础（命令行、环境变量配置）才能顺利部署。4. 自定义域名需自行配置 SSL 证书（如果启用 HTTPS）。
适用场景
- 个人或团队搭建内部短链接服务，避免使用公共工具
- 营销人员创建带品牌域名的短链接并跟踪效果
- 开发者通过 API 自动生成短链并嵌入应用
详细介绍
Kutt 是一款现代化的开源 URL 缩短器，专为自托管而设计。它支持自定义域名，让你可以打上自己品牌的短链接。你可以为链接设置自定义别名、密码、过期时间和描述，还能查看每个链接的详细点击统计。管理员可以通过后台管理面板管理所有用户和链接，还支持主题定制来改变外观。它提供了 RESTful API 方便程序调用，支持 SQLite、PostgreSQL、MySQL 多种数据库，并能通过 Docker 一键部署。内置 OIDC 登录集成，可与企业身份提供商对接。Kutt 拥有清晰、响应式的用户界面，适合个人、团队或组织搭建私有的、可品牌化的短链接服务，摆脱对第三方服务的依赖。
常见问题与排障 (2)
故障排除为什么复制的链接前面会出现双重的'https://'（例如：https://https://example.com/link）？
当域配置（DEFAULT_DOMAIN 或 CUSTOM_DOMAIN）包含类似'https://'的协议时会出现此问题。如果 CUSTOM_DOMAIN_USE_HTTPS 为 true，应用程序会自动添加'https://'，导致重复。解决方法是移除域值中的'https://'。例如：DEFAULT_DOMAIN=example.com 且 CUSTOM_DOMAIN_USE_HTTPS=true。
故障排除为什么在Kutt v3.2.3中OIDC认证不起作用？
OIDC支持在最新的稳定版本(v3.2.3)中尚未可用。它仅存在于主分支中。要使用OIDC，请从主分支构建Docker镜像，而不是使用官方发布镜像。关注仓库以获取即将包含OIDC的版本。
标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
步骤1：确保已安装 Docker 和 docker-compose
步骤2：在终端执行 `docker compose up` 启动服务
步骤3：打开浏览器访问 http://localhost:3000 ，按提示创建管理员账号
- 步骤1：确保已安装 Docker 和 docker-compose
- 步骤2：在终端执行 `docker compose up` 启动服务
- 步骤3：打开浏览器访问 http://localhost:3000 ，按提示创建管理员账号
暂未获取到校验码
该项目暂未在 GitHub Release 页面提供 SHA-256 校验码
SHA256 校验码
暂无校验码
建议从 GitHub Releases 页面直接下载，并自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
如果你使用 Docker 部署，执行 `docker compose down` 停止并删除容器，然后删除项目目录即可。如果是手动部署，删除项目文件夹并清理数据库文件。
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
2 FAQs