Upload 10 files

.dockerignore

@@ -0,0 +1,7 @@
+.git/
+.env
+*.log
+__pycache__/
+.browser.htpasswd
+chromium-profile/
+browser-data/

Dockerfile

@@ -1,34 +1,49 @@
-FROM debian:bullseye-slim
-
-# 1. 安裝核心組件 (增加 dbus-x11 減少錯誤)
-RUN apt-get update && apt-get install -y \
-    chromium \
-    xvfb \
-    x11vnc \
-    novnc \
-    openbox \
-    python3-websockify \
-    dbus-x11 \
+# syntax=docker/dockerfile:1.7
+
+FROM debian:bookworm-slim
+
+ARG DEBIAN_FRONTEND=noninteractive
+
+ENV DISPLAY=:99 \
+    HOME=/home/user \
+    BROWSER_WIDTH=1920 \
+    BROWSER_HEIGHT=1080 \
+    START_URL=https://arena.ai/text/direct
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+        apache2-utils \
+        ca-certificates \
+        chromium \
+        dbus-x11 \
+        fonts-liberation \
+        fonts-noto-cjk \
+        fonts-noto-color-emoji \
+        nginx \
+        novnc \
+        openbox \
+        supervisor \
+        tini \
+        websockify \
+        x11-utils \
+        x11vnc \
+        xvfb \
     && rm -rf /var/lib/apt/lists/*
 
-# 2. 【關鍵：強行修正 X11 權限】
-# 在切換使用者前，先建立好 X11 需要的資料夾並開放權限
-RUN mkdir -p /tmp/.X11-unix && chmod 1777 /tmp/.X11-unix
+RUN useradd --create-home --uid 1000 --shell /bin/bash user \
+    && mkdir -p /home/user/app /home/user/nginx /home/user/browser-data \
+    && chown -R user:user /home/user/app /home/user/nginx /home/user/browser-data
+
+WORKDIR /home/user/app
+
+COPY --chown=user:user nginx.conf supervisord.conf start.sh ./
+COPY --chown=user:user scripts ./scripts
+COPY --chown=user:user README.md ./README.md
+
+RUN chmod 0755 /home/user/app/start.sh /home/user/app/scripts/*.sh
 
-# 3. 設定全域變數 (這樣 Chromium 絕對不會找不到 DISPLAY)
-ENV DISPLAY=:1
-ENV HOME=/home/user
-RUN useradd -m -u 1000 user
 USER user
-WORKDIR /home/user
 
 EXPOSE 7860
 
-# 4. 啟動指令：增加 -nolisten tcp 減少權限報錯，並確保執行順序
-CMD Xvfb :1 -screen 0 1280x800x16 -nolisten tcp & \
-    sleep 3 && \
-    openbox & \
-    x11vnc -display :1 -nopw -forever -shared -rfbport 5900 & \
-    /usr/share/novnc/utils/launch.sh --vnc localhost:5900 --listen 7860 & \
-    sleep 3 && \
-    chromium --no-sandbox --disable-gpu --disable-dev-shm-usage --start-maximized --no-first-run
+ENTRYPOINT ["/usr/bin/tini", "--"]
+CMD ["/home/user/app/start.sh"]

README.md

@@ -1,10 +1,207 @@
 ---
-title: Broswer
-emoji: 🌍
-colorFrom: blue
-colorTo: green
+title: Private Manual Browser
+emoji: 🖥️
+colorFrom: gray
+colorTo: blue
 sdk: docker
+app_port: 7860
 pinned: false
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# Private Manual Browser — Hugging Face Docker Space
+
+這是一個只供帳號本人操作的瀏覽器 Space：
+
+```text
+Chromium → Xvfb → x11vnc → websockify/noVNC → Nginx :7860
+```
+
+用途是讓使用者透過瀏覽器開啟 Hugging Face Space，手動操作遠端 Chromium。它不會自動解 CAPTCHA、不會自動接受條款，也不包含 OpenAI API Bridge。
+
+## 必要 Secrets
+
+在 **Space → Settings → Variables and secrets → Secrets** 建立：
+
+| Secret | 說明 |
+|---|---|
+| `BROWSER_USERNAME` | noVNC 網頁的 HTTP Basic Auth 使用者名稱。 |
+| `BROWSER_PASSWORD` | 強隨機密碼，建議至少 24 個字元。 |
+
+產生密碼：
+
+```bash
+python -c "import secrets; print(secrets.token_urlsafe(32))"
+```
+
+不要把 Google、Arena 或其他網站密碼設定為 `BROWSER_PASSWORD`。
+
+## 建議 Variables
+
+| Variable | 預設值 | 說明 |
+|---|---:|---|
+| `BROWSER_WIDTH` | `1920` | 虛擬桌面寬度，640–3840。 |
+| `BROWSER_HEIGHT` | `1080` | 虛擬桌面高度，640–2160。 |
+| `START_URL` | `https://arena.ai/text/direct` | Chromium 啟動頁面。 |
+
+資源較少時可使用：
+
+```text
+BROWSER_WIDTH=1366
+BROWSER_HEIGHT=768
+```
+
+## 部署
+
+Space repository 根目錄：
+
+```text
+Dockerfile
+README.md
+nginx.conf
+supervisord.conf
+start.sh
+scripts/
+  launch-browser.sh
+  launch-nginx.sh
+  launch-openbox.sh
+  launch-x11vnc.sh
+```
+
+建立 Docker Space、上傳檔案、設定兩個必要 Secrets，然後 Factory Rebuild。
+
+## 開啟瀏覽器
+
+造訪 Space 的直接網址：
+
+```text
+https://YOUR-SPACE.hf.space/
+```
+
+瀏覽器會要求 HTTP Basic Auth：
+
+```text
+Username: BROWSER_USERNAME
+Password: BROWSER_PASSWORD
+```
+
+成功後會進入 noVNC，並自動連接遠端桌面。可使用 noVNC 左側控制列調整縮放、全螢幕及剪貼簿。
+
+## 持久化 Chrome Profile
+
+如果 Space 已附加 Hugging Face Persistent Storage，程式會使用：
+
+```text
+/data/manual-browser/chromium-profile
+```
+
+其中包含：
+
+- Cookies
+- Local Storage
+- 登入 Session
+- 瀏覽器設定
+- 網站權限
+- 歷史紀錄
+
+如果 `/data` 不存在，會改用：
+
+```text
+/home/user/browser-data/chromium-profile
+```
+
+並在 Logs 顯示 profile 是暫存的；容器重啟後可能遺失。
+
+## 安全要求
+
+1. **強烈建議使用 Private Space。** Basic Auth 是第二層保護，不應取代 Hugging Face 存取控制。
+2. 使用獨立、強隨機的 `BROWSER_PASSWORD`。
+3. 不要分享 Space URL 或密碼。
+4. `/data` 內的 Chromium profile 等同登入憑證，不能公開或下載分享。
+5. 不要在多人共用 Space 中登入私人 Google 帳號。
+6. 不使用時應 Pause Space；需要撤銷所有 Session 時，刪除 `/data/manual-browser/chromium-profile`。
+7. `x11vnc` 與 `websockify` 只監聽容器內的 `127.0.0.1`，外部只能經過 Nginx Basic Auth。
+8. Chromium 在容器中使用 `--no-sandbox`，因此只能在受控的 Private Space 中操作可信網站。
+
+## Google 登入
+
+這是由使用者本人操作的可見 Chromium，不是自動輸入帳密的腳本。但 Google 仍可能因資料中心 IP、新裝置、Chromium 環境或帳號政策要求：
+
+- MFA／2FA
+- 裝置確認
+- CAPTCHA
+- 拒絕登入
+
+請由帳號本人處理；本專案不會繞過 Google 安全驗證。如果 Google 拒絕此環境，請改用自己電腦的一般 Chrome 建立 Arena Storage State。
+
+## Health Check
+
+不需認證的程序存活端點：
+
+```text
+https://YOUR-SPACE.hf.space/healthz
+```
+
+回傳：
+
+```json
+{"status":"alive"}
+```
+
+它只表示 Nginx 存活，不代表 Chromium 已登入任何網站。
+
+## Cronitor
+
+可監控：
+
+```text
+GET https://YOUR-SPACE.hf.space/healthz
+```
+
+Assertions：
+
+```text
+response.code = 200
+response.body contains "alive"
+```
+
+監控請求可能喚醒 Space，但不能保證 Hugging Face 免費 Space 永不休眠。
+
+## 常見問題
+
+### 401 Unauthorized
+
+確認 `BROWSER_USERNAME`、`BROWSER_PASSWORD` 是 Secrets，修改後 Restart／Factory Rebuild。
+
+### 黑畫面
+
+等待 10–20 秒後重新整理；檢查 Logs 中 Xvfb、Openbox、Chromium、x11vnc 是否都進入 RUNNING。
+
+### noVNC 顯示 WebSocket disconnected
+
+確認 Nginx、websockify、x11vnc 都在運行，並使用根網址自動產生的 `path=websockify`。
+
+### 重啟後登出
+
+確認 Space 已附加 Persistent Storage，Logs 應顯示：
+
+```text
+Browser profile: persistent /data/manual-browser/chromium-profile
+```
+
+### 清除所有登入狀態
+
+在 Space 停止後刪除：
+
+```text
+/data/manual-browser/chromium-profile
+```
+
+再重新啟動。這會登出所有網站並清除瀏覽器資料。
+
+## 限��
+
+- 這是互動式遠端瀏覽器，不是高效能桌面。
+- 音訊、視訊、WebGL 與硬體加速可能受限。
+- 免費 Space 可能休眠。
+- Persistent Storage 需要 Hugging Face 支援的儲存方案。
+- 本專案不會自動化 CAPTCHA、MFA、OAuth 或法律條款同意。

nginx.conf

@@ -0,0 +1,62 @@
+worker_processes 1;
+pid /tmp/nginx.pid;
+error_log /dev/stderr info;
+
+events {
+    worker_connections 512;
+}
+
+http {
+    include /etc/nginx/mime.types;
+    default_type application/octet-stream;
+    access_log /dev/stdout;
+    sendfile on;
+    keepalive_timeout 65;
+
+    client_body_temp_path /tmp/nginx-client;
+    proxy_temp_path /tmp/nginx-proxy;
+
+    map $http_upgrade $connection_upgrade {
+        default upgrade;
+        '' close;
+    }
+
+    server {
+        listen 7860;
+        server_name _;
+        server_tokens off;
+
+        auth_basic "Private browser";
+        auth_basic_user_file /home/user/.browser.htpasswd;
+
+        add_header X-Content-Type-Options nosniff always;
+        add_header Referrer-Policy no-referrer always;
+        add_header Cache-Control "no-store" always;
+
+        location = /healthz {
+            auth_basic off;
+            default_type application/json;
+            return 200 '{"status":"alive"}';
+        }
+
+        location = / {
+            return 302 /vnc.html?autoconnect=true&resize=scale&path=websockify;
+        }
+
+        location = /websockify {
+            proxy_pass http://127.0.0.1:6080;
+            proxy_http_version 1.1;
+            proxy_set_header Upgrade $http_upgrade;
+            proxy_set_header Connection $connection_upgrade;
+            proxy_set_header Host $host;
+            proxy_read_timeout 86400s;
+            proxy_send_timeout 86400s;
+            proxy_buffering off;
+        }
+
+        location / {
+            root /usr/share/novnc;
+            try_files $uri $uri/ =404;
+        }
+    }
+}

scripts/launch-browser.sh

@@ -0,0 +1,16 @@
+#!/bin/sh
+set -eu
+until xdpyinfo -display "${DISPLAY:-:99}" >/dev/null 2>&1; do
+  sleep 0.25
+done
+
+exec /usr/bin/chromium \
+  --no-sandbox \
+  --disable-dev-shm-usage \
+  --no-first-run \
+  --no-default-browser-check \
+  --password-store=basic \
+  --user-data-dir="${BROWSER_PROFILE}" \
+  --window-size="${BROWSER_WIDTH},${BROWSER_HEIGHT}" \
+  --start-maximized \
+  "${START_URL}"

scripts/launch-nginx.sh

@@ -0,0 +1,7 @@
+#!/bin/sh
+set -eu
+mkdir -p /tmp/nginx-client /tmp/nginx-proxy
+exec /usr/sbin/nginx \
+  -p /home/user/nginx \
+  -c /home/user/app/nginx.conf \
+  -g 'daemon off;'

scripts/launch-openbox.sh

@@ -0,0 +1,6 @@
+#!/bin/sh
+set -eu
+until xdpyinfo -display "${DISPLAY:-:99}" >/dev/null 2>&1; do
+  sleep 0.25
+done
+exec openbox-session

scripts/launch-x11vnc.sh

@@ -0,0 +1,14 @@
+#!/bin/sh
+set -eu
+until xdpyinfo -display "${DISPLAY:-:99}" >/dev/null 2>&1; do
+  sleep 0.25
+done
+exec /usr/bin/x11vnc \
+  -display "${DISPLAY:-:99}" \
+  -localhost \
+  -nopw \
+  -forever \
+  -shared \
+  -repeat \
+  -noxdamage \
+  -rfbport 5900

start.sh

@@ -0,0 +1,50 @@
+#!/bin/sh
+set -eu
+
+: "${BROWSER_USERNAME:?Set BROWSER_USERNAME as a Hugging Face Space Secret}"
+: "${BROWSER_PASSWORD:?Set BROWSER_PASSWORD as a Hugging Face Space Secret}"
+
+case "${BROWSER_WIDTH:-1920}" in
+  ''|*[!0-9]*) echo "BROWSER_WIDTH must be numeric" >&2; exit 64 ;;
+esac
+case "${BROWSER_HEIGHT:-1080}" in
+  ''|*[!0-9]*) echo "BROWSER_HEIGHT must be numeric" >&2; exit 64 ;;
+esac
+
+if [ "${BROWSER_WIDTH}" -lt 640 ] || [ "${BROWSER_WIDTH}" -gt 3840 ]; then
+  echo "BROWSER_WIDTH must be between 640 and 3840" >&2
+  exit 64
+fi
+if [ "${BROWSER_HEIGHT}" -lt 640 ] || [ "${BROWSER_HEIGHT}" -gt 2160 ]; then
+  echo "BROWSER_HEIGHT must be between 640 and 2160" >&2
+  exit 64
+fi
+
+# Use paid Hugging Face persistent storage when /data is writable; otherwise
+# fall back to ephemeral container storage and warn clearly.
+if [ -d /data ] && [ -w /data ]; then
+  BROWSER_PROFILE=/data/manual-browser/chromium-profile
+  mkdir -p /data/manual-browser "$BROWSER_PROFILE"
+  chmod 700 /data/manual-browser "$BROWSER_PROFILE" 2>/dev/null || true
+  echo "Browser profile: persistent /data/manual-browser/chromium-profile"
+else
+  BROWSER_PROFILE=/home/user/browser-data/chromium-profile
+  mkdir -p "$BROWSER_PROFILE"
+  chmod 700 "$BROWSER_PROFILE"
+  echo "WARNING: /data is unavailable; browser profile is ephemeral."
+fi
+
+export BROWSER_PROFILE
+export START_URL="${START_URL:-https://arena.ai/text/direct}"
+export XDG_RUNTIME_DIR=/tmp/runtime-user
+mkdir -p "$XDG_RUNTIME_DIR"
+chmod 700 "$XDG_RUNTIME_DIR"
+
+# Read the password through stdin so it is not exposed in the htpasswd process argv.
+printf '%s\n' "$BROWSER_PASSWORD" | htpasswd -iBc /home/user/.browser.htpasswd "$BROWSER_USERNAME" >/dev/null
+chmod 600 /home/user/.browser.htpasswd
+
+# Do not pass credentials to Chromium, noVNC, or other child processes.
+unset BROWSER_PASSWORD BROWSER_USERNAME
+
+exec /usr/bin/supervisord -n -c /home/user/app/supervisord.conf

supervisord.conf

@@ -0,0 +1,83 @@
+[supervisord]
+nodaemon=true
+logfile=/dev/null
+pidfile=/tmp/supervisord.pid
+childlogdir=/tmp
+
+[program:xvfb]
+command=/usr/bin/Xvfb :99 -screen 0 %(ENV_BROWSER_WIDTH)sx%(ENV_BROWSER_HEIGHT)sx24 -ac -nolisten tcp
+autostart=true
+autorestart=true
+priority=10
+startsecs=1
+stopasgroup=true
+killasgroup=true
+stdout_logfile=/dev/fd/1
+stdout_logfile_maxbytes=0
+stderr_logfile=/dev/fd/2
+stderr_logfile_maxbytes=0
+
+[program:openbox]
+command=/home/user/app/scripts/launch-openbox.sh
+autostart=true
+autorestart=true
+priority=20
+startsecs=1
+stopasgroup=true
+killasgroup=true
+stdout_logfile=/dev/fd/1
+stdout_logfile_maxbytes=0
+stderr_logfile=/dev/fd/2
+stderr_logfile_maxbytes=0
+
+[program:chromium]
+command=/home/user/app/scripts/launch-browser.sh
+autostart=true
+autorestart=true
+priority=30
+startsecs=3
+stopasgroup=true
+killasgroup=true
+stdout_logfile=/dev/fd/1
+stdout_logfile_maxbytes=0
+stderr_logfile=/dev/fd/2
+stderr_logfile_maxbytes=0
+
+[program:x11vnc]
+command=/home/user/app/scripts/launch-x11vnc.sh
+autostart=true
+autorestart=true
+priority=40
+startsecs=1
+stopasgroup=true
+killasgroup=true
+stdout_logfile=/dev/fd/1
+stdout_logfile_maxbytes=0
+stderr_logfile=/dev/fd/2
+stderr_logfile_maxbytes=0
+
+[program:websockify]
+command=/usr/bin/websockify 127.0.0.1:6080 127.0.0.1:5900
+autostart=true
+autorestart=true
+priority=50
+startsecs=1
+stopasgroup=true
+killasgroup=true
+stdout_logfile=/dev/fd/1
+stdout_logfile_maxbytes=0
+stderr_logfile=/dev/fd/2
+stderr_logfile_maxbytes=0
+
+[program:nginx]
+command=/home/user/app/scripts/launch-nginx.sh
+autostart=true
+autorestart=true
+priority=60
+startsecs=1
+stopasgroup=true
+killasgroup=true
+stdout_logfile=/dev/fd/1
+stdout_logfile_maxbytes=0
+stderr_logfile=/dev/fd/2
+stderr_logfile_maxbytes=0