Linux下静态链接部署C++单文件应用的CMake配置问题

1. 静态链接OpenSSL后是否无需远程机安装对应依赖 #

只要CMake找到的是OpenSSL静态库（后缀为.a，而非.so动态库），且链接阶段没有引入OpenSSL的动态组件，部署时确实不需要在远程机器额外安装OpenSSL运行时库。
验证方式很简单：构建完成后在输出目录执行ldd ./main，如果输出结果中没有libssl.so、libcrypto.so相关条目，就说明OpenSSL的代码已经完全编入最终二进制。需要注意OpenSSL静态链接通常会依赖libz、libdl、pthread这类Linux系统基础库，这些库在绝大多数常规Linux发行版中默认预装，不需要额外部署。

2. 是否可以合并所有依赖为单个部署文件 #

完全可以。你当前构建输出两个产物只是因为配置中同时定义了静态库目标和可执行文件目标，本身静态库在链接到可执行文件时，就会把对应代码全部编入最终的可执行文件。如果你不需要对外分发helloworld静态库给其他项目使用，完全可以调整配置，最终只输出单个可执行文件，拷贝这一个文件到远程机器即可直接运行。

你现有脚本可以按以下逻辑修改，默认输出无额外依赖的单文件可执行：

cmake_minimum_required(VERSION 3.20)
set(CMAKE_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/CMake;${CMAKE_MODULE_PATH}")

project(helloworld C CXX)

set (CMAKE_CXX_STANDARD 20)
set (CMAKE_BUILD_TYPE Release)

set (BUILD_MAIN TRUE)
set (BUILD_SHARED_LIBS FALSE)
set (OPENSSL_USE_STATIC_LIBS TRUE)
set(CMAKE_POSITION_INDEPENDENT_CODE ON)

# 新增控制选项，默认不生成独立静态库、不安装静态库
option(BUILD_STATIC_LIB "Build standalone helloworld static library" OFF)
option(HELLOWORLD_INSTALL "Install HelloWorld library" OFF)

set( HELLOWORLD_HEADERS    helloworld/File1.h       helloworld/File2.h    )
set( HELLOWORLD_SOURCES    helloworld/File1.cpp     helloworld/File2.cpp  )

# Rapidjson 路径建议不要写死/tmp目录，这里保留原逻辑
set(RAPIDJSON_INCLUDE_DIR /tmp/rapidjson/include/)

# OpenSSL 查找逻辑
find_package(OpenSSL REQUIRED)

# 仅在需要独立静态库时生成helloworld静态库目标
if(BUILD_STATIC_LIB)
  add_library( helloworld  ${HELLOWORLD_SOURCES}    ${HELLOWORLD_HEADERS}   )
  target_include_directories(helloworld PUBLIC 
    $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}>
    $<BUILD_INTERFACE:${OPENSSL_INCLUDE_DIR}>
    $<BUILD_INTERFACE:${RAPIDJSON_INCLUDE_DIR}>
    $<INSTALL_INTERFACE:${CMAKE_INSTALL_INCLUDEDIR}/helloworld>
  )
  target_link_libraries(helloworld PRIVATE ${OPENSSL_LIBRARIES})
  set_target_properties(helloworld PROPERTIES PUBLIC_HEADER "${HELLOWORLD_HEADERS}")
  add_library(helloworld::helloworld ALIAS helloworld)

  # 原有的安装逻辑全部放在静态库开启的判断块内
  if (HELLOWORLD_INSTALL)
    include(GNUInstallDirs)
    install(TARGETS helloworld
            EXPORT helloworld
            ARCHIVE DESTINATION ${CMAKE_INSTALL_LIBDIR}
            PUBLIC_HEADER DESTINATION ${CMAKE_INSTALL_INCLUDEDIR}/helloworld/
    )
    configure_file("${CMAKE_CURRENT_LIST_DIR}/helloworld-config.cmake.in" "${CMAKE_BINARY_DIR}/helloworld-config.cmake" @ONLY)
    install(FILES "${CMAKE_BINARY_DIR}/helloworld-config.cmake" DESTINATION ${CMAKE_INSTALL_LIBDIR}/cmake/helloworld)
    install(EXPORT helloworld
            FILE helloworld-targets.cmake
            NAMESPACE helloworld::
            DESTINATION ${CMAKE_INSTALL_LIBDIR}/cmake/helloworld
    )
  endif()
endif()

# 构建主程序
if (BUILD_MAIN) 
  if(BUILD_STATIC_LIB)
    add_executable(main main.cpp)
    target_link_libraries(main PRIVATE helloworld pthread dl z)
  else()
    # 不生成独立静态库时，直接把所有源码编入main
    add_executable(main main.cpp ${HELLOWORLD_SOURCES})
    target_include_directories(main PRIVATE
      ${CMAKE_CURRENT_SOURCE_DIR}
      ${RAPIDJSON_INCLUDE_DIR}
      ${OPENSSL_INCLUDE_DIR}
    )
    # 链接OpenSSL和必要的系统依赖
    target_link_libraries(main PRIVATE ${OPENSSL_LIBRARIES} pthread dl z)
  endif()

  # Release体积优化：开O2优化、剔除未使用代码段、剥离符号表
  target_compile_options(main PRIVATE -O2 -ffunction-sections -fdata-sections)
  target_link_options(main PRIVATE -Wl,--gc-sections -s)
endif()

• 构建完成后务必执行ldd ./main验证依赖，确认没有非系统基础库的动态依赖。如果输出显示not a dynamic executable说明是完全静态链接，兼容性最好；如果仅依赖libc、libpthread等系统库也可以正常部署。
• 注意构建机的glibc版本不要高于远程目标机的glibc版本，否则会出现版本不兼容无法运行的问题。如果需要兼容多类发行版，建议用低版本LTS系统（比如Ubuntu 20.04、CentOS 7）作为构建环境。
• 如果需要进一步缩小二进制体积，可以用upx工具对最终生成的main文件进行压缩，通常可以减少50%以上的文件体积，不影响程序正常运行。
• 现有脚本中Rapidjson的头文件路径写死为/tmp目录，换构建环境很容易出现路径不存在的错误，建议将Rapidjson源码放入项目第三方目录，或者通过包管理器查找依赖，不要写死临时目录路径。

内容的提问来源于stack exchange，提问作者intrigued_66