容器常见问题

镜像拉取失败

国内服务器无法连接 Docker Hub，需配置镜像加速。

Docker

「应用」->「Docker」->「管理」->「配置」，添加：

{
  "registry-mirrors": [
    "https://docker.1ms.run"
  ]
}

Podman

「应用」->「Podman」->「管理」->「Registry 配置」，末尾添加：

[[registry]]
location = "docker.io"
[[registry.mirror]]
location = "docker.1ms.run"

镜像加速地址可使用 毫秒镜像 或其他服务。

编排启动失败

1. 点击「日志」查看错误信息
2. 常见原因：
   • 端口被占用：修改映射端口
   • 镜像拉取失败：配置镜像加速
   • 配置错误：检查 docker-compose.yml 语法

容器无法访问

1. 检查容器是否运行：「容器」->「容器」列表查看状态
2. 检查端口映射是否正确
3. 检查防火墙是否放行映射的主机端口

容器内无法访问外网

检查 Docker 网络配置：

docker network ls
docker network inspect bridge

数据持久化

容器删除后数据会丢失。 使用卷挂载持久化数据：

在编排配置中添加 volumes：

volumes:
  - ./data:/app/data

查看容器日志

docker logs 容器名或ID
docker logs -f 容器名或ID  # 实时查看

或在面板「容器」->「容器」列表点击「日志」。