codex-proxy-rs/deploy/README.md

Deploy

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

Compose

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

cp deploy/config.example.yaml deploy/config.yaml

deploy/config.example.yaml 是 Docker 部署模板，默认将数据写入容器内 /app/data、日志写入 /app/logs，由 Compose 命名卷持久化。 复制后必须设置 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

默认挂载和卷：

• deploy/config.yaml -> /app/config.yaml
• cpr-data -> /app/data
• cpr-logs -> /app/logs

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

CPR_CONFIG_FILE=/path/to/config.yaml \
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