Podman部署MySQL容器时Volume挂载权限异常问题求助

环境信息 #

• Podman版本：podman version 4.7.2
• 操作系统：macOS Monterey
• podman-compose版本：1.0.6

问题回顾 #

使用指定的Compose配置启动MySQL 8.0.35容器时，无论是否添加user: mysql配置、是否将本地目录权限改为777，均出现权限相关报错：

• 加user: mysql时，InnoDB因目录权限不足启动失败，全局可写的配置文件被忽略
• 去掉user: mysql时，容器执行chown操作无权限

原因分析 #

macOS上的Podman基于QEMU虚拟机运行，本地目录通过virtfs共享到虚拟机后再挂载到容器。容器内mysql用户的UID为999，与macOS本地用户UID不匹配；同时虚拟机无法直接修改macOS本地目录的所有权，导致常规权限调整无效。

解决方案 #

方案一：使用Podman命名卷（推荐） #

命名卷由Podman管理，会自动配置正确的权限，避免本地目录挂载的权限映射问题。

修改Compose配置如下：

version: '3.5'
services:
  mysql:
    image: mysql:8.0.35
    container_name: mysql8
    restart: unless-stopped
    environment:
      MYSQL_ROOT_PASSWORD: 12345678
    ports:
      - 13306:3306
    user: mysql
    volumes:
      - mysql_data:/var/lib/mysql
      - mysql_config:/etc/mysql/conf.d
      - mysql_logs:/var/log/mysql
      - mysql_init:/docker-entrypoint-initdb.d

networks:
  default:
    name: mysql-net
    driver: bridge

# 定义命名卷
volumes:
  mysql_data:
  mysql_config:
  mysql_logs:
  mysql_init:

如果需要将本地的初始化脚本/配置文件导入卷，可使用podman cp命令：

# 复制初始化脚本到容器的初始化目录
podman cp ./mysql_volumes/init/ mysql8:/docker-entrypoint-initdb.d/
# 复制配置文件到容器的配置目录
podman cp ./mysql_volumes/config/ mysql8:/etc/mysql/conf.d/

方案二：调整Podman虚拟机内的目录权限 #

进入Podman虚拟机，将共享目录的所有权改为容器内mysql用户对应的UID（999）：

1. 进入Podman虚拟机：

podman machine ssh

2. 切换到共享的本地目录（替换为你的实际用户目录）：

cd /Users/你的用户名/项目路径/mysql_volumes

3. 修改目录所有权：

sudo chown -R 999:999 data config logs init

4. 退出虚拟机并重启容器：

exit
podman compose down && podman compose up -d

方案三：通过Entrypoint预调整权限（应急方案） #

去掉user: mysql配置，添加自定义entrypoint，以root身份先修改目录权限，再切换到mysql用户启动服务：

version: '3.5'
services:
  mysql:
    image: mysql:8.0.35
    container_name: mysql8
    restart: unless-stopped
    environment:
      MYSQL_ROOT_PASSWORD: 12345678
    ports:
      - 13306:3306
    volumes:
      - ./mysql_volumes/data:/var/lib/mysql
      - ./mysql_volumes/config:/etc/mysql/conf.d
      - ./mysql_volumes/logs:/var/log/mysql
      - ./mysql_volumes/init:/docker-entrypoint-initdb.d
    # 先修改权限再启动MySQL
    entrypoint: ["sh", "-c", "chown -R mysql:mysql /var/lib/mysql /etc/mysql/conf.d /var/log/mysql /docker-entrypoint-initdb.d && exec docker-entrypoint.sh mysqld"]

networks:
  default:
    name: mysql-net
    driver: bridge

内容的提问来源于stack exchange，提问作者Gopher7