$ docker --version
Docker version 29.9.2, build a82e528
$ docker compose version
Docker Compose version v5.6.1

$ ss -ltn | grep -E ':8146|:8148|:5434'
# 部署前无输出（空闲）；部署后：
LISTEN 0 4096 0.0.0.0:8146 0.0.0.0:*
LISTEN 0 4096 0.0.0.0:8148 0.0.0.0:*
LISTEN 0 4096 127.0.0.1:5434 0.0.0.0:*

$ docker pull docker.1ms.run/mikebgrep/forkapi:latest
Status: Image is up to date for docker.1ms.run/mikebgrep/forkapi:latest
docker.1ms.run/mikebgrep/forkapi:latest
$ docker tag docker.1ms.run/mikebgrep/forkapi:latest mikebgrep/forkapi:latest
$ docker images --format '{{.Repository}}:{{.Tag}}\t{{.Size}}' | grep forkapi
mikebgrep/forkapi:latest      2.96GB
docker.1ms.run/mikebgrep/forkapi:latest   2.96GB

$ git clone --branch v.4.1.1-Hot-fix --depth 1 https://github.com/mikebgrep/fork.recipes.git
$ cd fork.recipes && git log -1 --format='%h %ad' --date=short
164e47d 2025-04-28
$ ls docker-compose* .env.example compose.sh
.env.example  compose.sh  docker-compose-postgres.yml  docker-compose-postgres-ssl.yml  docker-compose-sqlite.yml  docker-compose-sqlite-ssl.yml

$ cp .env.example .env && vi .env

DJANGO_SECRET=y5gyRi5fjHKCIKANN0I6TzE6R65WpMfj7YXEa9oXET9SQC3LpV
X_AUTH_HEADER=ced9106d-4f94-4754-b20d-0bdbf49b4fb2
SERVICE_BASE_URL=http://192.168.1.172:8148
EMAIL_HOST=
EMAIL_HOST_USER=
EMAIL_HOST_PASSWORD=
EMAIL_PORT=
EMAIL_USE_TLS=
DEPLOYMENT_TYPE=postgres
SEED_DEFAULT_DATA=true
DATABASE_URL=postgres://forkuser:q1w2e3r4@127.0.0.1:5434/forkrecipes
PAGINATION_PAGE_SIZE=20
CORS_ALLOWED_HOSTS=http://192.168.1.172,http://localhost
OPENAI_API_KEY=''
OPENAI_MODEL=gpt-4o-mini
OPEN_AI_TTS_MODEL_VOICE=coral

$ grep -n "listen" nginx/forkrecipes.nginx.conf
2:    listen 80;
33:    listen 81;

services:
  nginx:
    build:
      context: .
      dockerfile: nginx/Dockerfile
    image: nginx:fork-recipes
    container_name: nginx
    ports:
      - "8146:80"
      - "8148:81"
    env_file:
      - .env
    command: /bin/sh -c "nginx -g 'daemon off;'"
    volumes:
      - uwsgi_data:/tmp/uwsgi/
      - web_static:/forkapi/static/:ro
      - web_media:/forkapi/media/
      - web_static_fe:/fork_recipes/static/:ro
    depends_on:
      - web
      - be

  be:
    image: mikebgrep/forkapi:latest # change with mikebgrep/forkapi:arm64 for RaspberryPI
    container_name: forkapi
    hostname: forkapi-host
    env_file:
      - .env
    restart: always
    network_mode: "host"
    command: >
      sh -c "chmod +x /scripts/migration.sh && /scripts/migration.sh ${SEED_DEFAULT_DATA} & uwsgi --ini uwsgi.ini --chown-socket=www-data:www-data"
    volumes:
      - ./scripts:/scripts
      - uwsgi_data:/tmp/uwsgi/
      - web_media:/forkapi/media/
      - web_static:/forkapi/static/
    depends_on:
      - db

  db:
    image: postgres:17-alpine
    container_name: fork-recipes-db
    restart: always
    environment:
      POSTGRES_USER: forkuser
      POSTGRES_PASSWORD: q1w2e3r4
      POSTGRES_DB: forkrecipes
    volumes:
      - /opt/data/quzuo/tmp/fork-recipes/data/postgres:/var/lib/postgresql/data
    ports:
      - "127.0.0.1:5434:5432"

  web:
    build:
      context: .
      dockerfile: Dockerfile
    image: forkrecipes:latest
    container_name: recipes
    env_file:
      - .env
    restart: always
    network_mode: "host"
    command: >
      sh -c "uwsgi --ini uwsgi.ini --chown-socket=www-data:www-data"
    volumes:
      - data:/fork_recipes/sql/
      - uwsgi_data:/tmp/uwsgi/
      - web_static_fe:/fork_recipes/static/
    depends_on:
      - be

volumes:
  data:
  uwsgi_data:
  web_static:
  web_media:
  web_static_fe:

E: Package 'libpcre3-dev' has no installation candidate
Error: build failed: exit code: 100

$ grep -n "FROM" Dockerfile
4:FROM python:3.12-slim-bookworm

$ docker compose -f docker-compose-postgres.yml up -d
[+] Building 2/4: nginx:fork-recipes, forkrecipes:latest ...
 ✔ Image forkrecipes:latest     Built
 ✔ Container fork-recipes-db    Started
 ✔ Container forkapi            Started
 ✔ Container recipes            Started
 ✔ Container nginx              Started

$ docker compose -f docker-compose-postgres.yml ps --format '{{.Name}}\t{{.Service}}\t{{.State}}'
fork-recipes-db   db      running
forkapi           be      running
nginx             nginx   running
recipes           web     running

Migrations for 'recipe':
  recipe/migrations/0001_initial.py
Operations to perform:
  Apply all migrations: admin, auth, authentication, authtoken, backupper, contenttypes, recipe, schedule, sessions, shopping
Running migrations:
  Applying admin.0001_initial... OK
...
Admin user created: admin@example.com

$ curl -s -o /dev/null -w "%{http_code} -> %{redirect_url}\n" http://192.168.1.172:8146/
302 -> http://192.168.1.172:8146/login/?next=/
$ curl -s -c cookies.txt -o /dev/null -w "%{http_code}\n" http://192.168.1.172:8146/login/
200
$ curl -s -b cookies.txt -c cookies.txt -o /dev/null -w "%{http_code} -> %{redirect_url}\n" \
    -X POST http://192.168.1.172:8146/login/ \
    -d "csrfmiddlewaretoken=<cookies.txt中的csrftoken>&email=admin@example.com&password=ChangeMe" \
    -e http://192.168.1.172:8146/login/
302 -> http://192.168.1.172:8146/
$ curl -s -b cookies.txt http://192.168.1.172:8146/ -w "HTTP:%{http_code}\n" -o home.html
HTTP:200
$ grep -c "西红柿炒蛋" home.html   # 首页已渲染实测创建的食谱
1

$ curl -s -X POST http://192.168.1.172:8148/api/auth/token \
    -H "Content-Type: application/json" -H "X-Auth-Header: ced9106d-4f94-4754-b20d-0bdbf49b4fb2" \
    -d '{"email":"admin@example.com","password":"ChangeMe"}'
{"token":"59cfa1b255ba57535043e4b80fde7eeae393ce0d","user":{"username":"admin","email":"admin@example.com","is_superuser":true}}

$ curl -s http://192.168.1.172:8148/api/recipe/category -H "X-Auth-Header: ced9106d-4f94-4754-b20d-0bdbf49b4fb2"
[{"pk":1,"name":"Greek 🌮"},{"pk":2,"name":"Italian 🍝"},{"pk":3,"name":"Mexican 🌶️"},{"pk":4,"name":"中式"}]

$ curl -s -X POST http://192.168.1.172:8148/api/recipe/ \
    -H "Authorization: Token 59cfa1b255ba57535043e4b80fde7eeae393ce0d" \
    -H "X-Auth-Header: ced9106d-4f94-4754-b20d-0bdbf49b4fb2" \
    -F "name=西红柿炒蛋" -F "description=国民下饭菜" -F "servings=2" \
    -F "prep_time=5" -F "cook_time=10" -F "image=@tomato.png"
{"pk":1,"image":"http://192.168.1.172:8148/media/images/b3a050cf-911d-46de-b8fc-6faa8badc9ea_tomato.png","name":"西红柿炒蛋","servings":2,"chef":"admin","description":"国民下饭菜","category":null,"prep_time":5,"cook_time":10,"ingredients":[],"steps":[],"language":"English","is_original":true}
（输出节选：完整响应含 video/tag/total_time/difficulty/is_favorite/reference/is_translated/audio_instructions 等全部字段，实测共 24 键）
HTTP:201
$ curl -s -X POST http://192.168.1.172:8148/api/recipe/1/ingredients \
    -H "Authorization: Token 59cfa1b255ba57535043e4b80fde7eeae393ce0d" \
    -H "X-Auth-Header: ced9106d-4f94-4754-b20d-0bdbf49b4fb2" \
    -d '[{"name":"西红柿","quantity":"2个"},{"name":"鸡蛋","quantity":"3个"}]'   # 字段是 name/quantity
$ curl -s -X POST http://192.168.1.172:8148/api/recipe/1/steps \
    -H "Authorization: Token 59cfa1b255ba57535043e4b80fde7eeae393ce0d" \
    -H "X-Auth-Header: ced9106d-4f94-4754-b20d-0bdbf49b4fb2" \
    -d '[{"text":"鸡蛋加盐打散炒至凝固盛出"},{"text":"西红柿炒出汁水回锅翻匀"}]'   # 字段是 text
$ curl -s -X PATCH http://192.168.1.172:8148/api/recipe/1/category \
    -H "Authorization: Token 59cfa1b255ba57535043e4b80fde7eeae393ce0d" \
    -H "X-Auth-Header: ced9106d-4f94-4754-b20d-0bdbf49b4fb2" \
    -H "Content-Type: application/json" -d '{"category_pk":4}'

$ curl -s "http://192.168.1.172:8148/api/recipe/home/preview/?page=1" -H "X-Auth-Header: ced9106d-4f94-4754-b20d-0bdbf49b4fb2"
{"count":1,"next":null,"previous":null,"results":[{"pk":1,"image":"http://192.168.1.172:8148/media/images/b3a050cf-911d-46de-b8fc-6faa8badc9ea_tomato.png","name":"西红柿炒蛋","chef":"admin","servings":2,"total_time":"0.15","difficulty":null,"is_favorite":false}]}
$ curl -s "http://192.168.1.172:8148/api/recipe/1/" -H "X-Auth-Header: ced9106d-4f94-4754-b20d-0bdbf49b4fb2" | head -c 200
{"pk":1,"image":"http://192.168.1.172:8148/media/images/b3a050cf-911d-46de-b8fc-6faa8badc9ea_tomato.png","name":"西红柿炒蛋","servings":2,"chef":"admin","video":null,"description":"国民下饭菜","category":{"pk":4,"name":"中式"},"tag":null,"prep_time":5,"cook_time":10,
（输出节选（实测首尾）：head -c 200 截断，完整详情另含 total_time/ingredients/steps 等字段）

$ curl -s -X DELETE http://192.168.1.172:8148/api/recipe/2/ \
    -H "Authorization: Token 59cfa1b255ba57535043e4b80fde7eeae393ce0d" \
    -H "X-Auth-Header: ced9106d-4f94-4754-b20d-0bdbf49b4fb2" -w "HTTP:%{http_code}\n"
HTTP:204

$ curl -s -o /dev/null -w "HTTP:%{http_code} size:%{size_download}\n" http://127.0.0.1:8148/media/images/b3a050cf-911d-46de-b8fc-6faa8badc9ea_tomato.png
HTTP:200 size:70
$ curl -s -o /dev/null -w "HTTP:%{http_code} -> %{redirect_url}\n" http://192.168.1.172:8148/admin/
302 -> http://192.168.1.172:8148/login/?next=/admin/

$ docker exec fork-recipes-db psql -U forkuser -d forkrecipes -c "select count(*) from recipe_recipe;" -c "select count(*) from recipe_ingredient;" -c "select count(*) from recipe_category;"
 count
-------
     1
(1 row)
 count
-------
     2
(1 row)
 count
-------
     4
(1 row)

$ docker volume ls | grep forkrecipes
local     forkrecipes_data
local     forkrecipes_uwsgi_data
local     forkrecipes_web_media
local     forkrecipes_web_static
local     forkrecipes_web_static_fe

python manage.py makemigrations authentication
python manage.py makemigrations recipe
python manage.py makemigrations schedule
python manage.py makemigrations shopping
python manage.py makemigrations backupper
python manage.py migrate
python manage.py collectstatic --noinput
if [ "$1" == 'true' ]; then
    python manage.py seed_admin_user
    python manage.py seed_categories
fi

# 数据库
docker run -d --name fork-recipes-db --restart always \
  -e POSTGRES_USER=forkuser -e POSTGRES_PASSWORD=q1w2e3r4 -e POSTGRES_DB=forkrecipes \
  -v /opt/data/quzuo/tmp/fork-recipes/data/postgres:/var/lib/postgresql/data \
  -p 127.0.0.1:5434:5432 postgres:17-alpine

# 后端（host 网络，启动自带迁移）
docker run -d --name forkapi --restart always --network host \
  --env-file .env \
  -v $(pwd)/scripts:/scripts -v forkrecipes_uwsgi_data:/tmp/uwsgi/ \
  -v forkrecipes_web_media:/forkapi/media/ -v forkrecipes_web_static:/forkapi/static/ \
  mikebgrep/forkapi:latest \
  sh -c "chmod +x /scripts/migration.sh && /scripts/migration.sh ${SEED_DEFAULT_DATA} & uwsgi --ini uwsgi.ini --chown-socket=www-data:www-data"

# 前端（镜像需先 docker compose build web 产出）
docker run -d --name recipes --restart always --network host \
  --env-file .env \
  -v forkrecipes_data:/fork_recipes/sql/ -v forkrecipes_uwsgi_data:/tmp/uwsgi/ \
  -v forkrecipes_web_static_fe:/fork_recipes/static/ \
  forkrecipes:latest \
  sh -c "uwsgi --ini uwsgi.ini --chown-socket=www-data:www-data"

# 入口（镜像需先 build nginx）
docker run -d --name nginx --restart always \
  -p 8146:80 -p 8148:81 --env-file .env \
  -v forkrecipes_uwsgi_data:/tmp/uwsgi/ -v forkrecipes_web_static:/forkapi/static/:ro \
  -v forkrecipes_web_media:/forkapi/media/ -v forkrecipes_web_static_fe:/fork_recipes/static/:ro \
  nginx:fork-recipes

$ docker compose -f docker-compose-postgres.yml ps            # 服务状态
$ docker compose -f docker-compose-postgres.yml restart web   # 前端配置改动后重启（实测回显）
 Container recipes Restarting
 Container recipes Started
$ docker logs -f forkapi                                      # 后端日志（迁移/API 访问行）
$ docker logs -f recipes                                      # 前端日志
$ docker compose -f docker-compose-postgres.yml down          # 停止并删容器（卷与 PG 数据保留）
$ docker compose -f docker-compose-postgres.yml up -d         # 再拉起（幂等，迁移自动跳过已应用）