安装与初始设置下载安装免费版OrbStack在OrbStack里面使用DockerOrbStack内置的Docker引擎和Docker Compose版本会随应用版本一起更新在终端Terminal中运行以下命令查看版本dockerversiondockercompose version手动编辑配置文件修改docker镜像源地址vi~/.orbstack/config/docker.json{registry-mirrors:[https://docker.xuanyuan.me,https://docker.1ms.run,https://docker.m.daocloud.io]}保存文件后重启 OrbStack 或 Docker 服务使配置生效在菜单栏点击OrbStack图标选择Restart或在终端执行命令orb restart docker配置并重启后可以执行以下命令来检查镜像源是否设置成功dockerinfo|grep-A5Registry Mirrors 使用 Docker 容器启动一个 Nginx 容器并将本地的 8080 端口映射到容器的 80 端口#使用最新版本 docker run -d -p 8080:80 nginx:latest #使用特定版本并重命名为nginx1.30.4 docker run -d -p 8080:80 --name nginx1.30.4 nginx:1.30.4启动后在浏览器访问http://localhost:8080就能看到 Nginx 的欢迎页 管理 Linux 虚拟机OrbStack 可以快速创建和运行完整的 Linux 虚拟机非常适合需要一个独立 Linux 环境的场景。创建并启动虚拟机# 创建一个名为 my-ubuntu 的 Ubuntu 虚拟机orb create ubuntu my-ubuntu# 启动该虚拟机orb start my-ubuntu连接虚拟机# 通过 SSH 进入名为 my-ubuntu 的虚拟机orbsshmy-ubuntu你也可以直接执行 orb 命令进入默认的 Linux 环境。在虚拟机中通过 /mac/home/ 路径可以访问你 Mac 上的文件在虚拟机上运行命令无需进入 Shell可以直接在 Mac 终端执行虚拟机内的命令orbuname-a# 查看虚拟机内核信息⚙️ 核心功能与配置资源调整你可以通过图形界面或编辑 ~/.orbstack/config.yaml 文件来灵活调整 OrbStack 可使用的 CPU 和内存资源例如将其内存限制调整为 8GB。文件共享OrbStack 提供了高效的文件共享。你可以在虚拟机中直接访问 Mac 的文件反之亦然。为获得最佳性能Docker 的数据卷默认存储在 ~/OrbStack/docker 目录下。网络Host 网络模式、VPN、DNS 等网络功能都直接可用无需额外配置。命令行工具orb核心命令可用于管理虚拟机、运行命令等。 orb pull/push在 Mac 和虚拟机之间传输文件。 mac在 Linux 虚拟机中使用 mac 命令可以直接调用 macOS 的功能如发送通知 (mac notify 任务完成) 。安装指定版本的PHP镜像并重命名docker run -d --name php8.5-fpm php:8.5.9-fpm下面通过项目test.cn来完整演示一遍项目目录结构如下项目需要使用gd这一PHP扩展因为PHP官方镜像默认不带gd扩展同理如果还需其他扩展必须通过Dockerfile编译安装。your-project/ ├── .env ├── compose.yaml ├── www/ │ └── index.php └── docker/ ├── php/ │ ├── Dockerfile │ └── php.ini └── nginx/ └── conf.d/ └── test.cn.confphp的文件Dockerfile内容如下FROM php:8.5.9-fpm-alpine # 需要先安装gd扩展所依赖的底层图像处理库 RUN apk add --no-cache --virtual .build-deps \ libjpeg-turbo-dev \ libpng-dev \ freetype-dev \ libwebp-dev ; # 配置gd RUN docker-php-ext-configure gd \ --with-freetype \ --with-jpeg/usr/include \ --with-webp; # 安装gd RUN docker-php-ext-install -j $(nproc) gd; RUN apk del --no-cache .build-deps # 安装 Composer # COPY --fromcomposer:latest /usr/bin/composer /usr/bin/composerPHP8.0开始已经内置了mbstring扩展无需安装需要注意的是安装软件包使用的是apk add而不是apt-get。apk add是Alpine Linux的语法而apt‑get是Debian/Ubuntu的语法如果觉得Dockerfile手动管理这些依赖比较麻烦也可以使用社区维护的install-php-extensions脚本。这个脚本会自动处理所有必需的依赖。FROM php:8.5.9-fpm-alpine # 下载脚本 ADD --chmod0755 https://github.com/mlocati/docker-php-extension-installer/releases/latest/download/install-php-extensions /usr/local/bin/ # 一行命令安装多个扩展会自动处理所有依赖 RUN install-php-extensions gd redis查看网络docker network ls检查配置是否生效docker compose config终端启动运行项目docker compose up -d --buildDocker默认会对Dockerfile的每一条RUN做构建缓存如果内容没有改动下次docker compose up --build不会重新执行直接复用旧缓存也可以指定不使用缓存构建开发调试使用docker compose up -d --build --no-cache由于test.cn是虚假域名你需要修改本地 hosts 文件/etc/hosts添加一行127.0.0.1 test.cn浏览器输入test.cn即可查看到index.php的内容 OrbStack快速入门
安装与初始设置下载安装免费版OrbStack在OrbStack里面使用DockerOrbStack内置的Docker引擎和Docker Compose版本会随应用版本一起更新在终端Terminal中运行以下命令查看版本dockerversiondockercompose version手动编辑配置文件修改docker镜像源地址vi~/.orbstack/config/docker.json{registry-mirrors:[https://docker.xuanyuan.me,https://docker.1ms.run,https://docker.m.daocloud.io]}保存文件后重启 OrbStack 或 Docker 服务使配置生效在菜单栏点击OrbStack图标选择Restart或在终端执行命令orb restart docker配置并重启后可以执行以下命令来检查镜像源是否设置成功dockerinfo|grep-A5Registry Mirrors 使用 Docker 容器启动一个 Nginx 容器并将本地的 8080 端口映射到容器的 80 端口#使用最新版本 docker run -d -p 8080:80 nginx:latest #使用特定版本并重命名为nginx1.30.4 docker run -d -p 8080:80 --name nginx1.30.4 nginx:1.30.4启动后在浏览器访问http://localhost:8080就能看到 Nginx 的欢迎页 管理 Linux 虚拟机OrbStack 可以快速创建和运行完整的 Linux 虚拟机非常适合需要一个独立 Linux 环境的场景。创建并启动虚拟机# 创建一个名为 my-ubuntu 的 Ubuntu 虚拟机orb create ubuntu my-ubuntu# 启动该虚拟机orb start my-ubuntu连接虚拟机# 通过 SSH 进入名为 my-ubuntu 的虚拟机orbsshmy-ubuntu你也可以直接执行 orb 命令进入默认的 Linux 环境。在虚拟机中通过 /mac/home/ 路径可以访问你 Mac 上的文件在虚拟机上运行命令无需进入 Shell可以直接在 Mac 终端执行虚拟机内的命令orbuname-a# 查看虚拟机内核信息⚙️ 核心功能与配置资源调整你可以通过图形界面或编辑 ~/.orbstack/config.yaml 文件来灵活调整 OrbStack 可使用的 CPU 和内存资源例如将其内存限制调整为 8GB。文件共享OrbStack 提供了高效的文件共享。你可以在虚拟机中直接访问 Mac 的文件反之亦然。为获得最佳性能Docker 的数据卷默认存储在 ~/OrbStack/docker 目录下。网络Host 网络模式、VPN、DNS 等网络功能都直接可用无需额外配置。命令行工具orb核心命令可用于管理虚拟机、运行命令等。 orb pull/push在 Mac 和虚拟机之间传输文件。 mac在 Linux 虚拟机中使用 mac 命令可以直接调用 macOS 的功能如发送通知 (mac notify 任务完成) 。安装指定版本的PHP镜像并重命名docker run -d --name php8.5-fpm php:8.5.9-fpm下面通过项目test.cn来完整演示一遍项目目录结构如下项目需要使用gd这一PHP扩展因为PHP官方镜像默认不带gd扩展同理如果还需其他扩展必须通过Dockerfile编译安装。your-project/ ├── .env ├── compose.yaml ├── www/ │ └── index.php └── docker/ ├── php/ │ ├── Dockerfile │ └── php.ini └── nginx/ └── conf.d/ └── test.cn.confphp的文件Dockerfile内容如下FROM php:8.5.9-fpm-alpine # 需要先安装gd扩展所依赖的底层图像处理库 RUN apk add --no-cache --virtual .build-deps \ libjpeg-turbo-dev \ libpng-dev \ freetype-dev \ libwebp-dev ; # 配置gd RUN docker-php-ext-configure gd \ --with-freetype \ --with-jpeg/usr/include \ --with-webp; # 安装gd RUN docker-php-ext-install -j $(nproc) gd; RUN apk del --no-cache .build-deps # 安装 Composer # COPY --fromcomposer:latest /usr/bin/composer /usr/bin/composerPHP8.0开始已经内置了mbstring扩展无需安装需要注意的是安装软件包使用的是apk add而不是apt-get。apk add是Alpine Linux的语法而apt‑get是Debian/Ubuntu的语法如果觉得Dockerfile手动管理这些依赖比较麻烦也可以使用社区维护的install-php-extensions脚本。这个脚本会自动处理所有必需的依赖。FROM php:8.5.9-fpm-alpine # 下载脚本 ADD --chmod0755 https://github.com/mlocati/docker-php-extension-installer/releases/latest/download/install-php-extensions /usr/local/bin/ # 一行命令安装多个扩展会自动处理所有依赖 RUN install-php-extensions gd redis查看网络docker network ls检查配置是否生效docker compose config终端启动运行项目docker compose up -d --buildDocker默认会对Dockerfile的每一条RUN做构建缓存如果内容没有改动下次docker compose up --build不会重新执行直接复用旧缓存也可以指定不使用缓存构建开发调试使用docker compose up -d --build --no-cache由于test.cn是虚假域名你需要修改本地 hosts 文件/etc/hosts添加一行127.0.0.1 test.cn浏览器输入test.cn即可查看到index.php的内容