rCodex Logo rCodexmacOS Deployment

MACOS GUIDE

macOS 部署

这页内容来自现有 macOS 部署手册，适用于 Docker Desktop for Mac + 宿主机 Codex 登录态挂载方式。

部署前提

  • Docker Desktop for Mac
  • Codex CLI 已在当前 macOS 用户下登录
  • 工作区目录，例如 `/Users/你的用户名/Projects`
  • 手机与 Mac 网络互通

推荐目录

  • `~/rcodex-deploy/`
  • `~/rcodex-deploy/.env`
  • `~/rcodex-deploy/docker-compose.yml`
  • `~/rcodex-deploy/gateway-data/`

STEP BY STEP

推荐流程

STEP 1

确认 Docker 与 `~/.codex`

先执行 `docker version`、`docker compose version`、`codex --version` 和 `ls -la ~/.codex`。

STEP 2

准备部署目录

使用 `~/rcodex-deploy` 和 `gateway-data` 保存 compose 文件、.env 和持久化数据。

STEP 3

修改 `.env`

至少更新 `RCODEX_CODEX_HOME_HOST_PATH`、工作区路径、账号密码、token 和端口。

STEP 4

启动 Gateway

离线镜像使用 `docker load -i`，仓库镜像使用 `docker compose pull`，再统一 `docker compose up -d`。

STEP 5

获取局域网 IP

无线网通常执行 `ipconfig getifaddr en0`，有线网可能是 `en1`。

STEP 6

App 登录

在手机上填写 `http://Mac局域网IP:8787`，不要额外带 `/auth/login`。

EXAMPLE

关键配置示例

RCODEX_CODEX_HOME_HOST_PATH=/Users/你的用户名/.codex
RCODEX_CLAUDE_HOME_HOST_PATH=/Users/你的用户名/.claude
RCODEX_WORKSPACE_HOST_PATH=/Users/你的用户名/Projects
RCODEX_WORKSPACE_CONTAINER_PATH=/workspace
GATEWAY_ALLOWED_PATHS=/workspace

GATEWAY_PORT=8787
GATEWAY_AUTH_USERNAME=your-name
GATEWAY_AUTH_PASSWORD=change-this-password
GATEWAY_AUTH_TOKEN=change-this-to-a-long-random-string

COMMON ISSUES

最常见的几个坑

App 能登录但看不到目录

优先检查工作区挂载和 `GATEWAY_ALLOWED_PATHS` 是否和容器内路径一致。

Codex 提示未登录

确认 `RCODEX_CODEX_HOME_HOST_PATH` 指向真实存在的 `~/.codex`。

Docker Desktop 无法挂载目录

如果工作区不在 `/Users` 下，需要到 Docker Desktop 文件共享设置里放行路径。