Apollo在Linux下能跑起来的核心是：数据库先配好、JVM和环境变量别漏、服务必须按configservice→adminservice→portal顺序启动；90%失败源于MySQL认证插件不兼容、JAVA_HOME未生效或configservice注册错误网卡IP。

直接上结论：Apollo 在 Linux 下能跑起来，核心就三件事——数据库先配好、JVM 和环境变量别漏、服务必须按顺序启动。90% 的失败不是 Apollo 本身有问题，而是卡在 MySQL 认证插件、$JAVA_HOME 没生效、或 configservice 注册了错误网卡 IP。

MySQL 8.0+ 连不上？先改认证插件再导入 SQL

报错 Client does not support authentication protocol 不是密码错了，是驱动不认 MySQL 8.0 默认的 caching_sha2_password 插件。

• 用 root 登录 MySQL 后立刻执行：ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_password';
• 必须先执行这条，再导入 apolloconfigdb.sql 和 apolloportaldb.sql
• 两个库不能混：ApolloConfigDB 给 configservice 和 adminservice 共用；ApolloPortalDB 单独给 portal，少一个 portal 就打不开
• 密码里不能有空格，否则 spring.datasource.password 解析失败，日志只显示 Connection refused，实际是连接池根本没建起来

Java 环境和 JVM 参数必须显式控制

java -version 显示正常 ≠ Apollo 能用。启动脚本依赖 $JAVA_HOME，而它经常没配或配错路径。

Zynq Linux Hardware Debug

Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。

下载

• 运行 echo $JAVA_HOME，确认输出是类似 /usr/lib/jvm/java-11-openjdk-amd64 的真实路径，且该路径下存在 /bin/java
• 在 /etc/profile 末尾加：export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64，然后 source /etc/profile
• 对低配机器（如 2核4G），务必在各服务的 startup.sh 里调 JVM 参数：-Xms256m -Xmx256m -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=256m
• Portal 内存吃得多，建议单独给 -Xms512m -Xmx512m，否则容易 OOM 导致白屏

application-github.properties 配置必须严格匹配环境

这个文件在 apollo-configservice/conf/ 和 apollo-adminservice/conf/ 各一份，内容相似但作用不同。最容易栽在三个地方：

• spring.datasource.url 必须指向你刚建好的 ApolloConfigDB，端口、库名、参数（如 useSSL=false&characterEncoding=utf8）一个都不能少
• eureka.service.url 必须写成完整地址，例如 http://192.168.1.100:8080/eureka/，不能只写 IP 或省略协议
• apollo.profile 必须显式设为 github，否则 Spring Boot 读不到这个配置文件，直接 fallback 到空配置，服务起得来但连不上 Eureka

服务必须按 configservice → adminservice → portal 顺序启动

Portal 启动时会调 adminservice 的 API 获取应用列表，adminservice 又依赖 configservice 提供的元数据服务。顺序错或中间断掉，后续全挂。

• 启动前检查网卡：如果机器有 docker0 或 veth*，configservice 默认注册 docker 网段 IP，客户端连不上。在 startup.sh 的 JVM 参数里加：-Dspring.cloud.inetutils.ignoredInterfaces=docker0,veth.*
• 验证 configservice 是否注册成功：curl http://127.0.0.1:8080/eureka/apps 应返回 XML 或 JSON，含 configservice 实例信息；返回空或 404 就说明注册失败
• 三个服务的端口默认是 8080（config）、8090（admin）、8070（portal），若被占用，必须统一改 startup.sh 里的 SERVER_PORT 和配置文件中的 server.port

真正麻烦的从来不是“怎么装”，而是“为什么明明照着步骤做了却起不来”。每一步背后都有隐性依赖：MySQL 插件类型、JVM 参数生效范围、Eureka 注册时的网卡选择、甚至密码里一个空格——这些细节不会报错提示，只会让服务静默失败。部署时盯着日志里第一行异常，而不是最后那句 “started successfully”。