docker必须≥20.10、docker compose必须≥2.0.0、openssl必须可用，三者缺一即导致harbor启动失败；hostname、https证书cn、访问url须完全一致，证书路径与权限（私钥600）必须正确，否则portal崩溃或502错误。
docker 必须 ≥ 20.10，docker compose 必须 ≥ 2.0.0，openssl 必须可用——这三个条件不满足，./install.sh 即使跑完也大概率启动失败，别跳过验证。
确认三个核心依赖是否就位
很多人卡在“安装成功但打不开网页”，实际是依赖没对齐。不是版本略低一点能凑合，而是 Harbor v2.9+ 明确拒绝旧版 docker-compose（v1.x）和低于 20.10 的 docker。
-
docker --version输出必须是Docker version 20.10.x或更高；若为18.09，运行docker info可能报failed to create endpoint -
docker compose version（注意：无连字符）必须输出类似Docker Compose version v2.27.1；若提示command not found，说明系统装的是 Python 版docker-compose（v1），需手动下载二进制并放到/usr/local/bin/ -
which openssl必须返回路径；CentOS/RHEL 最小化安装常漏掉openssl包，yum install -y openssl补上即可
离线安装包解压后必须改的三项配置
直接运行 ./install.sh 前，harbor.yml 里这三处不改，后续必然 docker login 失败或页面 502。
Zynq Linux Hardware Debug
下载
Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。
-
hostname：不能写localhost或127.0.0.1，必须填客户端能解析的地址，比如192.168.88.240或harbor.example.com；浏览器访问 URL、docker login地址、证书CN字段三者必须一致 -
https块：生产环境必须启用；测试环境若想用 HTTP，得整段注释掉https:及其下所有行，并确保顶部有https.enabled: false，同时把http.port改成非 80 端口（如8080），否则宿主机 80 被占但 Harbor 不监听 -
data_volume：默认/data，若系统盘小，建议改成独立路径如/opt/harbor-data，且执行chown 10000:10000 /opt/harbor-data（Harbor 容器以 UID 10000 运行，权限不对会导致harbor-db启动失败）
自签名证书生成与挂载路径要严格匹配
Harbor 启动时会读取 certificate 和 private_key 指定路径下的文件，路径错一个字符、权限不对、或证书 CN 与 hostname 不一致，都会导致 harbor-portal 无法响应或浏览器报 NET::ERR_CERT_COMMON_NAME_INVALID。
- 证书生成命令中
-subj "/CN=xxx"的xxx必须和harbor.yml中hostname完全相同；若用 IP 访问，还得加-addext "subjectAltName = IP:192.168.88.240" - 证书文件路径必须是容器内可读的绝对路径，例如
/usr/local/harbor/tls/cert.crt；如果放在/root/tls/，Harbor 容器默认无权访问，得用volume映射或提前移到harbor/目录下 - 私钥文件权限必须是
600（chmod 600 tls/cert.key），否则nginx容器启动时拒绝加载，日志里会出现SSL_CTX_use_PrivateKey_file failed
启动失败时优先查这三个日志位置
别一看到 docker ps -a 里有 Exited (1) 就重装，先定位真实错误点。
- 查
harbor-core日志：docker logs harbor-core（不是-f，它已退出）；高频报错是failed to connect to database: dial tcp 127.0.0.1:5432，说明harbor-db没起来 - 查
harbor-db状态：docker inspect harbor-db | grep -A 5 "Status"；若"ExitCode": 1，再看磁盘空间（df -h /data）和目录权限（ls -ld /data/database必须属主10000） - 查
harbor-portal是否监听端口：ss -tlnp | grep ':80\|:443'；若没输出，检查防火墙：firewall-cmd --list-ports（CentOS/RHEL）或ufw status（Ubuntu），确保对应端口已放行
