Ubuntu 24.04 安装 Protocol Buffers 3.13 之前版本的完整指南

2025/09/13技术杂谈7605172 字12 分钟

问题背景

在使用 Protocol Buffers 处理二进制数据时，许多开发者遇到了一个重要问题：Protocol Buffers 3.13 及以后的版本不会将二进制数据准确转换为十六进制字符串。这导致在处理包含二进制字段的 protobuf 消息时出现兼容性问题。为了解决这个问题，需要在系统上安装 Protocol Buffers 3.13 之前的版本。

本文将详细介绍在 Ubuntu 24.04 系统上安装旧版本 Protocol Buffers 的多种方法，帮助开发者根据自身需求选择最适合的方案。

安装方法详解

方法一：使用预编译的二进制文件（推荐）

这是最可靠的安装方法，可以避免复杂的依赖问题，特别适合 Ubuntu 24.04 系统。

安装 protoc 3.12.4（3.13 之前的最后一个稳定版本）

# 安装必要依赖
sudo apt update
sudo apt install -y wget unzip

# 下载 protoc 3.12.4 版本
wget https://github.com/protocolbuffers/protobuf/releases/download/v3.12.4/protoc-3.12.4-linux-x86_64.zip

# 创建安装目录
sudo mkdir -p /usr/local/protobuf/v3.12.4

# 解压到安装目录
sudo unzip protoc-3.12.4-linux-x86_64.zip -d /usr/local/protobuf/v3.12.4

# 创建符号链接，便于版本管理和使用
sudo ln -sf /usr/local/protobuf/v3.12.4/bin/protoc /usr/local/bin/protoc

# 设置包含文件路径
sudo cp -r /usr/local/protobuf/v3.12.4/include/* /usr/local/include/

# 验证安装是否成功
protoc --version
# 预期输出: libprotoc 3.12.4

# 清理临时文件
rm protoc-3.12.4-linux-x86_64.zip

安装其他 3.13 之前的版本

如需安装其他特定的旧版本，可以使用类似的方法：

# 安装 protoc 3.11.4
wget https://github.com/protocolbuffers/protobuf/releases/download/v3.11.4/protoc-3.11.4-linux-x86_64.zip
sudo mkdir -p /usr/local/protobuf/v3.11.4
sudo unzip protoc-3.11.4-linux-x86_64.zip -d /usr/local/protobuf/v3.11.4
sudo ln -sf /usr/local/protobuf/v3.11.4/bin/protoc /usr/local/bin/protoc

# 安装 protoc 3.10.1
wget https://github.com/protocolbuffers/protobuf/releases/download/v3.10.1/protoc-3.10.1-linux-x86_64.zip
sudo mkdir -p /usr/local/protobuf/v3.10.1
sudo unzip protoc-3.10.1-linux-x86_64.zip -d /usr/local/protobuf/v3.10.1
sudo ln -sf /usr/local/protobuf/v3.10.1/bin/protoc /usr/local/bin/protoc

# 安装 protoc 3.9.2
wget https://github.com/protocolbuffers/protobuf/releases/download/v3.9.2/protoc-3.9.2-linux-x86_64.zip
sudo mkdir -p /usr/local/protobuf/v3.9.2
sudo unzip protoc-3.9.2-linux-x86_64.zip -d /usr/local/protobuf/v3.9.2
sudo ln -sf /usr/local/protobuf/v3.9.2/bin/protoc /usr/local/bin/protoc

方法二：从源码编译安装

当预编译版本与系统存在兼容性问题时，可以选择从源码编译安装。

编译安装 protoc 3.12.4

# 安装编译依赖
sudo apt update
sudo apt install -y autoconf automake libtool curl make g++ unzip

# 下载源码
wget https://github.com/protocolbuffers/protobuf/releases/download/v3.12.4/protobuf-all-3.12.4.tar.gz

# 解压源码包
tar -xzf protobuf-all-3.12.4.tar.gz
cd protobuf-3.12.4

# 配置（使用兼容的 C++标准）
./configure CXXFLAGS="-std=c++11" --prefix=/usr/local/protobuf/v3.12.4

# 编译（使用多线程加速）
make -j$(nproc)

# 安装
sudo make install

# 创建符号链接
sudo ln -sf /usr/local/protobuf/v3.12.4/bin/protoc /usr/local/bin/protoc

# 验证安装
protoc --version

# 清理
cd ..
rm -rf protobuf-3.12.4 protobuf-all-3.12.4.tar.gz

编译安装 protoc 3.6.1（更旧版本）

# 安装依赖
sudo apt update
sudo apt install -y autoconf automake libtool curl make g++ unzip

# 下载旧版本源码
wget https://github.com/protocolbuffers/protobuf/releases/download/v3.6.1/protobuf-all-3.6.1.tar.gz

# 解压
tar -xzf protobuf-all-3.6.1.tar.gz
cd protobuf-3.6.1

# 配置和编译
./configure --prefix=/usr/local/protobuf/v3.6.1
make -j$(nproc)

# 安装
sudo make install

# 创建符号链接
sudo ln -sf /usr/local/protobuf/v3.6.1/bin/protoc /usr/local/bin/protoc

# 验证
protoc --version

# 清理
cd ..
rm -rf protobuf-3.6.1 protobuf-all-3.6.1.tar.gz

方法三：使用 Docker 容器

如果系统兼容性问题过多，可以考虑使用 Docker 容器来隔离运行环境。

# 拉取包含旧版本 protoc 的镜像
docker pull namely/protoc-all:3.12.4

# 创建别名方便使用
echo 'alias protoc-old='"'docker run -v $(pwd):/defs namely/protoc-all:3.12.4'"'' >> ~/.bashrc
source ~/.bashrc

# 使用示例
protoc-old -f your_file.proto --php_out=.  # 生成 PHP 代码

# 或者直接使用完整命令
docker run -v $(pwd):/defs namely/protoc-all:3.12.4 -f message.proto --php_out=.

方法四：使用第三方仓库

在某些情况下，可以尝试添加包含旧版本的第三方 PPA 或使用其他 Ubuntu 版本的仓库：

# 添加可能包含旧版本的 PPA（可能不适用于 Ubuntu 24.04）
sudo add-apt-repository ppa:ubuntu-toolchain-r/test
sudo apt update

# 尝试安装特定版本（如果仓库中可用）
sudo apt install protobuf-compiler=3.6.1.3-2ubuntu5

# 或者尝试从 Ubuntu 20.04 (Focal Fossa) 的仓库安装
echo "deb http://archive.ubuntu.com/ubuntu focal main universe" | sudo tee /etc/apt/sources.list.d/focal.list
sudo apt update
sudo apt install protobuf-compiler=3.6.1.3-2ubuntu5 -t focal

多版本管理脚本

为了更方便地管理和切换多个 Protocol Buffers 版本，可以创建一个简单的安装脚本：

#!/bin/bash
# 文件: install_old_protoc.sh

VERSION=$1

if [ -z "$VERSION" ]; then
    echo "用法: install_old_protoc.sh <version>"
    echo "可用的旧版本: 3.12.4, 3.11.4, 3.10.1, 3.9.2, 3.8.0, 3.7.1, 3.6.1"
    exit 1
fi

# 检查版本是否受支持
case $VERSION in
    3.12.4|3.11.4|3.10.1|3.9.2|3.8.0|3.7.1|3.6.1)
        echo "正在安装 protoc $VERSION..."
        ;;
    *)
        echo "不支持的版本: $VERSION"
        exit 1
        ;;
esac

# 尝试下载预编译版本
wget https://github.com/protocolbuffers/protobuf/releases/download/v${VERSION}/protoc-${VERSION}-linux-x86_64.zip

if [ $? -ne 0 ]; then
    echo "下载预编译版本失败，尝试从源码编译..."
    wget https://github.com/protocolbuffers/protobuf/releases/download/v${VERSION}/protobuf-all-${VERSION}.tar.gz
    tar -xzf protobuf-all-${VERSION}.tar.gz
    cd protobuf-${VERSION}
    ./configure --prefix=/usr/local/protobuf/v${VERSION}
    make -j$(nproc)
    sudo make install
    cd ..
    rm -rf protobuf-${VERSION} protobuf-all-${VERSION}.tar.gz
else
    # 安装预编译版本
    sudo mkdir -p /usr/local/protobuf/v${VERSION}
    sudo unzip protoc-${VERSION}-linux-x86_64.zip -d /usr/local/protobuf/v${VERSION}
    rm protoc-${VERSION}-linux-x86_64.zip
fi

# 创建符号链接
sudo ln -sf /usr/local/protobuf/v${VERSION}/bin/protoc /usr/local/bin/protoc

echo "protoc $VERSION 安装成功!"
protoc --version

使用方法：

chmod +x install_old_protoc.sh
./install_old_protoc.sh 3.12.4  # 安装 3.12.4 版本
./install_old_protoc.sh 3.6.1   # 切换到 3.6.1 版本

验证和测试安装

安装完成后，建议进行以下验证和测试：

# 检查版本
echo "当前安装的 protoc 版本: $(protoc --version)"

# 测试编译一个简单的 .proto 文件
cat > test.proto << 'EOF'
syntax = "proto3";

message TestMessage {
    string text = 1;
    int32 number = 2;
    bytes binary_data = 3;  // 包含二进制字段
}
EOF

# 编译测试文件
protoc --php_out=. test.proto  # 生成 PHP 代码
# 或者使用其他语言: protoc --python_out=. test.proto

# 检查生成的文件
ls -la GPBMetadata/ TestMessage.php

# 验证二进制数据处理功能（通过检查生成的代码）
# 此处应检查生成的代码中是否正确处理了 binary_data 字段

# 清理测试文件
rm -rf test.proto GPBMetadata/ TestMessage.php

注意事项

在 Ubuntu 24.04 系统上安装旧版本 Protocol Buffers 时，需要注意以下几点：

依赖兼容性：旧版本的 Protocol Buffers 可能与 Ubuntu 24.04 的较新库存在兼容性问题
C++ 标准：一些旧版本可能需要特定的 C++ 标准才能正常编译
多版本管理：建议使用符号链接方式管理多个版本，便于切换
隔离安装：最好将旧版本安装在 /usr/local 目录下，避免与系统包冲突
路径优先级：确保 /usr/local/bin 在系统 PATH 中的优先级高于可能包含新版本的路径

内容总结

本文详细介绍了在 Ubuntu 24.04 系统上安装 Protocol Buffers 3.13 之前版本的多种方法，主要解决了新版本无法正确处理二进制数据转换为十六进制字符串的问题。文章提供了四种安装途径：预编译二进制文件（推荐）、源码编译安装、Docker 容器和第三方仓库，同时提供了多版本管理脚本和验证测试方法。

对于大多数用户，推荐使用预编译二进制文件的方法，因为它简单可靠，能有效避免依赖问题。在需要频繁切换版本的场景下，可以使用文中提供的版本管理脚本提高工作效率。

通过本文提供的方法，开发者可以在保持系统稳定性的同时，解决 Protocol Buffers 在处理二进制数据方面的兼容性问题，确保项目的正常运行。

暂无评论