webdevops/go-replace

go-replace镜像

镜像概述

webdevops/go-replace镜像是包含go-replace工具的Docker镜像，该工具由Go语言编写，是一款轻量高效的命令行文本替换工具，专为Docker环境设计，支持多种替换模式和功能，可用于处理配置文件、批量修改文本内容等场景。

核心功能

• 支持简单文本搜索替换（仅需处理shell引号转义）
• 支持正则表达式搜索替换（含反向引用）
• 支持多组搜索替换规则
• 多种替换模式：
  • replace：替换匹配的文本片段
  • line：替换包含匹配项的整行
  • lineinfile：替换整行或在无匹配时追加到文件末尾
  • template：使用Go模板（结合Sprig函数）处理内容
• 支持将文件保存到不同名称（如source:destination）
• 支持目录内文件替换及文件模式匹配
• 支持从stdin读取输入进行处理
• 跨平台支持（Linux、MacOS、Windows及ARM/ARM64架构）

使用场景

• Docker容器内配置文件的动态生成（通过环境变量替换模板）
• 批量修改项目中的文本内容（如版本号、配置参数）
• 日志文件中的敏感信息脱敏
• 自动化脚本中的文本替换任务

配置说明

基本参数

常用命令行参数：

• -m, --mode：替换模式（replace/line/lineinfile/template，默认replace）
• -s, --search：搜索文本或正则表达式
• -r, --replace：替换文本
• --regex：启用正则表达式模式
• --path：指定处理的目录路径
• --path-pattern：目录内文件的通配符匹配（如*.txt）

Docker部署示例

单文件替换

bash
docker run --rm -v $(pwd):/app webdevops/go-replace -s "old_value" -r "new_value" /app/config.txt

模板模式替换（环境变量注入）

模板文件config.tmpl：

DB_HOST={{.Env.DB_HOST}}
DB_PORT={{.Env.DB_PORT}}

执行命令：

bash
docker run --rm -v $(pwd):/app -e DB_HOST=db.example.com -e DB_PORT=3306 webdevops/go-replace --mode=template /app/config.tmpl:/app/config.conf

目录批量替换

bash
docker run --rm -v $(pwd)/src:/app webdevops/go-replace -s "foo" -r "bar" --path=/app --path-pattern="*.md"