养成记录好习惯（4）——Terraform离线部署（linux-amd64）

Linux 系统离线安装配置 Terraform（对接 Proxmox/PVE）

前言

本文主要介绍在离线 Linux 环境下安装配置 Terraform，并部署 Proxmox Provider 插件，实现通过 Terraform 集中管理 PVE 虚拟化基础设施，解决离线环境下 Terraform 部署和插件适配的核心问题。

一、前置准备（联网设备操作）

1. 下载 Terraform 离线包

下载适配 Linux-amd64 架构的新版本 Terraform 二进制包：terraform离线包

2. 下载 Proxmox Provider 插件

下载与 Terraform 兼容的 bpg/proxmox 插件版本：bpg/proxmox离线包

示例：
terraform v1.14.5

bpg/proxmox v0.97.1

二、离线环境部署

1. 传输安装包至离线环境

将下载好的terraform二进制文件和terraform-provider-proxmox插件包，通过 SCP/U 盘等方式拷贝到离线 Linux 服务器。

2. 安装 Terraform 二进制文件

# 切换至root用户（避免权限问题） sudo su # 将terraform二进制文件移动到系统可执行目录 mv terraform /usr/local/bin/ # 赋予可执行权限 chmod +x /usr/local/bin/terraform # 验证安装（输出版本即成功） terraform -v # 若离线环境PATH未包含/usr/local/bin，执行以下配置（永久生效） echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bashrc source ~/.bashrc

3.开启terraform自动补全

echo "complete -C /usr/local/bin/terraform terraform" >> ~/.bashrc source ~/.bashrc

4. 创建 Provider 插件目录（严格匹配路径）

Terraform 插件目录需与source地址、版本、架构完全对应，否则会加载失败：

# 创建层级目录（版本和架构需与下载的插件一致） mkdir -p ~/.terraform.d/plugins/registry.terraform.io/bpg/proxmox/0.97.1/linux_amd64/

5. 放置 Proxmox Provider 插件

将下载的插件文件（如terraform-provider-proxmox_v0.97.1）移动到上述目录：

# 示例命令（替换为实际文件名） mv terraform-provider-proxmox_v0.97.1 ~/.terraform.d/plugins/registry.terraform.io/bpg/proxmox/0.97.1/linux_amd64/

6. 创建 Terraform 项目及配置文件

步骤 1：创建项目目录

# 自定义项目目录（示例路径） mkdir -p ~/terraform-project cd ~/terraform-project

步骤 2：编写 main.tf 配置文件

新建并编辑main.tf，配置 Terraform 版本、Provider 信息及 PVE 连接参数：

terraform { required_version = ">= 1.8" required_providers { proxmox = { source = "bpg/proxmox" version = "0.97.1" } } } # Proxmox Provider配置 provider "proxmox" { endpoint = "https://你的PVE地址:8006" insecure = true # PVE默认自签名证书，需开启该参数 # 方式1：API Token认证（推荐） api_token = "你的API_TOKEN" # 方式2：用户名密码认证（备用） # username = "root@pam" # password = "你的PVE登录密码" }

7. 初始化 Terraform 项目

回到项目目录执行初始化，验证插件加载：

# 初始化项目 terraform init # 验证结果：出现"Successfully initialized Terraform!"即初始化成功 # 可选：查看已加载的Provider信息 terraform providers