1. Android App
安装在手机上，用于登录 Gateway、创建会话、查看输出、处理审批和阅读版本说明。
DEPLOYMENT OVERVIEW
部署总览
这一页基于现有用户手册整理，面向已经准备实际部署的人。它先给你部署大图景， 再把你分流到 Windows、macOS 和 Docker 新手页面。
WHAT YOU NEED
部署 rCodex 之前，先把这四样东西准备好
2. Gateway 容器
运行在你的电脑或服务器上，负责连接本机 Codex CLI、保存历史和提供 HTTP / WebSocket 服务。
3. 宿主机登录态
宿主机必须已经登录过 Codex CLI，Gateway 只会读取 `~/.codex`，不会替你做登录。
4. 工作区目录
准备一段可操作的代码目录，例如 `/data`、`/workspace` 或你的项目目录，并和白名单保持一致。
DOWNLOAD & ENTRY
先把当前稳定版入口记住，再开始部署
Android APK
官网固定 APK 下载地址，始终指向当前稳定版：
http://code.rcodex.org/rcodex/rCodex-latest.apk
Gateway 镜像
官网文档默认使用最新稳定镜像：
rcodexlab/rcodex-gateway:latest
版本说明
App 当前稳定版更新说明固定入口：
http://code.rcodex.org/rcodex/releases/latest.html
Gateway 升级文档
Gateway 升级说明：
http://code.rcodex.org/rcodex/deploy.html
STANDARD FLOW
部署主线可以压缩成 6 步
检查 Docker 和 Codex 登录态
确认 `docker version`、`docker compose version` 可用，并且宿主机存在 `~/.codex`。
创建部署目录和持久化数据目录
例如 `~/rcodex-deploy` 和 `gateway-data/`，后续的 `docker-compose.yml` 与 `.env` 都放这里。
修改 `.env`
至少改账号、密码、token、Codex 登录态路径、工作区路径和白名单路径。
启动 Gateway
使用 `docker compose pull && docker compose up -d`，或离线镜像 `docker load -i ...tar` 后启动。
验证健康检查和版本清单
至少确认 `/healthz` 和 `/rcodex/version.json` 可访问，再让 App 登录。
App 登录并开始使用
App 地址只填到端口，例如 `http://服务器IP:8787`，不要带 `/auth/login`。
NEXT PAGE
根据你的平台继续往下看
Windows 部署
适合 Docker Desktop + WSL 2 场景，包含文件共享、Windows 防火墙和局域网 IP 说明。
继续看 Windows 指南macOS 部署
适合 Docker Desktop for Mac，包含 `~/.codex`、工作区路径和局域网 IP 获取方式。
继续看 macOS 指南Docker 新手部署
如果你只想快速把 Gateway 跑起来，先看这页最省时间。
继续看 Docker 新手