Olares

简体中文

English

简体中文

English

Appearance

使用 Docker 镜像在 Mac 上安装 Olares ​

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

不适用于生产环境

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 文件，添加镜像源：
    json
    {
  "builder": {
    "gc": {
      "defaultKeepStorage": "20GB",
      "enabled": true
    }
  },
  "experimental": false,
  "registry-mirrors": [
    "https://mirrors.olares.cn"
  ]
}
  3. 点击 Apply & restart 保存变更。

使用 Docker CLI 运行 Olares ​

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

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

bash
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. 从列表中选择目标 Olares 实例，并点击立即安装。

  3. 安装完成后，点击立即激活。

  4. 在选择反向代理对话框中，选择一个地理位置离你较近的节点并点击确认。安装程序会自动为 Olares 配置 HTTPS 证书和 DNS。 ISO 激活

    提示

    • 你可以稍后在 Olares 中的 更改反向代理 页面调整此设置。
    • 如果你的 Olares 设备连接的是公网 IP 网络，此步骤会自动跳过。

  5. 按照屏幕提示设置 Olares 的登录密码，然后点击完成。

    ISO Activate-2

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

管理 Olares 容器 ​

停止容器 ​

要停止运行中的容器：

bash
docker stop oic

重启容器 ​

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

bash
docker start oic

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

卸载容器 ​

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

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

下一步：安全保存 Olares ID ​

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