在搬瓦工上部署 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=your_secure_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（参考教程）。
将你的域名（例如 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），足以支撑几人同时流畅观看。