当前位置：首页 > news >正文

OpenHarmony 4.0.10.13 NDK下编译OpenSSH 9.6p1，我踩过的那些坑（附完整脚本）

news 2026/5/24 19:39:42

OpenHarmony 4.0.10.13 NDK下编译OpenSSH 9.6p1实战避坑指南

移植开源软件到新平台从来都不是简单的复制粘贴，尤其是当目标平台是OpenHarmony这样的新兴操作系统时。本文将详细记录在OpenHarmony 4.0.10.13上使用NDK编译OpenSSH 9.6p1的全过程，重点分享那些让我熬了几个通宵的"坑"以及如何一步步填平它们。

1. 环境准备与基础库编译

在开始OpenSSH的移植前，我们需要先准备好编译环境和依赖库。OpenSSH依赖于zlib和OpenSSL，这两个库的编译也需要针对OpenHarmony进行适配。

1.1 NDK环境配置

OpenHarmony的NDK与传统Android NDK有所不同，它基于Clang/LLVM工具链，并针对OHOS做了特殊适配。首先需要确保正确设置环境变量：

export OHOS_NATIVE_HOME=/opt/sdk/ohos/native/4.0.10.13 export PATH=$OHOS_NATIVE_HOME/llvm/bin:$PATH export CC="$OHOS_NATIVE_HOME/llvm/bin/clang" export AR="$OHOS_NATIVE_HOME/llvm/bin/llvm-ar" export LD="$OHOS_NATIVE_HOME/llvm/bin/ld.lld"

关键点：必须使用OHOS提供的lld链接器而非系统默认的ld，否则会遇到各种链接错误。

1.2 zlib编译

zlib相对简单，但需要注意静态编译：

./configure --prefix=${PWD}/_install --static make && make install

1.3 OpenSSL编译

OpenSSL 3.2.0的编译需要特别注意以下几点：

禁用单元测试（no-unit-test）
禁用动态库（no-shared）
移除对libatomic的依赖

./Configure linux-armv4 --prefix=${PWD}/_install zlib no-asm no-shared no-unit-test no-tests

关键修改：编辑生成的Makefile，删除所有"-latomic"引用：

sed -i 's/-latomic//g' ./Makefile

2. OpenSSH编译过程中的六大"坑"

2.1 动态库链接问题

现象：configure阶段报错找不到libcrypto库

解决方案：在LDFLAGS中明确指定静态库路径：

export LDFLAGS="... ${PWD}/../openssl-3.2.0/_install/lib/libcrypto.a -lz"

2.2 musl库函数缺失

现象：编译时报错getspnam、explicit_bzero等函数未定义

原因：OHOS NDK中的musl库裁剪过度，缺少部分函数实现

解决方案：从源码编译的musl库中提取完整实现：

cp ${OHOS_SRC}/out/${PRODUCT}/obj/third_party/musl/usr/include/arm-linux-ohos/shadow.h ${OHOS_NATIVE_HOME}/sysroot/usr/include/ cp ${OHOS_SRC}/out/${PRODUCT}/obj/third_party/musl/usr/lib/arm-linux-ohos/libc.so ${OHOS_NATIVE_HOME}/sysroot/usr/lib/arm-linux-ohos/

2.3 头文件冲突

现象：linux/socket.h和sys/socket.h中的sockaddr_storage定义冲突

解决方案：定义__MUSL__宏避免重复定义：

export CFLAGS="... -D__MUSL__"

2.4 DNS解析相关符号缺失

现象：链接阶段报错undefined symbol: __res_state

原因：OpenSSH使用了glibc特有的DNS解析函数

解决方案：修改OpenSSH源码，禁用DNS相关功能：

+#if !defined(__OHOS__) result = getrrsetbyname(hostname, DNS_RDATACLASS_IN, DNS_RDATATYPE_SSHFP, 0, &fingerprints); +#else + result = -1; +#endif

2.5 安装目录权限问题

现象：make install时无法创建/var/empty

解决方案：使用DESTDIR参数指定安装目录：

make install DESTDIR=${PWD}/_install

2.6 系统集成问题

将编译好的OpenSSH集成到OpenHarmony系统镜像中需要注意：

权限配置（DAC规则）
服务启动脚本
系统参数设置

关键配置：

// device/board/${VENDOR}/${PRODUCT}/files/openssh/etc/sshd.cfg { "jobs" : [{ "name" : "param:sys.sshd.enable=true", "condition" : "sys.sshd.enable=true", "cmds" : [ "mkdir -p /data/ssh/var/run", "start sshd" ] }] }

3. 功能调试与系统适配

编译通过只是第一步，要让OpenSSH在OpenHarmony上真正可用，还需要解决以下问题：

3.1 用户环境配置

OpenHarmony的/etc/passwd文件默认不包含用户home目录和有效shell，需要手动添加：

root:x:0:0:root:/data:/system/bin/sh

3.2 认证方式适配

由于OpenHarmony缺少/etc/shadow文件，建议：

优先使用密钥认证
如需密码认证，需修改PAM配置

3.3 文件权限管理

必须严格设置密钥文件权限：

chmod 600 /etc/ssh/ssh_host_rsa_key chmod 644 /etc/ssh/ssh_host_rsa_key.pub

4. 完整编译脚本

以下是经过验证可用的完整编译脚本：

#!/bin/bash set -e # 环境变量设置 export OHOS_NATIVE_HOME=/opt/sdk/ohos/native/4.0.10.13 export PATH=$OHOS_NATIVE_HOME/llvm/bin:$PATH export CC="$OHOS_NATIVE_HOME/llvm/bin/clang" export AR="$OHOS_NATIVE_HOME/llvm/bin/llvm-ar" export LD="$OHOS_NATIVE_HOME/llvm/bin/ld.lld" export CFLAGS="--target=arm-linux-ohos --sysroot=$OHOS_NATIVE_HOME/sysroot -D__MUSL__ -D__OHOS__" export LDFLAGS="--target=arm-linux-ohos --rtlib=compiler-rt -fuse-ld=lld" # 编译OpenSSH ./configure --prefix=/system \ --with-zlib=${PWD}/../zlib-1.3/_install \ --with-ssl-dir=${PWD}/../openssl-3.2.0/_install \ --disable-etc-default-login make -j$(nproc) CHANNELLIBS="" SSHDLIBS="" piddir="/data/ssh/var/run" make install-nokeys DESTDIR=${PWD}/_install