Kutt项目自托管配置：解决首页无限循环问题

在使用Kutt进行自托管部署时，配置首页和域名设置是一个关键步骤。本文将通过一个典型问题案例，深入分析如何正确配置Kutt的自托管环境，避免常见的配置陷阱。

问题现象分析

当用户在自己的服务器上通过Docker部署Kutt后，尝试修改设置中的域名和首页配置时，系统会出现无限循环的问题。具体表现为：

• 将域名和首页都设置为s.mydomain.com时，系统进入无限重定向循环
• 任何将首页设置为非localhost:3000的值都会导致应用不可用

根本原因

经过排查发现，这个问题源于环境变量的不正确配置。Kutt的自托管部署需要正确设置以下两个关键环境变量：

1. DEFAULT_DOMAIN：指定默认的域名
2. CUSTOM_DOMAIN_USE_HTTPS：如果需要使用HTTPS，则需要设置此变量

正确配置方法

1. 环境变量配置

在Docker部署时，应该通过环境变量来配置这些参数，而不是在应用界面中直接修改。正确的做法是在docker-compose.yml或启动命令中设置：

environment:
  - DEFAULT_DOMAIN=s.mydomain.com
  - CUSTOM_DOMAIN_USE_HTTPS=true

2. 配置原则

• DEFAULT_DOMAIN应该设置为你的主域名，这是所有短链接生成时的默认域名
• 如果使用HTTPS，必须设置CUSTOM_DOMAIN_USE_HTTPS为true
• 避免在应用界面中直接修改这些核心配置，应该通过环境变量来管理

配置建议

1. 生产环境部署：建议始终使用HTTPS，设置CUSTOM_DOMAIN_USE_HTTPS=true
2. 多环境管理：开发、测试和生产环境应该使用不同的配置
3. 配置验证：部署后，先访问首页验证是否正常，再测试短链接功能

常见问题排查

如果遇到类似问题，可以按照以下步骤排查：

1. 检查Docker容器的环境变量是否正确设置
2. 查看应用日志，确认配置是否被正确加载
3. 清除浏览器缓存，避免旧配置的缓存影响
4. 确保反向代理(如Nginx)的配置正确，没有额外的重定向规则

通过正确理解Kutt的配置机制，可以避免这类自托管部署中的常见问题，确保短链接服务稳定运行。