# 2026-06-04 — Ubuntu 离线开发环境辅助

## 摘要

为宿主机 `uvicorn --reload` 开发流程补充 `docker/sync_root_env.py`，并在 Compose 中暴露 Redis `6379` 端口。

## 动机

`UBUNTU-DEV-README.txt` 要求将 `docker/.env` 手工抄到根目录 `.env` 且 `DATABASE_URL` 指向 `127.0.0.1`；原 `docker-compose.yml` 未映射 Redis，宿主机无法连接。

## 涉及文件

- `docker/sync_root_env.py`（新建）
- `docker-compose.yml`（`redis` 增加 `REDIS_PUBLISH_PORT`）
- `docker/.env.example`（注释 `REDIS_PUBLISH_PORT`）
- `UBUNTU-DEV-README.txt`（步骤更新）

## 迁移 / 重启

- 无 DB 迁移
- 已运行中的 Compose 栈：`docker compose up -d mysql redis` 重建 redis 服务以应用端口映射

## 验证

```bash
python3 docker/generate_env.py && python3 docker/sync_root_env.py
docker compose up -d mysql redis
curl -s http://127.0.0.1:8600/health   # uvicorn 启动后期望 ok
```
