360_player

4 Commits 1 Branch 0 Tags

2 Commits

Include renames

Author	SHA1	Message	Date
JianMiauandClaude Opus 5	0a3c548e0b	移除 nginx 容器，改由 Node 直接終結 TLS，合併成單一容器摘要：拿掉 360-player-web（nginx）服務與 docker/nginx/，改在 server.js 用 node:https 直接提供 HTTPS，部署從兩個容器變成一個。根本原因：先前為了 TLS 而多開一個 nginx 容器。分開的主因是「憑證續期時能 reload 而不重啟 app」——重啟會殺掉正在跑的 ffmpeg 轉檔，一部 4K 360 影片動輒數小時。但 Node 的 https.Server 本來就有 setSecureContext()，可以熱換憑證不重啟行程，這個理由不成立，多一個容器只是多一層維護成本。影響： - 需維護額外的 nginx 映像檔與 entrypoint.sh - 影片經反向代理多一跳，且必須小心處理 proxy_buffering 與 SSE 逾時，設錯會讓 Range 串流被寫進暫存檔、或讓轉檔進度停止更新修法： - server.js 新增 TLS：讀取 SSL_CERT_DIR 的憑證，以 fs.watch 監看該資料夾，檔案變動時 debounce 1 秒後呼叫 setSecureContext() 熱套用 - 中介憑證串進 cert 而非 ca：Node 只送出 cert 的內容，ca 是驗證對方用的信任庫、不會送給瀏覽器，放錯會導致憑證鏈不完整 - 串接前正規化 PEM（去 CRLF、補結尾換行），沿用原 nginx entrypoint 的處理 - config.json 新增 httpsPort（預設 0 = 停用）與 certDir，本機開發不需憑證；憑證讀不到時退回只提供 HTTP 並印警告，不讓服務起不來 - docker-compose.yml 併回單一服務，憑證改掛 /certs；Dockerfile 補上 HTTPS_PORT、SSL_CERT_DIR，EXPOSE 改為 8443 - 刪除 docker/nginx/ 驗證（實機執行，非僅靜態檢查）： - 以 SSL_CERT_DIR=/volume1/docker/certs 啟動，log 顯示「HTTPS：jianmiau.tk — 14 天後到期」，https 的 /api/config 回 200 - openssl s_client 確認送出完整三層憑證鏈（jianmiau.tk → Let's Encrypt YR2 → ISRG Root YR） - HTTPS 上的 Range 請求正常：檔頭與中段各取一段皆回 206 且長度正確 - 熱換測試：換上 CN=hotswap-test.local 的自簽憑證後，log 出現「憑證已重新載入」，s_client 讀到新 CN，且行程 PID 與啟動時間不變 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>	2026-08-21 15:09:56 +08:00
JianMiauandClaude Opus 5	2a9e59357e	初始化 360 全景影片播放器專案並完成 NAS 部署設定摘要：將本機開發的 360° 全景影片播放器納入版控，同時把執行環境從 Windows 切換到 Synology NAS，改以 Docker 部署。根本原因：專案原本只在有 NVIDIA 顯卡的 Windows 機器上跑，config.json 寫死了 Windows 磁碟機路徑 W:/photo/Badminton，NAS 上無法直接啟動。另外 DSM 內建的 ffmpeg 拿掉了 VAAPI 編碼器，裸跑只能走 libx264， Celeron J4025 雙核轉 4K 360 影片的速度無法接受。影響： - 在 NAS 上 npm start 會因為找不到影片資料夾而列不出任何影片 - 即使把路徑改對，轉檔仍只能用 CPU，82 分鐘的 4K 360 影片要跑十幾小時修法： - config.json 的 videoDir 改為 NAS 實際路徑 /volume1/photo/Badminton - docker-compose.yml 啟用 devices: /dev/dri，讓容器取得 Intel UHD 600 的 render node；容器內 Alpine 版 ffmpeg 保有完整 VAAPI 支援，啟動時會自動偵測成 vaapi 模式，並保留 libx264 當備援 - .env（不進版控）提供 VIDEO_DIR / CACHE_DIR 等 NAS 路徑給 compose 使用驗證：容器啟動 log 顯示「轉檔引擎：VAAPI 硬體編碼（Intel/AMD，/dev/dri）」， /api/config 回傳 modes: ["vaapi","cpu"]，/api/videos 正確辨識來源影片為 3840x1920 equirectangular。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>	2026-08-21 10:57:17 +08:00

Author

SHA1

Message

Date

JianMiauandClaude Opus 5

0a3c548e0b

移除 nginx 容器，改由 Node 直接終結 TLS，合併成單一容器

摘要：
拿掉 360-player-web（nginx）服務與 docker/nginx/，改在 server.js 用
node:https 直接提供 HTTPS，部署從兩個容器變成一個。

根本原因：
先前為了 TLS 而多開一個 nginx 容器。分開的主因是「憑證續期時能 reload
而不重啟 app」——重啟會殺掉正在跑的 ffmpeg 轉檔，一部 4K 360 影片動輒數小時。
但 Node 的 https.Server 本來就有 setSecureContext()，可以熱換憑證不重啟行程，
這個理由不成立，多一個容器只是多一層維護成本。

影響：
- 需維護額外的 nginx 映像檔與 entrypoint.sh
- 影片經反向代理多一跳，且必須小心處理 proxy_buffering 與 SSE 逾時，
  設錯會讓 Range 串流被寫進暫存檔、或讓轉檔進度停止更新

修法：
- server.js 新增 TLS：讀取 SSL_CERT_DIR 的憑證，以 fs.watch 監看該資料夾，
  檔案變動時 debounce 1 秒後呼叫 setSecureContext() 熱套用
- 中介憑證串進 cert 而非 ca：Node 只送出 cert 的內容，ca 是驗證對方用的
  信任庫、不會送給瀏覽器，放錯會導致憑證鏈不完整
- 串接前正規化 PEM（去 CRLF、補結尾換行），沿用原 nginx entrypoint 的處理
- config.json 新增 httpsPort（預設 0 = 停用）與 certDir，本機開發不需憑證；
  憑證讀不到時退回只提供 HTTP 並印警告，不讓服務起不來
- docker-compose.yml 併回單一服務，憑證改掛 /certs；Dockerfile 補上
  HTTPS_PORT、SSL_CERT_DIR，EXPOSE 改為 8443
- 刪除 docker/nginx/

驗證（實機執行，非僅靜態檢查）：
- 以 SSL_CERT_DIR=/volume1/docker/certs 啟動，log 顯示
  「HTTPS：jianmiau.tk — 14 天後到期」，https 的 /api/config 回 200
- openssl s_client 確認送出完整三層憑證鏈
  （jianmiau.tk → Let's Encrypt YR2 → ISRG Root YR）
- HTTPS 上的 Range 請求正常：檔頭與中段各取一段皆回 206 且長度正確
- 熱換測試：換上 CN=hotswap-test.local 的自簽憑證後，log 出現
  「憑證已重新載入」，s_client 讀到新 CN，且行程 PID 與啟動時間不變

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

2026-08-21 15:09:56 +08:00

JianMiauandClaude Opus 5

2a9e59357e

初始化 360 全景影片播放器專案並完成 NAS 部署設定

摘要：
將本機開發的 360° 全景影片播放器納入版控，同時把執行環境從 Windows
切換到 Synology NAS，改以 Docker 部署。

根本原因：
專案原本只在有 NVIDIA 顯卡的 Windows 機器上跑，config.json 寫死了
Windows 磁碟機路徑 W:/photo/Badminton，NAS 上無法直接啟動。
另外 DSM 內建的 ffmpeg 拿掉了 VAAPI 編碼器，裸跑只能走 libx264，
Celeron J4025 雙核轉 4K 360 影片的速度無法接受。

影響：
- 在 NAS 上 npm start 會因為找不到影片資料夾而列不出任何影片
- 即使把路徑改對，轉檔仍只能用 CPU，82 分鐘的 4K 360 影片要跑十幾小時

修法：
- config.json 的 videoDir 改為 NAS 實際路徑 /volume1/photo/Badminton
- docker-compose.yml 啟用 devices: /dev/dri，讓容器取得 Intel UHD 600
  的 render node；容器內 Alpine 版 ffmpeg 保有完整 VAAPI 支援，啟動時
  會自動偵測成 vaapi 模式，並保留 libx264 當備援
- .env（不進版控）提供 VIDEO_DIR / CACHE_DIR 等 NAS 路徑給 compose 使用

驗證：
容器啟動 log 顯示「轉檔引擎：VAAPI 硬體編碼（Intel/AMD，/dev/dri）」，
/api/config 回傳 modes: ["vaapi","cpu"]，/api/videos 正確辨識來源影片為
3840x1920 equirectangular。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

2026-08-21 10:57:17 +08:00