Roxi先确认访问的是哪个服务
本文适用于已有的 Linux Docker Standalone 部署，操作人需要有管理该主机的权限。Agent 容器不是管理网页；Swarm、Kubernetes 或反向代理部署还需核对各自配置。先记录服务器地址、部署方式、浏览器完整地址和错误，不直接重新安装。
| 检查项 | 官方默认与实际配置的关系 |
|---|---|
| 9443 | Portainer Server 默认 HTTPS 管理端口；宿主机映射端口可不同 |
| 8000 | 用于 Edge 通信，不是浏览器管理入口 |
| 9000 | 旧版 HTTP 入口须显式发布，不能假定总是开启 |
| localhost / 127.0.0.1 | 指当前访问设备；手机上的 localhost 不是服务器 |
在实际服务器上读取容器和端口
下面都是读取现有状态的命令。先找出 Portainer Server 的真实容器名，再替换后两行的 PORTAINER_CONTAINER；不要原样执行占位名称。docker ps 不带 -a 会遗漏已停止的容器。
docker ps -a
docker port PORTAINER_CONTAINER
docker logs --tail 100 PORTAINER_CONTAINER- 确认看到的是 Server 容器，记下运行或停止状态。没有找到时，回到原部署记录确认主机和 Docker 上下文。
- 读取 docker port 的真实映射。例如 9443/tcp 映射到宿主机 10443，浏览器应访问该主机的 https://地址:10443。
- 映射到 127.0.0.1 时，通常只允许服务器本机连接；远程设备不能把这个地址当成服务器公网入口。已有反向代理时继续核对代理转发目标。
按错误分层，不先开放所有端口
- 连接被拒绝或超时时，对照容器状态、映射地址、网络路由和已有访问规则。由管理员核对需要的路径，不全局关闭防火墙。
- 看到证书警告，先确认域名或 IP、端口和证书确实属于自己的服务器。默认自签名证书可能引发警告，但不能据此忽略任何站点的证书错误。
- 已出现登录页时转向账号问题；若容器停止或日志持续报错，保存相关错误交部署维护者处理。不要删除数据卷、重建管理员或重新部署来试错。
新实例要求设置令牌时
Portainer 官方说明，2.43 及 2.39.4 起的新实例在首次创建管理员或恢复备份前需要 setup token，已有实例不受此变更影响。令牌来自 Server 容器日志，由该服务器管理员按官方流程取得；最近 100 行没看到，不代表实例没有令牌。日志可能包含 setup_token 等敏感信息，分享前必须遮盖，不能把它贴到公开求助帖。
用实际环境页面确认恢复
- 从日常管理设备打开正确的 HTTPS 地址，确认服务器身份后再登录。
- 进入预期的环境，检查已有容器列表是否能加载；仅看见登录页不能证明后端环境连接正常。
- 恢复临时网络设置后再次查看同一环境。仍失败时提供部署类型、容器状态、脱敏端口映射、错误和时间，保留数据卷及原配置。