Kutt短链接部署全攻略：2分钟快速上手与详细教程

April 4, 2026

Kutt 是一款功能强大的现代开源URL缩短器。它不仅支持自定义域名，还提供了链接创建与编辑、访问统计查看以及用户管理等一系列实用功能。

主要特点：

自托管适配性强
- 零配置快速启动，无需额外构建步骤。
- 数据库支持：默认使用SQLite（无需安装），也可选择Postgres或MySQL/MariaDB。
- 缓存支持：可选Redis以提升性能。
- 权限管控：可禁用用户注册、关闭匿名链接生成，并支持OpenID Connect (OIDC)登录。
丰富的自定义能力
- 自定义域名：支持绑定自有域名生成短链接。
- 链接精细化配置：可为短链接设置自定义URL、访问密码、描述和过期时间。
- 链接管理：支持查看、编辑和删除已生成的链接。
统计与管理
- 私有统计：短链接的访问数据仅对创建者或管理员可见。
- 管理员面板：支持后台管理用户，并审核或操作所有链接。
其他能力
- 主题定制：支持界面主题自定义。
- RESTful API：提供完整的接口，便于集成到其他系统。

安装步骤

通过 Docker Compose 可以快速部署 Kutt。以下是一个基本的配置示例：

services:  
  kutt:  
    image: kutt/kutt:latest  
    container_name: kutt  
    ports:  
      - 3000:3000  
    volumes:  
      - ./db_data_sqlite:/var/lib/kutt  
      - ./custom:/kutt/custom  
    environment:  
      - DB_FILENAME=/var/lib/kutt/data.sqlite  
      - JWT_SECRET=sk-xxxxx  
      - DEFAULT_DOMAIN=192.168.31.90:3000  
    restart: always

关键环境变量说明：

DB_FILENAME：指定SQLite数据库文件的存储路径。
JWT_SECRET：用于签署身份验证令牌，建议使用长且随机的字符串。
DEFAULT_DOMAIN：设置您的域名或IP地址及端口。

更多高级参数配置建议参考官方文档以获得最佳实践。

使用指南

部署完成后，在浏览器中访问 http://您的服务器IP:3000 即可看到Kutt的初始界面。

首先，根据页面提示创建一个管理员账号。

账号创建成功后，使用该账号登录系统。

注意： 为了确保所有功能正常工作，建议通过HTTPS访问管理界面。例如，可以通过反向代理将3000端口映射到3001等HTTPS端口，避免跳转问题。

登录后的管理面板设计简洁，下面简要介绍基本使用方法。

在输入框中粘贴一条长URL，然后点击提交按钮。

系统会立即生成一个对应的短链接，点击该链接即可访问原始地址。

重要提示： 如果使用了反向代理，请务必将Docker Compose配置中的 DEFAULT_DOMAIN 环境变量修改为代理后的地址（例如 https://您的域名）。

在管理面板中，您可以查看所有已创建的短链接，并进行集中管理。

短链接服务的一个重要价值在于，它允许您在不更改原始链接的情况下，灵活地控制最终跳转的目标地址。

除了基本的访问次数统计，您还可以为短链接设置访问密码，以增加安全性。

勾选“显示高级选项”，可以进一步配置链接的描述、自定义别名和过期时间等详细参数。

其他设置项相对直观，有兴趣的用户可以深入探索。建议亲自部署并体验各项功能。

总结与推荐

Kutt 这款URL缩短器的部署教程早已在计划之中，但由于其需要配置HTTPS反向代理才能完全正常使用，因此一度被搁置。实际部署体验下来，整体流程相当顺畅，操作界面也十分简单易用。需要注意的是，其管理界面默认不支持中文，但这并不影响核心功能的使用。

此类工具最大的优势在于能够保持原链接不变，同时自由修改跳转目的地，并精确统计访问量。对于普通个人用户而言，它的实际作用可能有限，但对于有链接管理、营销跟踪或内部跳转需求的用户来说，则是一个不错的选择。

综合推荐指数： ⭐⭐（根据个人实际需求决定，对大多数人非必需） 使用体验评分： ⭐⭐⭐（需配置HTTPS代理，但上手操作简单） 部署难易程度： ⭐⭐（过程直接，难度较低）