Mac M3 使用 OrbStack 全新安装运行 EasyConnect 完整教程

风雨_2026-10-14 10:46

环境：Mac M3 芯片，macOS 15，24GB 内存。

目标：从零开始在 OrbStack 中安装并运行 EasyConnect 图形界面版，使用 p12 证书 + 短信验证码登录，并以最少资源稳定运行。

目录

  1. [为什么选择 OrbStack](#为什么选择 OrbStack "#1-%E4%B8%BA%E4%BB%80%E4%B9%88%E9%80%89%E6%8B%A9-orbstack")
  2. [安装 OrbStack](#安装 OrbStack "#2-%E5%AE%89%E8%A3%85-orbstack")
  3. [设置 OrbStack 资源限制](#设置 OrbStack 资源限制 "#3-%E8%AE%BE%E7%BD%AE-orbstack-%E8%B5%84%E6%BA%90%E9%99%90%E5%88%B6")
  4. [拉取 EasyConnect 镜像](#拉取 EasyConnect 镜像 "#4-%E6%8B%89%E5%8F%96-easyconnect-%E9%95%9C%E5%83%8F")
  5. [启动 EasyConnect 容器](#启动 EasyConnect 容器 "#5-%E5%90%AF%E5%8A%A8-easyconnect-%E5%AE%B9%E5%99%A8")
  6. [导入 p12 证书](#导入 p12 证书 "#6-%E5%AF%BC%E5%85%A5-p12-%E8%AF%81%E4%B9%A6")
  7. [安装并连接 VNC](#安装并连接 VNC "#7-%E5%AE%89%E8%A3%85%E5%B9%B6%E8%BF%9E%E6%8E%A5-vnc")
  8. [登录 EasyConnect](#登录 EasyConnect "#8-%E7%99%BB%E5%BD%95-easyconnect")
  9. [限制 EasyConnect 容器资源](#限制 EasyConnect 容器资源 "#9-%E9%99%90%E5%88%B6-easyconnect-%E5%AE%B9%E5%99%A8%E8%B5%84%E6%BA%90")
  10. 合盖与睡眠行为
  11. 日常使用与容器管理
  12. 常见问题排查
  13. 重要提醒

1. 为什么选择 OrbStack

OrbStack 是一款专为 macOS 打造的原生 Swift 应用，相比 Docker Desktop 有明显优势：

特性 OrbStack Docker Desktop
启动速度 约 2 秒 较慢
空闲 CPU 占用 低于 0.1% 较高
空闲内存占用 约 300MB 1--2GB
文件挂载性能 比 Docker Desktop 快 2--5 倍 基准
架构 原生 Swift，非 Electron Electron

OrbStack 开箱即用，Docker 和 Docker Compose 等工具都已包含，无需额外配置。

2. 安装 OrbStack

方法一：官网下载

  1. 打开浏览器，访问 OrbStack 官网：https://orbstack.dev/download
  2. 点击下载 Apple Silicon 版本的 .dmg 文件。
  3. 双击下载的 .dmg，将 OrbStack 图标拖入 Applications 文件夹。
  4. 打开"启动台"，找到 OrbStack 并点击启动。
  5. 首次启动会要求输入 Mac 管理员密码，按提示输入即可完成虚拟化扩展授权。
  6. 菜单栏出现 OrbStack 图标（方形标志）即安装成功。

方法二：Homebrew 安装

如果你已经安装了 Homebrew，可以在终端执行：

bash 复制代码 
brew install orbstack

安装完成后，打开 Applications 中的 OrbStack 完成初始化。

验证安装

在终端执行：

bash 复制代码 
orb version

能显示版本号即安装成功。

3. 设置 OrbStack 资源限制

OrbStack 的内存限制可以通过命令行设置，图形界面最低只显示 1GB，但命令行可以设得更低。根据你的需求（最少资源），推荐以下配置。

3.1 设置内存上限

在终端执行：

bash 复制代码 
orb config set memory_mib 1024

这条命令将 OrbStack 的总内存上限设为 1GB 。OrbStack 官方文档指出，内存是"容器和机器在 OrbStack 中运行时允许使用的总内存量"，内存不再使用时会被释放。

可调更低 ：如果想更激进，可以设为 500，这是 OrbStack 实际支持的下限。如果 EasyConnect 运行卡顿，再调回 768 或 1024。

3.2 设置 CPU 上限

bash 复制代码 
orb config set cpu 200

CPU 限制是"容器和机器在 OrbStack 中运行时允许使用的 CPU 百分比"，这不是预留，OrbStack 只按程序实际使用的量来消耗 CPU 。设为 200 即限制最多使用 2 个核心。

3.3 设置生效

修改配置后，建议重启 OrbStack：

bash 复制代码 
orb restart

4. 拉取 EasyConnect 镜像

打开终端，执行：

bash 复制代码 
docker pull hagb/docker-easyconnect:7.6.7

为什么用 7.6.7？

  • 稳定版，官方支持 arm64（M3）。
  • 支持所有认证方式（p12 证书 + 短信）。
  • dev 标签为开发版，不推荐。

如果拉取速度慢，可自行配置 Docker 代理或使用镜像加速。

拉取完成后，可以用 docker images 确认镜像存在。

5. 启动 EasyConnect 容器

在终端执行以下命令（将 xxxx 替换为你自己设置的 VNC 密码）：

bash 复制代码 
docker run -d --name easyconnect \
  --device /dev/net/tun --cap-add NET_ADMIN \
  -e PASSWORD=xxxx \
  -e URLWIN=1 \
  -e DISABLE_PKG_VERSION_XML=1 \
  -v $HOME/.ecdata:/root \
  -p 127.0.0.1:5901:5901 \
  -p 127.0.0.1:1080:1080 \
  -p 127.0.0.1:8888:8888 \
  hagb/docker-easyconnect:7.6.7

参数说明：

参数 作用
-d 后台运行，关闭终端不停止
--name easyconnect 固定容器名，方便管理
--device /dev/net/tun 允许创建 VPN 网络接口
--cap-add NET_ADMIN 网络管理权限
-e PASSWORD=xxxx VNC 连接密码
-e DISABLE_PKG_VERSION_XML=1 arm64 必须加，绕过版本检查
-v $HOME/.ecdata:/root 持久化容器数据到 Mac
-p 5901:5901 VNC 端口
-p 1080:1080 Socks5 代理端口
-p 8888:8888 HTTP 代理端口

关键：不要加 --rm，否则容器停止即删除，证书会丢失。

验证容器运行：

bash 复制代码 
docker ps

应看到 easyconnect 正在运行。

6. 导入 p12 证书

arm64 架构下 EasyConnect 图形界面无法直接导入 p12 证书，需手动拷贝到容器内的指定目录。

第一步：确认证书文件位置

确认你的 .p12 文件在 Mac 上的位置，比如 ~/Downloads/你的证书.p12。

第二步：创建证书目录并拷贝

bash 复制代码 
docker exec easyconnect mkdir -p /usr/share/sangfor/EasyConnect/resources/user_cert
docker cp ~/Downloads/你的证书.p12 easyconnect:/usr/share/sangfor/EasyConnect/resources/user_cert/

第三步：验证证书已拷贝

bash 复制代码 
docker exec easyconnect ls -l /usr/share/sangfor/EasyConnect/resources/user_cert/

应能看到你的 .p12 文件名。

只要容器不删除，证书一直存在。关闭 OrbStack、重启 Mac 都不会丢失。

7. 安装并连接 VNC

7.1 安装 VNC Viewer

下载并安装 VNC Viewer （RealVNC 官方免费版）：https://www.realvnc.com/en/connect/download/viewer/

也可以使用 Mac 自带的屏幕共享：在 Finder 中按 Command + K，输入 vnc://127.0.0.1:5901。

7.2 创建 VNC 连接

  1. 打开 VNC Viewer，点击 File → New connection。
  2. VNC Server 填：127.0.0.1:5901
  3. Name 随意，比如 OrbStack EasyConnect，点击 OK。
  4. 双击连接，忽略加密警告，输入第 5 步设置的 VNC 密码。

7.3 如果 VNC 连不上

检查端口映射是否正常：

bash 复制代码 
docker ps

看 PORTS 列，应该显示：

bash 复制代码 
127.0.0.1:5901->5901/tcp
127.0.0.1:1080->1080/tcp
127.0.0.1:8888->8888/tcp

如果端口没映射，说明容器启动参数有问题，需要删除容器后重新执行第 5 步（先 docker rm easyconnect，再重新 docker run）。

8. 登录 EasyConnect

  1. 在 VNC 窗口中看到 EasyConnect 登录界面。
  2. 输入 服务器地址 、用户名 和密码。
  3. 弹出证书选择时，选择拷入的 p12 证书；若提示输入证书密码，输入你安装证书时设置的密码。
  4. 需要短信验证码时，查看手机短信并填入。
  5. 显示"已连接"即登录成功。

命令行版不支持短信验证，必须使用图形界面版。

9. 限制 EasyConnect 容器资源

除了 OrbStack 全局限制，还可以给 EasyConnect 容器本身设一个更严格的天花板。使用 docker update 动态修改，不需要重建容器：

bash 复制代码 
docker update easyconnect --cpus=1 --memory=512m --memory-swap=512m
参数 作用
--cpus=1 限制最多使用 1 个 CPU 核心
--memory=512m 限制最多使用 512MB 内存
--memory-swap=512m 交换空间与内存相同

如果登录后 VNC 界面明显卡顿，把 512m 上调到 768m 或 1g。

查看实时资源占用：

bash 复制代码 
docker stats easyconnect

10. 合盖与睡眠行为

OrbStack 有一个省电特性 ：当 macOS 进入睡眠（包括合盖）时，会自动暂停所有容器，以节省电量。

默认行为（合盖 → 暂停）

合盖后 EasyConnect 容器会被暂停，VPN 连接断开。翻盖唤醒后，不会自动重连，需要你手动在 VNC 界面重新登录 EasyConnect（输入密码 + 短信验证码）。

如果希望合盖后不暂停

执行：

bash 复制代码 
orb config set power.pause_on_sleep false

风险提醒 ：禁用后 Mac 合盖时容器会继续运行，但耗电会明显增加 ，对 MacBook Air 的续航不太友好。建议只在需要短时间合盖保持连接时临时使用，用完改回 true。

11. 日常使用与容器管理

11.1 下次使用时如何打开？

  1. 打开 OrbStack（在 Applications 中双击，或点击菜单栏图标）。

  2. 终端执行：

    bash 复制代码 
    docker start easyconnect

  3. 打开 VNC Viewer，连接 127.0.0.1:5901，输入 VNC 密码。

  4. 在 EasyConnect 界面重新登录（密码 + 短信验证码）。证书无需重新导入。

11.2 常用命令

操作 命令
启动容器 docker start easyconnect
停止容器 docker stop easyconnect
查看容器状态 docker ps -a
查看日志 docker logs easyconnect
查看资源占用 docker stats easyconnect
删除容器（谨慎） docker rm easyconnect

注意 ：docker rm 会删除容器内所有数据，包括拷入的证书。

11.3 容器会一直是同一个吗？

是的。只要不执行 docker rm，easyconnect 就是同一个容器。关闭 OrbStack、重启 Mac 都不会改变。

12. 常见问题排查

问题 原因 解决
拉取镜像超时 网络问题 可尝试配置 Docker 代理或使用镜像加速
VNC 连接失败 容器未运行或端口未映射 docker ps 确认，检查 -p 5901:5901
登录提示版本过低 arm64 版本检查 确认启动命令含 -e DISABLE_PKG_VERSION_XML=1
证书导入失败 arm64 GUI 导入失效 用 docker cp 手动拷贝到 user_cert 目录
证书有密码 需要手动输入 在 VNC 界面弹出提示时输入证书密码
合盖后 EasyConnect 断开 OrbStack 省电特性 正常现象，翻盖后手动重新登录
OrbStack 占用 1.3GB 虚拟机基线开销 用 orb config set memory_mib 1024 限制
内存限制无法调更低 图形界面最低 1GB 用命令行 orb config set memory_mib 500 可调更低

13. 重要提醒

  1. 必须下载 Apple Silicon 版 OrbStack。
  2. 启动容器时不要加 --rm，否则证书丢失。
  3. arm64 必须加 -e DISABLE_PKG_VERSION_XML=1。
  4. p12 证书必须用 docker cp 手动拷贝，证书密码在 VNC 界面中输入。
  5. 关闭 OrbStack 不会删除容器 ，下次 docker start easyconnect 即可。
  6. 合盖后 EasyConnect 会断开，翻盖后不会自动重连，需要手动登录。
  7. 资源推荐：OrbStack 全局 1GB 内存 / 2 核 CPU；容器 1 核 / 512MB 内存。

证书过期

名字相同 docker cp ~/Downloads/你的新证书.p12 easyconnect:/usr/share/sangfor/EasyConnect/resources/user_cert/ 名字不同，则先删除 docker exec easyconnect rm /usr/share/sangfor/EasyConnect/resources/user_cert/你的旧证书.p12 再执行cp

验证 docker exec easyconnect ls -l /usr/share/sangfor/EasyConnect/resources/user_cert/

相关推荐
Coder_张三21 小时前
iOS 26 适配
前端·ios·swift
用户38034165882971 天前
崩溃率从 0.3% 到 0.04%：我们做对的不是修 bug，是让每个崩溃只发生一次
ios·swift
2501_915921431 天前
详细教程：使用Perfdog工具测量iOS应用的功耗性能与优化方法
android·macos·ios·小程序·uni-app·cocoa·iphone
风雨_1 天前
RTK (Rust Token Killer) 安装、使用与卸载指南
ios
茶底世界之下1 天前
夜景暗部要提亮多少？用 Awaking 给雪夜街道留一点层次
ios
黑科技iOS上架1 天前
cocos游戏ios上架前加固流程（小蟹iOS混淆）
ios·审核·ios混淆·执行程序差异化
QWsin2 天前
「轻漾」App隐私政策
ios·个人开发
season_zhu2 天前
近段时间，AI加持下，我的开发感悟
ios
热门推荐
01国内可直接用、免费额度/永久免费的大模型API清单（含 SiliconFlow、火山、阿里、智谱、百度、Kimi、DeepSeek、DMXAPI 等）02历年考研数学一、数学二、数学三真题试卷及答案PDF03GitHub 镜像站点04「全语录+省流版」邵艾伦 × 孙宇晨：聊风口、聊个人IP、聊年轻人如何抓住 AI 时代的机会05蜘蛛磁力 搜索引擎大全，如何使用蜘蛛磁力查找磁力链接06如何新建文件夹？ 电脑新建文件夹的4种方法07Windows 10/11 如何退出微软账户并改用本地账户登录（含找不到选项的解决方法）08Telegram APK 下载安装完整指南 — 2026年最新09几个好用的ip纯净度检测网站10微信历史版本含下载地址（ Windows PC | 安卓 | MAC ）及设置微信不更新