如何修复 MinIO 控制台:因网络错误无法登录
问题
尝试登录 MinIO 控制台时,你会收到以下错误消息:
minio_login_error.txt
unable to login due to network error
然而,MinIO 服务器本身运行正常,你可以使用 mc 命令行工具或 S3 兼容客户端访问它。
解决方案
在运行 MinIO 服务器的 docker-compose.yml 中,你设置了 MINIO_SERVER_URL。这在旧版 MinIO 中是必需的,但现在已不再需要,实际上它会导致控制台登录失败。
只需移除 MINIO_SERVER_URL 环境变量,然后重启 MinIO 容器即可。
故障配置示例
docker-compose-broken.yml
services:
minio:
image: quay.io/minio/minio:RELEASE.2025-07-23T15-54-02Z
command: server --console-address ":9001" /data
volumes:
- ./data:/data
- ./config:/root/.minio
environment:
- MINIO_ROOT_USER=minioadmin
- MINIO_ROOT_PASSWORD=Aecae1ahl3yadath5uoz3ohSaihooh
- MINIO_DOMAIN=minio.mydomain.com
- MINIO_SERVER_URL=https://minio.mydomain.com
- MINIO_BROWSER_REDIRECT_URL=https://console.minio.mydomain.com修复后的配置示例
docker-compose-fixed.yml
services:
minio:
image: quay.io/minio/minio:RELEASE.2025-07-23T15-54-02Z
command: server --console-address ":9001" /data
volumes:
- ./data:/data
- ./config:/root/.minio
environment:
- MINIO_ROOT_USER=minioadmin
- MINIO_ROOT_PASSWORD=Aecae1ahl3yadath5uoz3ohSaihooh
- MINIO_DOMAIN=minio.mydomain.com
- MINIO_BROWSER_REDIRECT_URL=https://console.minio.mydomain.com现在重启 MinIO 容器,你应该就能再次登录控制台了。
If this post helped you, please consider buying me a coffee or donating via PayPal to support research & publishing of new posts on TechOverflow