CodexMobile

Deploy

VPS 部署

1. 準備目錄

sudo mkdir -p /opt/CodexMobile
sudo chown -R $USER:$USER /opt/CodexMobile
cd /opt/CodexMobile

2. 啟用 systemd

可直接使用倉庫內附帶的 service 檔：

  • deploy/codexmobile.service
  • deploy/codexmobile-app-api.service
sudo cp deploy/codexmobile.service /etc/systemd/system/
sudo cp deploy/codexmobile-app-api.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable codexmobile codexmobile-app-api
sudo systemctl start codexmobile codexmobile-app-api

3. 配置 Nginx

sudo mkdir -p /var/www/codexmobile-site
sudo rsync -av site/ /var/www/codexmobile-site/
sudo cp deploy/codexmobile-site.nginx.conf /etc/nginx/sites-available/codexmobile-site
sudo ln -s /etc/nginx/sites-available/codexmobile-site /etc/nginx/sites-enabled/codexmobile-site
sudo nginx -t && sudo systemctl reload nginx

4. 域名與 HTTPS

建議使用： codexmobile.app、www.codexmobile.app、 docs.codexmobile.app、api.codexmobile.app。 

# DNS
@    A      <your-vps-ip>
www  CNAME  codexmobile.app
docs A      <your-vps-ip>
api  A      <your-vps-ip>

# HTTPS
sudo certbot --nginx \
  -d codexmobile.app \
  -d www.codexmobile.app \
  -d docs.codexmobile.app \
  -d api.codexmobile.app

VPS 必填設定與用途

CODEXMOBILE_PUBLIC_API_URL

填寫對外 API 域名，例如 https://api.codexmobile.app。手機端會透過這個地址進入 VPS Relay。

CODEXMOBILE_APP_API_TOKEN

手機端到 VPS API 的 Bearer Token。自行生成高強度隨機值，寫入 VPS 的 .env 與手機端。

CODEXMOBILE_MAC_SERVICE_TOKEN

VPS 轉回 Mac 本機服務的內部 Token。Mac 與 VPS 兩端必須一致。

Mac 端的 Codex 登錄

手機端不是直接在 VPS 上運行 Codex，而是接續你在 Mac 桌面端已登錄的 Codex / OpenAI 工作流。

如果你沒有自己的 VPS

你可以使用官方提供的域名與 Relay 服務，但如果直接使用 codexmobile.app 相關官方域名與官方 VPS， 這屬於付費托管服務，不屬於開源代碼默認免費提供的範圍。