# 執行環境

go-browser 從主機讀取的環境變數、Chrome 執行檔位置與設定檔路徑。

## 環境變數

| 變數 | 影響 |
|---|---|
| `DISPLAY` | Linux 上非空即視為具備 GUI，啟用有頭重試與 session 網域的有頭模式 |
| `WAYLAND_DISPLAY` | 同上 |

macOS 無條件視為具備 GUI。兩者皆未設定的 Linux 主機只會使用 headless，不會因為嘗試啟動有頭瀏覽器而失敗。不讀取其他環境變數。

## Chrome 位置

### 執行檔搜尋

| 平台 | 順序 |
|---|---|
| macOS | `/Applications/Google Chrome.app/Contents/MacOS/Google Chrome` → `/Applications/Chromium.app/Contents/MacOS/Chromium` |
| Linux | `google-chrome` → `google-chrome-stable` → `chromium` → `chromium-browser`（`PATH` 內） |

都找不到時交由 go-rod 決定瀏覽器來源，必要時自行下載。

### 設定檔根目錄

| 平台 | 路徑 |
|---|---|
| macOS | `~/Library/Application Support/Google/Chrome` |
| Linux | `~/.config/google-chrome` |

`SameSession` 使用以 `Option.Profile` 命名的子目錄。其他平台或目錄不存在時，呼叫改以不帶 Cookie 繼續。不讀取 `~/.config/chromium` 下的 Chromium 設定檔。

## 外部指令

只有 `SameSession` 會執行外部指令：

| 指令 | 平台 | 用途 |
|---|---|---|
| `security` | macOS | 從鑰匙圈讀取 Chrome Safe Storage 密碼 |
| `secret-tool` | Linux | 從 Secret Service keyring 讀取同一組密碼 |
| `sqlite3` | 兩者 | 查詢複製出來的 Cookie 資料庫 |

## 容器

在 Docker 或 CI 中，把 Chrome 或 Chromium 裝在 `PATH` 上，不設 `DISPLAY` 以維持 headless，被擋的站點會直接回傳錯誤而不做有頭重試。`no-sandbox` 與 `disable-dev-shm-usage` 一律開啟，`/dev/shm` 過小不成問題。