oneko/kutt

Kutt镜像说明

镜像概述

Kutt是一款开源的现代URL短缩工具，支持自定义域名绑定、自定义短链接路径、密码保护及点击统计功能，帮助用户高效管理和分享链接。该镜像基于官方Kutt项目构建，提供便捷的容器化部署方式。

核心功能

• 开源免费，支持二次开发与定制
• 自定义域名绑定，打造专属短链接服务
• 自定义短链接路径，提升记忆性与品牌辨识度
• 短链接密码保护，保障敏感链接安全
• 私有点击统计数据，可视化分析访问情况
• 全链路链接管理（查看、删除、复用）
• RESTful API支持，便于集成到第三方应用

使用场景

• 个人用户：缩短长链接，方便分享至社交平台或消息应用
• 团队/企业：统一管理内部文档链接，统计外部访问数据
• 营销人员：跟踪推广链接点击量，优化获客策略
• 开发者：通过API快速集成短链接功能到自有应用

配置说明

依赖服务

需提前部署Neo4j（图数据库）和Redis（缓存服务）。

关键环境变量

Docker部署示例

Docker Run命令

bash
docker run -d \
  --name kutt-service \
  -p 3000:3000 \
  -e DB_HOST=neo4j://your-neo4j-ip:7687 \
  -e DB_USER=neo4j \
  -e DB_PASS=your-neo4j-password \
  -e REDIS_HOST=your-redis-ip \
  -e REDIS_PORT=6379 \
  -e DEFAULT_DOMAIN=s.your-domain.com \
  oneko/kutt

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3.8'
services:
  kutt:
    image: oneko/kutt
    container_name: kutt
    ports:
      - "3000:3000"
    environment:
      DB_HOST: neo4j://neo4j:7687
      DB_USER: neo4j
      DB_PASS: kutt_neo4j_pass
      REDIS_HOST: redis
      REDIS_PORT: 6379
      SITE_NAME: My Kutt Service
      DEFAULT_DOMAIN: s.my-domain.com
    depends_on:
      - neo4j
      - redis
    restart: unless-stopped

  neo4j:
    image: neo4j:5.15
    container_name: kutt-neo4j
    ports:
      - "7474:7474" # 管理界面
      - "7687:7687" # Bolt协议端口
    environment:
      NEO4J_AUTH: neo4j/kutt_neo4j_pass
    volumes:
      - neo4j_data:/data
    restart: unless-stopped

  redis:
    image: redis:7.2
    container_name: kutt-redis
    ports:
      - "6379:6379"
    volumes:
      - redis_data:/data
    restart: unless-stopped

volumes:
  neo4j_data:
  redis_data:

运行命令：docker-compose up -d

部署完成后，访问http://localhost:3000即可使用Kutt服务。