[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7AYYNKP61CN2281VMJDXMB5":3,"skill-same:01M7AYYNKP61CN2281VMJDXMB5":53},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M7AYYNKP61CN2281VMJDXMB5","nginx-streaming-proxy",null,"Configure nginx for streaming endpoints (SSE, MCP, WS).","oat431\u002Fhermes_config_backup","oat431","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F54722120?v=4","01M7AYD07EH8SYPMYY8CGZKS22","Oralita","01M7AYD0816QDF77E3TWCRSQC9",1,"Unlicense","https:\u002F\u002Fgithub.com\u002Foat431\u002Fhermes_config_backup\u002Fblob\u002Fmain\u002Fworkflow\u002Fui-ux\u002Fnginx-streaming-proxy\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: nginx-streaming-proxy\ndescription: Configure nginx for streaming endpoints (SSE, MCP, WS).\n---\n\n# Nginx Reverse Proxy for Streaming Endpoints\n\n## When to use\n- Long-lived HTTP streams (SSE, streamable MCP, event streams) that stall, drop after ~60s, or deliver events in bursts\n- WebSocket endpoints that fail behind a new nginx location\n- Any symptom of \"the stream connects but nothing flows\" through a reverse proxy\n\n## Defaults that break streaming (memorize)\n\n| nginx default | What it does to a stream |\n|---|---|\n| `proxy_buffering on` | Buffers the upstream response; SSE events sit in the buffer instead of flushing to the client |\n| `proxy_read_timeout 60s` | Kills the upstream connection after 60s of silence |\n| `proxy_http_version 1.0` | Connection-close semantics; breaks chunked\u002Flong-lived streams |\n| gzip (if enabled globally) | Can delay or re-chunk event streams |\n\n## The fix — dedicated location block\n\nCopy `templates\u002Fstreaming-location.conf` and adapt the upstream. Essential lines:\n\n```nginx\nlocation \u002Fstream-or-sse-path\u002F {\n    proxy_pass http:\u002F\u002Fupstream;\n    proxy_http_version 1.1;\n    proxy_set_header Connection \"\";\n\n    proxy_buffering off;          # critical: flush events immediately\n    proxy_cache off;\n    chunked_transfer_encoding on;\n    proxy_read_timeout 1d;        # keep the stream alive\n    proxy_send_timeout 1d;\n    proxy_connect_timeout 10s;\n    gzip off;\n}\n```\n\n## WebSocket variant\n\nAdd these two headers (and long timeouts still help):\n```nginx\nproxy_set_header Upgrade $http_upgrade;\nproxy_set_header Connection \"upgrade\";\n```\n\n## Verification\n\n1. `sudo nginx -t && sudo systemctl reload nginx`\n2. `curl -s -o \u002Fdev\u002Fnull -w '%{http_code} %{time_total}s\\n' -N https:\u002F\u002Fhost\u002Fpath`\n   — a fast response means the endpoint is alive. HTTP 406 for a dummy token on an\n   authenticated stream endpoint is a *correct rejection*, not a failure.\n3. `sudo tail \u002Fvar\u002Flog\u002Fnginx\u002Ferror.log` — `upstream timed out (110) while reading\n   response header` on the stream path = the 60s timeout default is still in effect.\n4. WebSocket endpoint liveness: send an upgrade handshake and look for **101** —\n   `curl -s -o \u002Fdev\u002Fnull -w '%{http_code}\\n' -H 'Connection: Upgrade' -H 'Upgrade: websocket' -H 'Sec-WebSocket-Version: 13' -H 'Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==' http:\u002F\u002Fhost\u002Fws-path`\n   (curl may exit non-zero because the server closes the unauthenticated socket — the `101`\n   line in the output is the signal, ignore the exit code).\n\n## Every hop in the chain matters\n\nWhen the app runs in Docker behind host nginx (typical: host nginx → container nginx → app),\n**both** proxy hops need the streaming settings. Host-level `proxy_buffering off` is useless\nif the container's own nginx still buffers the internal hop.\n\n## Container nginx configs baked into images\n\nOfficial images (e.g. penpot frontend) bake override files into the image; in-container\nedits die on container recreate. Durable pattern:\n\n1. Copy the baked file content to the compose project dir (e.g. `.\u002Fnginx\u002F\u003Cfile>.conf`)\n2. Add the streaming directives\n3. Bind-mount over the baked path in docker-compose:\n   `- .\u002Fnginx\u002F\u003Cfile>.conf:\u002Fetc\u002Fnginx\u002Foverrides\u002F...\u002F\u003Cfile>.conf:ro`\n4. `docker compose up -d \u003Cservice>`, then verify the mount inside the container\n   (`docker exec \u003Cc> grep -c proxy_buffering \u003Cpath>` + `nginx -t`)\n\n## Pitfalls\n\n- Editing only the host config when the container hop also buffers → still broken. Check both.\n- `proxy_read_timeout` values are per-hop; set them on every hop.\n- Patching docker-compose with a shared volume pattern (e.g. `penpot_assets:\u002Fopt\u002Fdata\u002Fassets`\n  appearing in multiple services) — anchor the replacement to the *service block*, not the\n  volume line alone, or the patch hits the wrong service.\n\n## Related\n\n- `penpot-mcp` — worked example: MCP stream behind two nginx hops (host + container)\n","# Nginx Reverse Proxy for Streaming Endpoints\n\n## When to use\n- Long-lived HTTP streams (SSE, streamable MCP, event streams) that stall, drop after ~60s, or deliver events in bursts\n- WebSocket endpoints that fail behind a new nginx location\n- Any symptom of \"the stream connects but nothing flows\" through a reverse proxy\n\n## Defaults that break streaming (memorize)\n\n| nginx default | What it does to a stream |\n|---|---|\n| `proxy_buffering on` | Buffers the upstream response; SSE events sit in the buffer instead of flushing to the client |\n| `proxy_read_timeout 60s` | Kills the upstream connection after 60s of silence |\n| `proxy_http_version 1.0` | Connection-close semantics; breaks chunked\u002Flong-lived streams |\n| gzip (if enabled globally) | Can delay or re-chunk event streams |\n\n## The fix — dedicated location block\n\nCopy `templates\u002Fstreaming-location.conf` and adapt the upstream. Essential lines:\n\n```nginx\nlocation \u002Fstream-or-sse-path\u002F {\n    proxy_pass http:\u002F\u002Fupstream;\n    proxy_http_version 1.1;\n    proxy_set_header Connection \"\";\n\n    proxy_buffering off;          # critical: flush events immediately\n    proxy_cache off;\n    chunked_transfer_encoding on;\n    proxy_read_timeout 1d;        # keep the stream alive\n    proxy_send_timeout 1d;\n    proxy_connect_timeout 10s;\n    gzip off;\n}\n```\n\n## WebSocket variant\n\nAdd these two headers (and long timeouts still help):\n```nginx\nproxy_set_header Upgrade $http_upgrade;\nproxy_set_header Connection \"upgrade\";\n```\n\n## Verification\n\n1. `sudo nginx -t && sudo systemctl reload nginx`\n2. `curl -s -o \u002Fdev\u002Fnull -w '%{http_code} %{time_total}s\\n' -N https:\u002F\u002Fhost\u002Fpath`\n   — a fast response means the endpoint is alive. HTTP 406 for a dummy token on an\n   authenticated stream endpoint is a *correct rejection*, not a failure.\n3. `sudo tail \u002Fvar\u002Flog\u002Fnginx\u002Ferror.log` — `upstream timed out (110) while reading\n   response header` on the stream path = the 60s timeout default is still in effect.\n4. WebSocket endpoint liveness: send an upgrade handshake and look for **101** —\n   `curl -s -o \u002Fdev\u002Fnull -w '%{http_code}\\n' -H 'Connection: Upgrade' -H 'Upgrade: websocket' -H 'Sec-WebSocket-Version: 13' -H 'Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==' http:\u002F\u002Fhost\u002Fws-path`\n   (curl may exit non-zero because the server closes the unauthenticated socket — the `101`\n   line in the output is the signal, ignore the exit code).\n\n## Every hop in the chain matters\n\nWhen the app runs in Docker behind host nginx (typical: host nginx → container nginx → app),\n**both** proxy hops need the streaming settings. Host-level `proxy_buffering off` is useless\nif the container's own nginx still buffers the internal hop.\n\n## Container nginx configs baked into images\n\nOfficial images (e.g. penpot frontend) bake override files into the image; in-container\nedits die on container recreate. Durable pattern:\n\n1. Copy the baked file content to the compose project dir (e.g. `.\u002Fnginx\u002F\u003Cfile>.conf`)\n2. Add the streaming directives\n3. Bind-mount over the baked path in docker-compose:\n   `- .\u002Fnginx\u002F\u003Cfile>.conf:\u002Fetc\u002Fnginx\u002Foverrides\u002F...\u002F\u003Cfile>.conf:ro`\n4. `docker compose up -d \u003Cservice>`, then verify the mount inside the container\n   (`docker exec \u003Cc> grep -c proxy_buffering \u003Cpath>` + `nginx -t`)\n\n## Pitfalls\n\n- Editing only the host config when the container hop also buffers → still broken. Check both.\n- `proxy_read_timeout` values are per-hop; set them on every hop.\n- Patching docker-compose with a shared volume pattern (e.g. `penpot_assets:\u002Fopt\u002Fdata\u002Fassets`\n  appearing in multiple services) — anchor the replacement to the *service block*, not the\n  volume line alone, or the patch hits the wrong service.\n\n## Related\n\n- `penpot-mcp` — worked example: MCP stream behind two nginx hops (host + container)\n",{"name":5,"description":7},"main","2988869c5a7d7be2225c9ea7a54a4a56a59b0d45","workflow\u002Fui-ux\u002Fnginx-streaming-proxy",0,"https:\u002F\u002Fgithub.com\u002Foat431\u002Fhermes_config_backup","https:\u002F\u002Fgithub.com\u002Foat431","https:\u002F\u002Fpanomete.com\u002F","Hope and Luck is not a part of the strategy, \r\n\r\nSoftskill produces plan Hard skill produce product.","2026-11-03 00:43:08",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add oat431\u002Fhermes_config_backup --skill nginx-streaming-proxy",{"tool":39,"command":40},"bunx","bunx skills add oat431\u002Fhermes_config_backup --skill nginx-streaming-proxy",{"tool":42,"command":43},"pnpm","pnpm dlx skills add oat431\u002Fhermes_config_backup --skill nginx-streaming-proxy","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Foat431\u002Fhermes_config_backup\u002Fblob\u002Fmain\u002Fworkflow\u002Fui-ux\u002Fnginx-streaming-proxy\u002FSKILL.md",true,[47],{"path":48,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":51,"sourceHtmlUrl":52},"templates\u002Fstreaming-location.conf","OTHER","其他",970,"https:\u002F\u002Fgithub.com\u002Foat431\u002Fhermes_config_backup\u002Fblob\u002Fmain\u002Fworkflow\u002Fui-ux\u002Fnginx-streaming-proxy\u002Ftemplates\u002Fstreaming-location.conf",[54,62,69,76,83,90],{"skillNo":55,"name":56,"nameZh":6,"description":57,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":58,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":19},"01M7AYZ2JY3NFKAPQSC39N5F3F","project-spec-docs","Fill\u002Fupdate project_spec docs (templates, MM handoffs).","MIT","https:\u002F\u002Fgithub.com\u002Foat431\u002Fhermes_config_backup\u002Fblob\u002Fmain\u002Fworkflow\u002Fui-ux\u002Fproject-spec-docs\u002FSKILL.md",[],[],{"skillNo":63,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":58,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":19},"01M7AYYRZPE7HQX7778558X52S","penpot-mcp","Penpot MCP: connect, verify, and fix streaming via nginx.","https:\u002F\u002Fgithub.com\u002Foat431\u002Fhermes_config_backup\u002Fblob\u002Fmain\u002Fworkflow\u002Fui-ux\u002Fpenpot-mcp\u002FSKILL.md",[],[],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":58,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":19},"01M7AYYJP0MDV1D3WVEEZB3SGA","branding-ci","Use for brand\u002FCI identity, style guides, and brand docs.","https:\u002F\u002Fgithub.com\u002Foat431\u002Fhermes_config_backup\u002Fblob\u002Fmain\u002Fworkflow\u002Fui-ux\u002Fbranding-ci\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":19},"01M7AYYGCXVT97DDTCM0ZJT6F6","yuanbao","Yuanbao (元宝) groups: @mention users, query info\u002Fmembers.","https:\u002F\u002Fgithub.com\u002Foat431\u002Fhermes_config_backup\u002Fblob\u002Fmain\u002Fworkflow\u002Fshared-skills\u002Fyuanbao\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":19},"01M7AYYC2Y65NMGMD4GQXAZMMS","slidev","Create and present web-based slidedecks for developers using Slidev with Markdown, Vue components, code highlighting, animations, and interactive features. Use when building technical presentations, conference talks, code walkthroughs, teaching materials, or developer decks.","https:\u002F\u002Fgithub.com\u002Foat431\u002Fhermes_config_backup\u002Fblob\u002Fmain\u002Fworkflow\u002Fshared-skills\u002Fslidev\u002FSKILL.md",[],[],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":19},"01M7AYY90HRDNVZYM4E7A9RGBQ","obsidian-vault-maintenance","Detect and fix broken wikilinks, add YAML frontmatter tags, and run batch maintenance on Obsidian vaults.","https:\u002F\u002Fgithub.com\u002Foat431\u002Fhermes_config_backup\u002Fblob\u002Fmain\u002Fworkflow\u002Fshared-skills\u002Fobsidian-vault-maintenance\u002FSKILL.md",[],[]]