Immich相册管理系统URL配置问题解析

问题背景

Immich是一款优秀的自托管照片管理系统，近期有用户在升级到1.116.2版本后遇到了服务无法启动的问题。系统日志显示与外部域名配置相关的验证错误，具体表现为"ERR_INVALID_URL"错误。

错误现象分析

当用户尝试启动最新版Immich服务时，系统抛出以下关键错误信息：

1. 系统配置验证失败，具体是server.externalDomain属性未通过isUrl验证
2. 错误类型为TypeError: Invalid URL
3. 错误代码为ERR_INVALID_URL
4. 输入值为immich.owndomain.xyz（示例域名）

根本原因

该问题源于Immich新版本对系统配置中externalDomain字段的严格URL格式验证。系统期望该字段必须符合完整的URL格式（包含协议头），而用户仅提供了域名部分。

临时解决方案

用户通过环境变量注入配置的方式暂时解决了问题：

1. 设置IMMICH_CONFIG_FILE环境变量指向自定义配置文件
2. 配置文件内容清空了externalDomain字段
3. 同时清空了loginPageMessage字段

虽然这种方法能让服务重新启动，但会导致无法使用GUI界面，属于临时性解决方案。

专业建议

对于需要配置外部域名的用户，建议采用以下规范格式：

1. 必须包含协议头（http://或https://）
2. 完整格式示例：https://immich.yourdomain.com
3. 避免仅使用域名或IP地址

对于使用Hassio插件的用户，应确保在插件配置中按照上述格式填写外部域名参数。如果暂时不需要外部访问功能，可以完全清空该配置项。

后续处理

该问题已反馈至Immich开发团队，预计会在后续版本中优化验证逻辑或提供更明确的错误提示。用户可关注官方更新日志获取修复信息。