permissions-lib-dir Docker镜像文档

镜像概述和主要用途

permissions-lib-dir是一个用于修改lib目录权限的Docker工具镜像，旨在帮助解决容器环境中lib目录权限不足或错误导致的应用运行问题。通过该镜像，用户可便捷地指定目标lib目录路径并设置所需权限模式，快速调整文件/目录权限，确保应用正常访问依赖的lib资源。

核心功能和特性

• 指定目录路径：支持自定义目标lib目录路径，灵活适配不同容器内的lib目录结构
• 权限模式设置：可直接指定目标权限模式（如755、644、777等标准Unix权限模式）
• 递归权限修改：默认支持递归修改目标目录下所有子目录及文件的权限
• 轻量级设计：基于极简基础镜像构建，镜像体积小，启动速度快，资源占用低
• 无依赖运行：无需额外安装工具，镜像内置权限修改所需命令，开箱即用

使用场景和适用范围

• 容器内应用因lib目录权限不足（如无法读取动态链接库）导致启动失败时
• 多容器环境中需要统一标准化lib目录权限配置时
• 构建或部署流程中需临时调整lib目录权限以满足应用运行要求时
• 调试容器内权限相关问题，需快速测试不同权限配置效果时

使用方法和配置说明

获取镜像

bash
docker pull permissions-lib-dir:latest

基本使用示例

1. 修改容器内默认/lib目录权限为755

bash
docker run --rm permissions-lib-dir --dir /lib --mode 755

2. 挂载主机目录并修改指定lib目录权限

将主机的/host/app/lib目录挂载到容器内/app/lib，并修改权限为644（非递归）：

bash
docker run --rm -v /host/app/lib:/app/lib permissions-lib-dir --dir /app/lib --mode 644 --recursive false

3. 使用环境变量配置权限修改参数

bash
docker run --rm \
  -e DIR_PATH=/usr/local/lib \
  -e PERMISSION_MODE=777 \
  -e RECURSIVE=true \
  permissions-lib-dir

配置参数说明

注意事项

• 确保容器内进程对目标lib目录具有写权限，否则权限修改会失败
• 权限模式设置需符合应用运行要求，避免过度开放权限（如777）带来安全风险
• 挂载主机目录时，需确保主机目录路径正确且容器内路径与挂载配置一致
• 递归修改大量文件/目录时可能耗时较长，建议根据实际需求选择是否递归