安装阶段最常踩的坑与解法
装完打不开：按顺序查三层
现象是浏览器访问不了面板，排查从外到内：
- 地址对不对：端口与安全入口要和安装完成时终端打印的一致，忘了就 SSH 上去执行
1pctl user-info，见命令行工具； - 云安全组放行了吗：云服务器要在厂商控制台放行面板端口——这是系统防火墙之外独立的一道门；
- 服务起来了吗：
1pctl status看状态，异常就1pctl restart。
Docker 安装失败怎么办
安装脚本自动装 Docker 失败时，官方文档给的替代路径是用独立脚本先装好 Docker，再回来装面板。非交互模式还有个易错点：Docker 安装默认关闭，自动化场景要显式设置安装开关为 y，参数全表见非交互安装。
已有 Docker 的机器还要留意 daemon.json：面板配置镜像加速时若已有该文件，注意替换开关的取舍，见Docker 清理。
内存够不够的判断
官方要求可用内存 1GB 以上（建议值），见环境要求。安装或后续拉镜像时被 OOM 杀掉，是低内存机器的典型症状——加交换分区或升级配置后再装。
入口、密码、验证器的自救
三件套都在 reset 命令里：
- 入口忘了：
1pctl user-info； - 密码忘了：
1pctl update password； - 两步验证设备丢了：
1pctl reset mfa。
详见命令行工具，救完记得把安全配置恢复回去。
离线与国产系统场景
纯内网机房用在线脚本走不通，官方提供离线安装包（企业版能力），路径见环境要求。国产操作系统（麒麟、统信）属于官方支持的 Debian/RedHat 系范畴，安装流程一致。
版本升级相关
日常升级走面板右下角，V1 到 V2 的迁移要按官方指引走，见升级迁移。