RabbitMQ Docker Compose配置SSL报错：ssl_options.keyfile无效

问题描述 #

我尝试通过Docker Compose为RabbitMQ部署配置SSL，相关配置如下：

rabbitmq.conf

ssl_options.certfile     = /container/path/to/certfile.crt
ssl_options.keyfile      = /container/path/to/keyfile.key

docker-compose.yml

rabbitmq:
  image: rabbitmq:3.10.7-management
  ...
  volumes:
    - /host/path/to/certfile.crt:/container/path/to/certfile.crt
    - /host/path/to/keyfile.crt:/container/path/to/keyfile.key
    - ...
  ...

启动容器时出现错误：

ssl_options.keyfile invalid, file does not exist or cannot be read by the node

已确认卷挂载配置路径正确，主机上的keyfile确实存在。

解决方案 #

• 修正挂载映射的文件名错误
  配置里存在明显的文件名不匹配问题：docker-compose.yml中你把主机的keyfile.crt（证书文件）挂载到了容器内的keyfile.key（密钥文件路径），相当于用证书文件替代了密钥文件，导致RabbitMQ无法识别。修正后的挂载配置应为：

  volumes:
    - /host/path/to/certfile.crt:/container/path/to/certfile.crt
    - /host/path/to/keyfile.key:/container/path/to/keyfile.key
  

• 调整文件权限
  RabbitMQ容器默认以rabbitmq用户（UID/GID为999）运行，需确保主机上的证书和密钥文件能被该用户读取：

  1. 给文件设置通用可读权限：

     chmod 644 /host/path/to/certfile.crt /host/path/to/keyfile.key
     

  2. 或者直接修改文件所有者为容器用户：

     chown 999:999 /host/path/to/certfile.crt /host/path/to/keyfile.key
     

• 验证密钥文件格式
  RabbitMQ仅支持PEM格式的私钥文件，用以下命令验证格式是否正确：

  openssl rsa -in /host/path/to/keyfile.key -check
  

  若命令返回密钥信息则格式正常；若报错，需将密钥转换为PEM格式。

• 手动检查容器内文件状态
  临时启动容器进入交互模式，直接确认文件是否存在且可读取：

  docker-compose run --rm rabbitmq bash
  # 进入容器后执行
  ls -l /container/path/to/keyfile.key
  cat /container/path/to/keyfile.key
  

  如果文件不存在，说明挂载路径有误；如果文件存在但无法读取，回到权限调整步骤。

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