在 Devin 中试用 DeepWiki 处理私有仓库
DeepWiki

sickcodes/Docker-OSX

菜单

Naked-Auto 镜像

相关源文件

Naked-Auto 镜像是一个专门的 Docker-OSX 变体，它将 Naked 镜像的自定义能力与自动 SSH 登录功能相结合。它允许用户提供自己的 macOS 磁盘镜像，同时为无头操作和 CI/CD 环境提供自动化功能。有关没有自动化的基本 Naked 镜像的信息，请参阅 Naked Image。

目的和功能

Naked-Auto 镜像作为完全可自定义但手动配置的 Docker-OSX 设置与自动化工作流之间的桥梁。此镜像变体专为以下目的而设计：

  • 使用预先存在的 macOS 磁盘镜像和自动 SSH 访问
  • 在 CI/CD 管道中运行自动化的 macOS 工作流
  • 在 macOS 中执行预定命令，无需手动干预
  • 需要无头 macOS 环境的测试和开发场景
  • 需要可重复、自动化环境的安全研究

来源： README.md477-481 Dockerfile.naked-auto15-16

架构概述

来源： Dockerfile.naked-auto237-258

容器初始化过程

来源： Dockerfile.naked-auto194-258

配置选项

naked-auto 镜像通过环境变量提供广泛的自定义功能

必需的环境变量

可变描述默认示例
USERNAMEmacOS 用户名，用于 SSH 登录user-e USERNAME=admin
PASSWORDmacOS 密码，用于 SSH 登录alpine-e PASSWORD=mysecretpass
IMAGE_PATH自定义 macOS 磁盘镜像的路径/image-v "$PWD/mac_hdd.img:/image"
OSX_COMMANDS通过 SSH 在 macOS 中执行的命令(无)-e "OSX_COMMANDS=brew install python"

硬件配置

可变描述默认示例
内存RAM 分配 (GB)3-e RAM=8
CPUCPU 类型仿真Penryn-e CPU=Haswell
KVMKVM 加速参数accel=kvm:tcg(很少更改)
NETWORKING网络适配器类型vmxnet3-e NETWORKING=e1000-82545em

显示选项

可变描述默认示例
DISPLAY使用的 X11 显示:99-e "DISPLAY=${DISPLAY:-:0.0}"
HEADLESS无显示运行false-e HEADLESS=true
WIDTH屏幕宽度 (使用 GENERATE 选项时)1920-e WIDTH=1600
HEIGHT屏幕高度 (使用 GENERATE 选项时)1080-e HEIGHT=900

序列号配置

可变描述默认示例
GENERATE_UNIQUE生成随机序列号false-e GENERATE_UNIQUE=true
GENERATE_SPECIFIC使用自定义序列号false-e GENERATE_SPECIFIC=true
DEVICE_MODELApple 设备型号(变化)-e DEVICE_MODEL="iMacPro1,1"
SERIAL设备序列号(随机)-e SERIAL="C02TW0WAHX87"
BOARD_SERIAL主板序列号(随机)-e BOARD_SERIAL="C027251024NJG36UE"
UUID系统 UUID(随机)-e UUID="5CCB366D-9118-4C61-A00A-E5BAF3BED451"
MAC_ADDRESSMAC 地址(随机)-e MAC_ADDRESS="A8:5C:2C:9A:46:2F"

来源： Dockerfile.naked-auto128-190

使用示例

使用现有磁盘镜像的基本用法

无头操作和自动化命令

带自定义屏幕分辨率的 CI/CD 管道

使用自定义序列号以支持 iCloud/iMessage

来源： README.md244-261 README.md1709-1721

操作流程图

来源： Dockerfile.naked-auto194-258

最佳实践和故障排除

最佳实践

  1. 磁盘镜像准备：确保您的 macOS 磁盘镜像已正确准备，并已

    • 在“系统偏好设置”→“共享”中启用 SSH
    • 为您的用户配置了自动登录
    • 预装了任何必需的软件

  2. 资源分配：根据您的工作负载分配适当的资源

    • 4GB+ RAM 用于 Xcode 或开发工作 (-e RAM=4)
    • 多个 CPU 核心用于构建过程 (-e EXTRA='-smp 4,cores=2')

  3. 网络：为了在资源密集型应用程序中获得更好的网络性能

    • 使用 vmxnet3 网卡 (默认)
    • 按需为您的应用程序转发其他端口

常见问题与解决方案

问题可能原因解决方案
容器立即退出无效的磁盘镜像路径检查您的磁盘镜像是否存在并已正确挂载
SSH 连接失败macOS 中未启用 SSH确保在“系统偏好设置”→“共享”中启用了 SSH
性能缓慢资源不足增加 RAM 和 CPU 分配
iCloud/iMessage 问题无效的序列号使用 GENERATE_UNIQUE=true 或提供有效的序列号
屏幕分辨率问题缺少序列号生成屏幕尺寸自定义需要使用 GENERATE_UNIQUE 或 GENERATE_SPECIFIC

来源： README.md686-786 README.md831-834

安全考量

使用 naked-auto 镜像时，请考虑以下安全隐患

  1. 密码存储：通过环境变量提供的密码在 Docker 历史记录和进程列表中可见。对于生产环境，请考虑

    • 使用密钥管理系统
    • 预先安装 SSH 密钥的镜像准备，而不是使用密码

  2. 网络暴露：SSH 端口默认暴露给主机。通过以下方式限制暴露：

    • 仅绑定到 localhost： -p 127.0.0.1:50922:10022
    • 使用适当的防火墙规则

  3. 序列号生成：使用 GENERATE_UNIQUE=true 时，请了解

    • 生成的序列号仅用于测试/开发
    • 对于生产系统，请考虑序列号使用可能涉及的法律问题

来源： README.md559-564

与 CI/CD 系统的集成

naked-auto 镜像因其自动化功能而特别适合 CI/CD 管道。关键集成点包括：

  1. 镜像准备：创建预先配置的 macOS 镜像，其中包含所有必需的工具和依赖项

  2. 容器化测试：通过 OSX_COMMANDS 变量，无需用户干预即可运行自动化测试

  3. 构建产物收集：使用卷挂载在容器和主机之间共享构建产物

  4. 无头操作：在 CI 环境中使用 -e HEADLESS=true 以实现高效的资源利用

来源： README.md704-774 README.md1129-1149

naked-auto 镜像建立在几项关键技术之上

  1. QEMU/KVM：用于运行 macOS 的硬件加速虚拟化
  2. OpenCore：启用 macOS 在非 Apple 硬件上运行的现代引导加载程序
  3. SSH 自动化：用于远程命令执行的安全 shell 访问
  4. Docker：提供隔离性和可重复性的容器化平台

有关底层组件的更多信息，请参阅 配置与自定义 和 高级主题。

来源： README.md427-491