在搬瓦工上部署 NEKO，打造多人同步的「雲瀏覽器」

在日常工作和生活中，我們經常遇到以下兩個棘手的場景：

1.向零基礎客戶/朋友展示國際資源： 你需要向客戶演示一個國外的網站，或者發一個 YouTube 視頻給朋友看。但對方不懂技術，也不會安裝代理軟體（VPN），導致溝通受阻。

2.團隊異地協同演示： 你需要和異地的同事或客戶一起瀏覽同一個網頁，進行實時講解。傳統的「屏幕共享」畫質差、延遲高，且對方無法進行交互操作。

今天，我們將利用搬瓦工 VPS 的 海外網絡環境 和 CN2 GIA 低延遲 優勢，部署一個運行在 Docker 里的「雲端瀏覽器」（NEKO ）。

這套方案的優勢在於： 對方無需安裝任何軟體，只需在自己的瀏覽器里打開你發的連結，就能像操作本地電腦一樣，訪問國際網際網路，且你們看到的畫面是毫秒級同步的。

一、核心優勢與原理

無需翻牆：瀏覽器實際上是運行在搬瓦工 VPS 上的，你的本地瀏覽器只是在接收「視頻流」。因此，訪客端不需要任何代理工具。

多人同屏：支持多人同時進入房間。A 移動滑鼠，B 能立刻看到；B 輸入網址，A 能立刻跳轉。非常適合教學和演示。

低配置要求：本地電腦再卡也沒關係，網頁加載速度取決於 VPS 的性能（搬瓦工 GIA 線路加載極快）。

二、環境準備與配置要求

由於瀏覽器是「吃內存大戶」，而在本教程中我們主要針對搬瓦工 E-Commerce 1GB 內存的入門款進行優化，因此請務必關注以下要求：

1.伺服器推薦： 搬瓦工 E-Commerce 或 CN2 GIA 系列（低延遲是滑鼠操作跟手的關鍵）。

2.系統要求： Debian 12

3.內存要求：最低 1GB 內存，推薦配置 2GB 以上。

4.進階要求：安裝 Nginx Proxy Manager ，參考教程

三、部署 Docker 和 NEKO

我們將部署資源占用相對較小的 Firefox 版本，並針對 1G 內存進行了參數調優，本部分將一併完成 Docker 環境的安裝。

1.SSH 連接與基礎工具安裝

使用 SSH 工具連接到您的搬瓦工伺服器（推薦使用 Xshell 等工具，如果你是個人或家庭使用，可以下載 Xshell：下載連結），

然後執行下方命令安裝必要的工具。

apt-get install wget curl vim sudo unzip -y

為了優化編輯體驗，執行以下命令，防止後期使用 vi 編輯時出現剪貼板或格式報錯：

echo set clipboard=unnamed >> ~/.vimrc

增加 1G swap，保證程序的運行：

  sudo bash -c 'fallocate -l 1G /swapfile && chmod 600 /swapfile && mkswap /swapfile && swapon /swapfile && grep -qxF "/swapfile none swap sw 0 0" /etc/fstab || echo "/swapfile none swap sw 0 0" | tee -a /etc/fstab'

2.安裝並啟動Docker

執行下方命令安裝 Docker，安裝過程預計耗時數十秒。

wget -qO- get.docker.com | bash

Docker 安裝完成後，逐條執行以下命令啟動 Docker 服務並設置開機自啟：

systemctl start docker
systemctl enable docker

3. 創建部署目錄

連接 SSH，執行以下命令：

mkdir -p /root/neko && cd /root/neko

4. 創建 Docker Compose 配置文件

vim docker-compose.yml

直接複製粘貼以下內容（集成了 NEKO 和 Caddy）：提示：請務必將 your_secure_password 和 admin_password 修改為複雜密碼。

version: "3.4"
services:
  neko:
    image: m1k1o/neko:firefox
    restart: always
    # 【针对 1G 内存优化】将共享内存设为 1gb，配合 Swap 使用
    shm_size: "1gb"
    ports:
      - "8080:8080"  # Web 访问端口
      - "52000-52100:52000-52100/udp" # WebRTC 需要的 UDP 端口范围
    environment:
      # 【针对 1G 内存优化】分辨率设为 720P，显著降低 CPU 和内存压力
      # 如果你是 2G 内存以上机器，可改为 1920x1080@30
      - NEKO_SCREEN=1280x720@30
      - NEKO_PASSWORD=guest_password  # 【重要】普通用户密码（用于观看和操作）
      - NEKO_PASSWORD_ADMIN=admin_password  # 【重要】管理员密码（拥有踢人、强制抢夺控制权等权限）
      - NEKO_EPR=52000-52100
      - NEKO_ICELITE=1
      - NEKO_NAT_1_2_3_4=127.0.0.1 # 这里不需要改，程序会自动识别公网IP
    cap_add:
      - SYS_ADMIN

保證在英文輸入法下，按下 Esc 鍵，輸入 :wq 保存並退出。

5. 啟動服務

執行以下命令啟動所有容器：

docker compose up -d

三、配置域名與 HTTPS (使用 Nginx Proxy Manager)

直接使用 IP+埠訪問（HTTP）存在兩個問題：

1.安全性低： 密碼明文傳輸，容易被攔截。

2.功能受限： 瀏覽器的剪貼板共享和麥克風權限通常要求必須在 HTTPS 環境下才能正常工作。

因此，強烈建議使用 Nginx Proxy Manager (NPM) 配置反向代理和 SSL 證書。

1.準備工作

確保你已經安裝了 Nginx Proxy Manager（參考教程，從創建Nginx Proxy Manager目錄這步開始）。
將你的域名（例如 neko.yourdomain.com）解析到搬瓦工 VPS 的 IP 地址。

2.配置步驟

登錄 NPM 後台，點擊 Dashboard 上的 Proxy Hosts -> Add Proxy Host。
配置 Details (基本信息)：
- Domain Names: 填寫你的域名 neko.yourdomain.com
- Scheme: 保持 http
- Forward Hostname / IP: 填寫 127.0.0.1 (因為 NEKO 和 NPM 都在同一台 VPS 上)
- Forward Port: 填寫 8080
- Websockets Support: 【關鍵】必須勾選此項，否則畫面無法實時同步。
- Block Common Exploits: 勾選此項。
配置 SSL ：
- 點擊 SSL 選項卡。
- SSL Certificate: 選擇 Request a new SSL Certificate。
- Force SSL: 務必勾選，強制使用 HTTPS 訪問。
- Email Address: 填寫你的郵箱（可以隨意填寫）。
- I Agree: 勾選同意協議。
保存並測試：
- 點擊 Save 按鈕。等待幾秒鐘，證書申請成功後，列表狀態會變為 Online。
- 現在，在瀏覽器輸入 https://yourdomain.com，你會看到瀏覽器地址欄有「小鎖」圖標。

四、如何使用與訪問

1. 訪問域名

在瀏覽器輸入你的域名：https://yourdomain.com

2.登錄說明

Username: 這是一個顯示暱稱，不需要填寫系統特定的用戶名。你可以隨意填寫，例如 "Boss", "Guest"。這主要用於在右側列表區分當前房間裡有誰。

Password: 填寫你在 docker-compose.yml 中設置的密碼。

如果你輸入 NEKO_PASSWORD，會作為普通用戶進入。

如果你輸入 NEKO_PASSWORD_ADMIN，會作為管理員進入。

3.開啟操作功能

在圖示序號2部分點擊鍵盤圖標，則可以開啟操作功能，正常使用瀏覽器。

五、注意事項

1.控制標籤頁數量： 對於 1GB 內存的機器，建議同時打開的標籤頁不要超過 3-5 個。用完及時關閉，避免卡死。

2.不要登錄個人敏感帳號： NEKO 是一個共享環境。雖然有密碼保護，但建議將其視為「公共網吧電腦」，使用隱私模式瀏覽，或用完後登出帳號。

3.帶寬消耗： NEKO 本質是實時視頻流。如果多人同時在線，會消耗較多 VPS 帶寬。搬瓦工 E-Commerce 系列帶寬通常很大（2.5Gbps），足以支撐幾人同時流暢觀看。 index.php?title=Category:500 常見應用指南 — Application Guides