Vault Enterprise FIPS Docker镜像文档

1. 镜像概述和主要用途

1.1 基本信息

本镜像为HashiCorp官方提供的Vault Enterprise FIPS Docker镜像，用于容器化部署Vault企业版（符合FIPS标准）。

1.2 使用许可

本HashiCorp企业软件仅允许已与HashiCorp或其授权经销商签订有效许可协议的客户使用。未获得有效许可的用户不得下载或使用本软件。所有使用行为均受许可协议条款约束，其他所有权利均明确保留。

软件许可条款（如Mozilla Public License 2.0、Business Source License等）、IBM国际程序许可协议（适用于评估用途的IBM国际评估程序许可协议、适用于Alpha/Beta版本的IBM国际早期发布程序许可协议）及相关许可信息（可通过IBM条款页面获取）构成本软件使用的约束条件。若下载包中的许可文件与上述IBM许可存在冲突，以IBM相关条款为准。安装或使用本软件即表示您接受这些条款；如不接受，请勿使用。

2. 核心功能和特性

2.1 Vault核心功能

Vault是一款用于安全访问机密的工具，机密包括API密钥、密码、证书等需严格控制访问的敏感信息。其核心功能包括：

• 统一接口管理各类机密
• 严格的访问控制机制
• 详细的审计日志记录

2.2 容器特性

• 轻量级基础镜像：基于Alpine Linux，安全表面积小，同时满足开发和交互式调试需求。
• 进程管理：通过dumb-init处理僵尸进程并转发信号，dumb-init二进制由HashiCorp构建并使用其GPG密钥签名，可验证完整性。
• 持久化卷：提供两个可选卷：
  • /vault/logs：用于存储持久化审计日志（需启用file审计后端并指定此目录下的路径）。
  • /vault/file：用于file数据存储插件的持久化数据（需在Vault配置中启用file存储后端）。
• 灵活配置：支持通过两种方式加载配置：
  • 配置目录：/vault/config目录下的HCL或JSON文件会被自动加载（可通过挂载卷或构建新镜像添加配置文件）。
  • 环境变量：通过VAULT_LOCAL_CONFIG环境变量传入JSON格式配置。

3. 使用场景和适用范围

3.1 开发环境

适用于快速搭建Vault开发环境，使用开发模式（内存存储、自动 unseal）进行功能测试和集成验证。注意：开发模式仅用于开发，禁止用于生产环境。

3.2 生产环境

需配合持久化存储（如分布式存储后端）、TLS加密、身份验证配置及编排工具（如Kubernetes、OpenShift）实现高可用部署。生产环境中禁止使用开发模式及file存储后端（单机存储，可靠性低）。

4. 使用方法和配置说明

4.1 基础运行说明

• 无参数运行时，容器默认以开发模式启动Vault服务器。
• 支持直接执行Vault子命令，例如docker run hashicorp/vault status等效于在容器内执行vault status。
• 执行server子命令时，入口脚本会添加特殊配置；其他命令则通过dumb-init执行。

4.2 内存锁定与setcap配置

Vault需锁定内存以防止敏感数据交换到磁盘，因此启动容器时必须添加--cap-add=IPC_LOCK参数。由于Vault二进制以非root用户运行，容器通过setcap赋予二进制内存锁定权限。部分Docker存储插件（如AUFS）可能导致setcap失败，此时可通过设置SKIP_SETCAP环境变量（非空值）禁用内存锁定。

4.3 开发模式部署

基本命令

$ docker run --cap-add=IPC_LOCK -d --name=dev-vault hashicorp/vault

• 启动完全基于内存的Vault服务器，适合开发，禁止生产使用。

开发模式环境变量

• VAULT_DEV_ROOT_TOKEN_ID：设置初始root令牌ID。
• VAULT_DEV_LISTEN_ADDRESS：设置开发服务器监听地址（默认0.0.0.0:8200）。

示例（自定义root令牌和监听地址）

$ docker run --cap-add=IPC_LOCK -e 'VAULT_DEV_ROOT_TOKEN_ID=myroot' -e 'VAULT_DEV_LISTEN_ADDRESS=0.0.0.0:1234' hashicorp/vault

4.4 服务器模式部署（开发环境示例）

以下命令启动带file存储后端、禁用TLS的Vault服务器（生产环境需启用TLS并使用分布式存储）：

$ docker run --cap-add=IPC_LOCK \
  -e 'VAULT_LOCAL_CONFIG={"storage": {"file": {"path": "/vault/file"}}, "listener": [{"tcp": {"address": "0.0.0.0:8200", "tls_disable": true}}], "default_lease_ttl": "168h", "max_lease_ttl": "720h", "ui": true}' \
  -p 8200:8200 \
  hashicorp/vault server

• 配置说明：file存储后端路径/vault/file，默认租约168小时（7天），最大租约720小时（30天），启用UI。
• 注意：--cap-add=IPC_LOCK为内存锁定必需参数；生产环境若禁用内存锁定，需在配置中添加"disable_mlock": true。

4.5 配置方式详解

配置目录挂载

通过挂载卷将配置文件添加到/vault/config目录，Vault会自动加载该目录下的HCL/JSON文件：

$ docker run --volume /本地配置目录:/vault/config ...

环境变量配置

通过VAULT_LOCAL_CONFIG传入JSON配置，该配置会被写入/vault/config/local.json并加载：

$ docker run -e 'VAULT_LOCAL_CONFIG={"listener": [{"tcp": {"address": "0.0.0.0:8200", "tls_disable": true}}]}' ...

4.6 网络接口配置

支持通过环境变量设置重定向和集群地址使用的容器内网络接口：

• VAULT_REDIRECT_INTERFACE：指定用于重定向地址的接口（如eth0），Vault会使用该接口的IP地址。
• VAULT_CLUSTER_INTERFACE：指定用于集群地址的接口（如eth0），Vault会使用该接口的IP地址。

5. 环境变量与配置参数

5.1 核心环境变量

5.2 关键配置参数（服务器模式）