使用 Docker 镜像在 Mac 上安装 Olares

你可以通过 Docker 可以在容器化环境中安装和运行 Olares。本文将带你了解：如何使用 Docker 设置 Olares，准备安装环境，完成激活流程，并管理容器的生命周期。

INFO

Mac 版 Olares 目前存在以下限制：

• 不支持分布式存储
• 无法添加本地节点

建议仅用于开发或测试环境。

系统要求

Mac 设备需满足以下条件：

• 处理器架构：AMD64 或 ARM64
• 内存：可用内存 8 GB 及以上
• 存储空间：可用磁盘空间 90 GB 及以上
• MacOS 版本：Monterey（12）及以上

开始之前

开始安装前，请确保：

• 系统中已安装并运行 Docker。
• 已知当前设备的 IP 地址。

  查看 IP 地址

  要查看 Mac 的 IP 地址，可以使用两种方式:

  • 使用图形界面：打开系统设置（或系统偏好设置）> 网络，在当前活动的网络连接中查看详细信息。
  • 使用命令行：打开终端窗口，Wi-Fi 网络输入 ipconfig getifaddr en0，有线网络输入 ipconfig getifaddr en1。
• 已通过 LarePass 创建 Olares ID 且使用默认的 olares.cn 域名。

运行 olaresd-proxy

确认 Mac 芯片

如果你不确定 Mac 所使用的芯片，请点击苹果菜单并选择关于本机，查看芯片类型。

更新 Docker 的镜像源

添加 Olares 的镜像源，提高镜像拉取速度。以 Docker Desktop 为例：

1. 打开 Docker Desktop，选择 Settings > Docker Engine。
2. 修改 Docker daemon 的 json 文件，添加镜像源：

   {
     "builder": {
       "gc": {
         "defaultKeepStorage": "20GB",
         "enabled": true
       }
     },
     "experimental": false,
     "registry-mirrors": [
       "https://mirrors.joinolares.cn"
     ]
   }

3. 点击 Apply & restart 保存变更。

使用 Docker CLI 运行 Olares

执行以下命令来拉取 Olares 的镜像。

将 <host ip> 替换为设备的 IP 地址，将 <olares version>-cn 替换为想要使用的 Olares 版本：

docker run -d --privileged -v oic-data:/var \
  -e HOST_IP=<host ip> \
  -p 80:80 \
  -p 443:443 \
  -p 30180:30180 \
  -p 18088:18088 \
  -p 41641:41641/udp \
  --name oic \
  beclab/olares:<olares version>-cn

其中：

• -d：以分离模式（detached mode）启动容器，允许其在后台运行。
• --privileged：授予容器完整的系统权限。
• -v oic-data:/var：将 Docker 数据卷（oic-data）挂载到容器内的 /var 目录以持久化数据。
• -e HOST_IP=<host ip>：设置主机设备的 IP 地址作为环境变量
• -p 80:80：将主机的 80 端口映射到容器的 80 端口。
• -p 443:443：将主机的 443 端口映射到容器的 443 端口。
• -p 30180:30180：将主机的 30180 端口映射到容器的 30180 端口。
• -p 18088:18088：将宿主机的 18088 端口映射到容器的 18088 端口。
• -p 41641:41641/udp：将宿主机的 41641 UDP 端口映射到容器的 41641 UDP 端口。
• --name oic：将容器命名为 oic（Olares in container）方便后续引用。
• beclab/olares:<olares version>-cn：指定 Olares Docker 镜像及版本，例如beclab/olares:1.11.5-cn。

容器启动后，你会看到一个容器 ID。

请勿添加 --rm 参数

--rm 参数会在容器停止后自动删除容器。如果发生这种情况，将无法重新启动容器，必须重新安装 Olares 才能再次运行。不使用此参数可以在停止后保留容器，让你能够通过 docker start 命令恢复运行。

安装并激活 Olares

检查网络连接

为避免激活失败，请确保你的手机和 Olares 设备连接到同一网络。

1. 打开 LarePass，在账号激活页面点击发现附近的 Olares。LarePass 将列出同一网络中检测到的 Olares 实例。
2. 选择标记为 Container 的 Olares 设备，点击立即安装。
3. 安装完成后，点击立即激活。Olares 将开始激活流程，包括初始配置和网络设置。
4. 按照屏幕提示重置 Olares 的登录密码，然后点击完成。

激活完成后，LarePass 将显示 Olares 设备的桌面地址，如 https://desktop.marvin123.olares.cn。

登录 Olares

1. 在登录页面输入 Olares 登录密码。

   

2. 系统会要求完成双重验证。你可以选择在 LarePass 上确认登录，或手动输入 6 位验证码。

   INFO

   验证码有时效限制，请在过期前完成输入。如果验证码过期，需要重新生成。

   

登录后你就会看到 Olares 桌面。🎉

管理 Olares 容器

停止容器

要停止运行中的容器：

docker stop oic

重启容器

容器停止后，使用以下命令重启：

docker start oic

容器重启后，所有服务可能需要 6–7 分钟才能完全初始化。在此时间内请耐心等待。

卸载容器

要完全移除容器及其关联数据：

docker stop oic
docker rm oic
docker volume rm oic-data

下一步：安全保存 Olares ID

你已经准备好开始使用 Olares！在此之前，请务必确保 Olares ID 已安全备份。如果不备份，你将无法在需要时恢复 Olares ID。

• 备份助记词