power14345/grass-headless repository overview

⁠Grass Desktop（headless）for Docker / 帶寬共享節點

在 Linux / Docker 上跑 Grass 桌面版的無 GUI 版本。映像內不含 Grass 官方二進位檔： 第一次啟動時才向官方網址下載最新 Linux 安裝檔並解開到資料卷，因此本映像可公開分享， 也不會因為官方改版而失效。

Run the Grass desktop app headless on Linux/Docker. This image ships no Grass binary: the official Linux installer is downloaded from Grass on first start and unpacked into the data volume.

⁠⚡ Quick start / 快速開始

# grass.env（chmod 600）——登入憑證只在第一次登入時取得一次
GRASS_ACCESS_TOKEN=...
GRASS_REFRESH_TOKEN=...
GRASS_USER_ID=...

docker run -d --name grass-1 \
  --restart unless-stopped \
  --env-file grass.env \
  -e GRASS_DISPLAY=99 \
  -v grass-1:/data \
  power14345/grass-headless:latest

看到下列日誌就代表上線 / healthy log lines:

[entrypoint] 首次啟動：向官方取得 Linux 安裝檔
identity: device registered device_id="DV..."
opening bridge tunnel bridge=45.38.56.x

⁠Environment variables / 環境變數

⁠Lite 模式：每台約 58 MB

Grass 桌面版本質是 Tauri 應用，真正對外的加密通道在 Rust 主程序，GTK/WebKit 那層只負責畫介面。 啟動後把介面層關掉，實測記憶體從約 182 MB 降到 58 MB，共享完全正常：

GRASS_LITE=0 可關閉此行為。介面層若因重新登入而重生，進入點每 30 秒會再關一次。

⁠注意事項 / Notes

• 需要 Xvfb 虛擬顯示，沒有對外開任何連接埠、也沒有 noVNC。Xvfb 不能移除（移除後程式會崩潰重啟）。
• 主機的 Docker 預設 bridge 若沒有對外 NAT，請改用 --network=host，或把容器接到有 NAT 的自訂網路。
• 同一條出口 IP 上不要掛太多節點；建議一台主機 1 至 2 個，其餘分散到不同線路。
• 使用前請自行確認符合 Grass 的服務條款。本映像只做「把官方 Linux 版無介面化」，未修改任何官方程式。

⁠完整教學 / Full tutorial（中文）

建置流程、權杖取得、實測數據與疑難排解都寫在這裡：

https://www.i2345.me/520.html⁠

更多可在 Linux 上掛機的項目與實測：https://www.i2345.me/586.html⁠

⁠🎁 Grass 邀請連結 / Referral

還沒有帳號的話，用這個連結註冊：

https://app.grass.io/register?referralCode=4QMEld52GTf4qEd⁠

完整中文教學：https://www.i2345.me/520.html⁠