tennis-training-hub/docs/deploy.md

Deployment Guide

Topology

• 宿主机 nginx：负责 te.hao.work 的 TLS、反向代理与大文件上传入口
• app 容器：Node 应用，端口 3000
• media 容器：Go 媒体服务，端口 8081
• worker 容器：Go 媒体归档 worker，共享媒体卷
• media-data 卷：录制片段、会话状态、归档成片

Required files

• .env
• docker-compose.yml
• deploy/nginx.te.hao.work.conf

Startup

cp .env.example .env
docker compose up -d --build

nginx

将 deploy/nginx.te.hao.work.conf 放到宿主机 nginx 站点目录，确认：

• ssl_certificate
• ssl_certificate_key
• proxy_pass http://127.0.0.1:3000 对应前端与业务 API
• proxy_pass http://127.0.0.1:8081 对应媒体服务

启用后重载 nginx：

nginx -t
systemctl reload nginx

Health checks

• curl http://127.0.0.1:3000/api/trpc/auth.me
• curl http://127.0.0.1:8081/media/health

Persistent data

媒体数据默认位于 Docker volume media-data 下，目录结构：

• sessions/<session_id>/session.json
• sessions/<session_id>/segments/*.webm
• public/sessions/<session_id>/recording.webm
• public/sessions/<session_id>/recording.mp4

Rollback

1. 保留 .env 和 media-data
2. 回退 Git 版本
3. 重新执行 docker compose up -d --build

如果只需停止录制链路，可单独关闭 media 与 worker，主站业务仍可继续运行。