如何修复 MinIO 控制台:因网络错误无法登录

问题

尝试登录 MinIO 控制台时,你会收到以下错误消息:

minio_login_error.txt
unable to login due to network error

MinIO 因网络错误无法登录

然而,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 容器,你应该就能再次登录控制台了。


Check out similar posts by category: MinIO, Docker