Files
codex-proxy-rs/deploy

Deploy

Docker 部署入口集中在本目录。

Compose

首次部署先复制样例配置:

mkdir -p .runtime/data .runtime/logs
cp deploy/config.example.yaml .runtime/config.yaml

deploy/config.example.yaml 是 Docker 部署模板。Compose 默认把配置、数据和日志都放在仓库 .runtime/ 下:

  • .runtime/config.yaml -> /app/config.yaml
  • .runtime/data -> /app/data
  • .runtime/logs -> /app/logs

复制后必须设置 admin.default_password,空值或常见弱口令会被后端拒绝启动。 如果前面还有 Nginx、Caddy、Cloudflare Tunnel 等反向代理,只在该代理会覆盖或清理 X-Forwarded-For / X-Real-IP / CF-Connecting-IP 时,把代理的 IP 或 CIDR 写入 server.trusted_proxies;默认空列表会剥离这些客户端可伪造的头并使用 TCP peer IP。

构建并启动:

docker compose -f deploy/docker-compose.yml build
docker compose -f deploy/docker-compose.yml up -d

可以通过环境变量覆盖宿主机路径;容器内会通过 CPR_CONFIG_FILE=/app/config.yaml 显式读取挂载后的配置:

CPR_CONFIG_FILE=/path/to/config.yaml \
CPR_DATA_DIR=/path/to/data \
CPR_LOG_DIR=/path/to/logs \
docker compose -f deploy/docker-compose.yml up -d

Build

Docker 构建上下文保持仓库根目录:

docker build -f deploy/Dockerfile -t codex-proxy-rs:latest .

也可以通过 Compose 构建:

docker compose -f deploy/docker-compose.yml build

需要注入版本信息时:

CPR_VERSION="$(ruby -ryaml -e 'puts YAML.load_file("release/version.yaml").fetch("version").delete_prefix("v")')" \
CPR_GIT_SHA="$(git rev-parse HEAD)" \
CPR_BUILD_TIME="$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
docker compose -f deploy/docker-compose.yml build