必须先确认系统架构与Java版本:uname -m判断aarch64或x86_64,java -version确保JDK≥17(推荐21),再下载对应架构的SkyWalking二进制包,配置Elasticsearch连接(需HTTPS及CA证书),修改Web端口后启动,日志显示“Started OAPServerBootstrap”即成功。

在统信UOS系统上部署SkyWalking监控平台,需绕过x86_64与ARM64架构适配陷阱、规避UOS默认Java版本不兼容问题,并正确加载国产化环境下的Elasticsearch插件依赖。
确认系统架构与Java环境
打开终端,执行 uname -m 查看CPU架构:若返回 aarch64,说明是鲲鹏或飞腾ARM64平台;若返回 x86_64,则为Intel/AMD平台。这一步必须做,【SkyWalking官方二进制包仅提供x86_64和aarch64两种架构的OAP服务,混用会导致startup.sh静默失败】。
运行 java -version 检查JDK版本:UOS默认预装OpenJDK 11或17,但SkyWalking 9.7.0+要求JDK 17或更高(JDK 21更稳妥)。若版本低于17,需手动安装适配UOS的OpenJDK 21:从统信应用商店搜索“OpenJDK 21”安装,或从Adoptium官网下载对应架构的tar.gz包,解压后通过 sudo update-alternatives --install /usr/bin/java java /path/to/jdk-21/bin/java 1 切换默认Java。
下载并解压适配UOS的SkyWalking包
访问SkyWalking官网下载页,选择最新稳定版(如10.3.0),【务必点击“Distribution”下的“Binary Distribution”链接,不要选Source Code】。
根据上一步确认的架构,下载对应包:
• x86_64平台:下载 apache-skywalking-apm-10.3.0-bin.tar.gz
• aarch64平台:下载 apache-skywalking-apm-10.3.0-aarch64-bin.tar.gz
将压缩包保存至 /opt 目录,执行:sudo tar -zxvf apache-skywalking-apm-10.3.0*-bin.tar.gz -C /opt/
解压后目录为 /opt/apache-skywalking-apm-bin。
配置OAP连接Elasticsearch(推荐国产化替代方案)
进入配置目录:cd /opt/apache-skywalking-apm-bin/config。
编辑 application.yml 文件:sudo vim application.yml。
定位到 storage: 区块,按以下方式修改(以Elasticsearch 8.12为例):
① 将 selector: ${SW_STORAGE:h2} 改为 selector: ${SW_STORAGE:elasticsearch};
② 在 elasticsearch: 下取消注释并填写:
nameSpace: ${SW_NAMESPACE:"sw_data"}
clusterNodes: ${SW_STORAGE_ES_CLUSTER_NODES:127.0.0.1:9200}
user: ${SW_STORAGE_ES_USER:"elastic"}
password: ${SW_STORAGE_ES_PASSWORD:"your_strong_password"}
protocol: ${SW_STORAGE_ES_PROTOCOL:"https"}
trustStorePath: ${SW_STORAGE_ES_TRUST_STORE_PATH:"/etc/elasticsearch/certs/http_ca.crt"}
trustStorePass: ${SW_STORAGE_ES_TRUST_STORE_PASS:""}
注意:UOS下若使用自建Elasticsearch,必须启用HTTPS并提供CA证书路径;若用国产替代如OpenSearch或Tencent Cloud ES,请确保其兼容Elasticsearch 7.x REST API协议,否则OAP启动时会报 Invalid Elasticsearch version 错误。
调整Web UI端口并启动服务
编辑 /opt/apache-skywalking-apm-bin/webapp/webapp.yml,将 server.port 改为未被占用的端口,例如 9010。
赋予启动脚本执行权限:sudo chmod +x /opt/apache-skywalking-apm-bin/bin/startup.sh。
执行启动:sudo /opt/apache-skywalking-apm-bin/bin/startup.sh。
几秒后检查进程:ps aux | grep skywalking,应看到 oap-server 和 webapp 两个Java进程;再查看日志:tail -f /opt/apache-skywalking-apm-bin/logs/oap-server.log,出现 Started OAPServerBootstrap in X.XXX seconds 即表示OAP启动成功。
打开浏览器访问 http://localhost:9010,页面加载完成即部署完毕。

















