Kutt项目自定义域名配置问题解决方案

在使用Kutt自托管服务时，配置自定义域名是一个常见需求。本文将以Docker部署为例，详细讲解如何正确配置Kutt的自定义域名功能。

问题背景

Kutt是一个开源的URL缩短服务，当用户通过Docker Compose自行部署时，可能会遇到自定义域名无法正常工作的问题。主要表现为主域名可以正常使用，但添加的额外自定义域名无法正确解析。

配置要点

1. Docker Compose配置

正确的Docker Compose配置应包含以下关键元素：

services:
  server:
    image: kutt/kutt:latest
    environment:
      DEFAULT_DOMAIN: your-main-domain.com
    ports:
      - 8089:3000

其中需要注意：

• DEFAULT_DOMAIN只需填写域名本身，不需要添加http/https协议前缀
• 端口映射将容器内的3000端口映射到宿主机的8089端口

2. 反向代理配置

使用Caddy作为反向代理时，配置应指向本地映射的端口：

your-main-domain.com {
    reverse_proxy localhost:8089
}

3. 自定义域名配置关键

对于额外添加的自定义域名，必须确保：

1. DNS记录正确指向服务器IP地址
2. 反向代理配置中包含对新域名的处理
3. 防火墙/安全组规则允许相应端口的访问

常见问题排查

1. 端口映射错误：确保自定义域名的流量被正确路由到Kutt服务运行的端口（如示例中的8089）

2. 环境变量配置：检查DEFAULT_DOMAIN是否设置正确，且不包含协议前缀

3. 缓存问题：修改配置后，建议清除浏览器和DNS缓存进行测试

4. 权限问题：确保容器有权限访问配置的卷和网络资源

最佳实践建议

1. 对于生产环境，建议使用数据库而非SQLite以获得更好性能
2. 考虑启用HTTPS以增强安全性
3. 定期备份数据卷以防数据丢失
4. 监控服务运行状态，确保高可用性

通过以上配置和注意事项，用户应该能够成功在自托管的Kutt实例上配置和使用自定义域名功能。