20k⭐开源Neko实战！NAS部署自托管远程浏览器，支持多人操作

首页 > 博客 > cpolar > 20k⭐开源Neko实战！NAS部署自托管远程浏览器，支持多人操作

前言

在日常运维、演示协作或者内网跳板场景下，我们常常会有这样的需求：想要一个隔离的浏览器环境，多人可以同步操作，又不想在本机安装各类软件，尤其对于NAS用户来说，如果能直接在NAS容器里运行浏览器，无疑会方便很多。

今天介绍的Neko正是这样一款收获 20k⭐Star 的开源项目。它可以将完整Firefox/Chrome浏览器运行在Docker容器之中，通过网页即可访问，实现自托管远程浏览器。支持多用户接入，区分管理员与普通用户权限，多人可以协同浏览网页、同步操作页面，非常适合团队演示、网页跳板、公开环境隔离访问等场景。

本文以NAS（fnOS）Docker部署为实战场景，完整带你完成Neko部署，同时解决UDP端口冲突、WebRTC黑屏、内外网访问、权限密码配置等高频踩坑点，最后搭配cpolar实现公网远程访问，随时随地打开浏览器就能使用容器内的浏览器环境。

1.什么是Neko？

Neko（n.eko）是GitHub 20k+⭐的开源自托管虚拟浏览器项目。简单讲：把完整Firefox/Chrome浏览器跑在 Docker 容器内部，我们只用普通网页，就可以操作容器里面的浏览器，依靠WebRTC做低延迟音视频画面串流。

工作原理

Docker容器内部运行一套微型桌面环境，里面装好火狐或者Chrome浏览器；通过WebRTC把浏览器画面、音频实时推送到你的普通浏览器网页上。所有网页访问、Cookie、缓存全部隔离在容器内部，不会污染你本机电脑环境。

核心特性

多用户权限区分：分为管理员、普通用户。管理员掌握鼠标键盘控制权，可以把操作权限交给其他人；普通用户只能观看，不能操作页面。
多浏览器镜像：官方提供Firefox、Chrome、Edge等镜像，可以按需选择部署。
隔离安全环境：浏览痕迹全部存在容器，销毁容器数据就全部清空，适合跳板访问、测试网页、高危网页隔离浏览。
内置聊天室：接入的用户可以在线文字聊天。
跨设备访问：电脑、平板、手机，只要有浏览器就能接入，不需要安装客户端。

典型使用场景

✅ 团队网页演示、线上评审，多人同步看同一个网页
✅ NAS / 服务器搭建跳板浏览器，访问内网 Web 管理页面
✅ 临时隔离上网环境，不留下本机痕迹
✅ 远程协助，不用复杂的远程桌面软件
✅ 搭配cpolar内网穿透，随时随地公网访问这台虚拟浏览器

2.前提条件

2.1ssh远程连接到极空间

开启【SSH 服务】
使用终端（Windows PowerShell / Mac Terminal）登录：

ssh root@IP

没有ssh的小伙伴可以参考这篇文章：

连接成功：极空间别再吃灰了！开启SSH，秒变全能服务器！ – cpolar 极点云官网

2.2验证docker是否开启

使用命令：

docker -v
systemctl status -v

没有docker的小伙伴可以参考这篇文章：极空间开箱实录：从拆箱到远程访问保姆级教程，30分钟上手！ – cpolar 极点云官网

3.安装Neko

docker一键部署

安装Neko:

Neko 没有固定账号名，昵称随便填，只认密码！n.eko

管理员权限：密码 admin1234（你环境变量设置的 NEKO_MEMBER_MULTIUSER_ADMIN_PASSWORD=admin1234）
普通用户权限：密码 neko1234（NEKO_MEMBER_MULTIUSER_USER_PASSWORD=neko1234）
注意把 192.168.x.x 替换成你服务器真实内网 IP，例如 192.168.1.100。

参数	说明
`docker run -d`	创建并启动容器；`‑d` 后台守护进程运行，不占用当前终端
`--name neko`	给容器命名为 neko，后续 `docker stop/rm neko` 直接用名字操作
`--shm-size=2gb`	设置容器共享内存为 2G。Firefox 必须加此参数，共享内存过小会直接崩溃、黑屏
`-p 8085:8080`	端口映射 `宿主机端口:容器内部端口`。8085 是网页访问端口，浏览器访问 `http://IP:8085`
`-p 56200‑56300:56200‑56300/udp`	UDP 端口段映射，WebRTC 视频流专用，必须 UDP 协议；用于传输浏览器画面音频。端口段内外必须保持一致
`‑e NEKO_WEBRTC_EPR=56200‑56300`	环境变量，告诉 Neko 容器内部 WebRTC 使用的 UDP 端口范围，必须和上面‑p 映射端口完全一致，不一致直接黑屏
`‑e NEKO_WEBRTC_NAT1TO1=192.168.1.100`	NAT 穿透地址。内网部署填写宿主机局域网 IP；公网访问填写公网 IP / 域名；严禁写 127.0.0.1，会黑屏看不到画面
`‑e NEKO_MEMBER_MULTIUSER_USER_PASSWORD=neko1234`	普通用户密码：只能观看画面，不能操控浏览器，昵称自定义
`‑e NEKO_MEMBER_MULTIUSER_ADMIN_PASSWORD=admin1234`	管理员密码：拥有鼠标键盘控制权，可以接管浏览器、管理其他用户
`ghcr.io/m1k1o/neko/firefox:latest`	镜像地址，拉取 firefox 版本 neko；也可以换成 chrome 镜像

docker run -d \
  --name neko \
  --shm-size=2gb \
  -p 8085:8080 \
  -p 56200-56300:56200-56300/udp \
  -e NEKO_WEBRTC_EPR=56200-56300 \
  -e NEKO_WEBRTC_NAT1TO1=192.168.1.100 \
  -e NEKO_MEMBER_MULTIUSER_USER_PASSWORD=neko1234 \
  -e NEKO_MEMBER_MULTIUSER_ADMIN_PASSWORD=admin1234 \
  ghcr.io/m1k1o/neko/firefox:latest

compose版本

docker-compose.yml
version: "3"
services:
  neko:
    image: ghcr.io/m1k1o/neko/firefox:latest
    container_name: neko
    ports:
      - "8085:8080"
      - "56200-56300:56200-56300/udp"
    environment:
      NEKO_WEBRTC_EPR: "56200-56300"
      NEKO_WEBRTC_NAT1TO1: "127.0.0.1"
      NEKO_MEMBER_MULTIUSER_USER_PASSWORD: "neko1234"
      NEKO_MEMBER_MULTIUSER_ADMIN_PASSWORD: "admin1234"

启动：

docker-compose up -d

部署完成后，在浏览器中输入 http://极空间IP:8085 就能看到Neko的界面：

4.使用Neko

Neko没有固定账号名，昵称随便填，只认密码！

管理员权限：密码 admin1234（你环境变量设置的 NEKO_MEMBER_MULTIUSER_ADMIN_PASSWORD=admin1234）
普通用户权限：密码 neko1234（NEKO_MEMBER_MULTIUSER_USER_PASSWORD=neko1234）

我使用的管理员密码登录成功啦！

点击右下角切换中文模式：

调节分辨率：

点击页面底部键盘按钮可以获取页面控制权限后，就可以使用浏览器了：

流畅的在浏览器中搜索~

接下来我们在打开一个网页，这次我们使用普通用户登录：

登录成功！成功看到管理员操作页面，但是现在键盘使用权在管理员那里，我们仅观看：

可以实时跟管理员对话：

管理员那边立刻接收到：

打开声音权限即可使用麦克风：

管理员解除键盘使用权限，普通用户就可以使用啦！

完成上面部署之后，Neko目前仅能在局域网内部访问。如果需要外出、异地设备也能使用这套虚拟浏览器，又没有公网IP，直接做路由器端口映射配置繁琐且存在安全风险。这里我们借助cpolar内网穿透工具，无需改动路由器，快速建立加密隧道，把部署在NAS上的Neko服务暴露至公网，随时随地通过公网链接访问多人协同浏览器。同时Neko依赖WebRTC UDP流，cpolar也支持UDP隧道，保障外网访问时画面正常传输，不会出现黑屏问题。

5.安装cpolar实现随时随地开发

5.1 什么是cpolar？

cpolar是一款安全高效的内网穿透工具，无需公网IP或复杂配置，只需一条命令，即可将本地服务器、Web服务或任意端口映射到公网，让你随时随地远程访问内网应用，特别适合开发调试、远程运维和应急部署等场景。

5.2 部署cpolar

cpolar 可以将你本地电脑中的服务（如 SSH、Web、数据库）映射到公网。即使你在家里或外出时，也可以通过公网地址连接回本地运行的开发环境。

❤️以下是安装cpolar步骤：

官网在此：https://www.cpolar.com

使用一键脚本安装命令：

sudo curl https://get.cpolar.sh | sh

安装完成后，执行下方命令查看cpolar服务状态：（如图所示即为正常启动）

sudo systemctl status cpolar

Cpolar安装和成功启动服务后，在浏览器上输入虚拟机主机IP加9200端口即:【http://ip:9200】访问Cpolar管理界面，使用Cpolar官网注册的账号登录,登录后即可看到cpolar web 配置界面,接下来在web 界面配置即可：

打开浏览器访问本地9200端口，使用cpolar账户密码登录即可,登录后即可对隧道进行管理。

6.配置公网地址

登录cpolar web UI管理界面后,点击左侧仪表盘的隧道管理——创建隧道：

隧道名称：可自定义，本例使用了:neko，注意不要与已有的隧道名称重复
协议：http
本地地址：8085
域名类型：随机域名
地区：选择China Top

创建成功后，打开左侧在线隧道列表,可以看到刚刚通过创建隧道生成了公网地址，接下来就可以在其他电脑或者移动端设备（异地)上，使用地址访问。

访问成功。

7.保留固定公网地址

使用cpolar为其配置二级子域名（cpolar官网-安全的内网穿透工具 | 无需公网ip | 远程访问 | 搭建网站），该地址为固定地址，不会随机变化。

点击左侧的预留，选择保留二级子域名，地区选择china Top，然后设置一个二级子域名名称，我使用的是neko，大家可以自定义。填写备注信息，点击保留。

登录cpolar web UI管理界面，点击左侧仪表盘的隧道管理——隧道列表，找到所要配置的隧道，点击右侧的编辑。

修改隧道信息，将保留成功的二级子域名配置到隧道中

域名类型：选择二级子域名
Sub Domain：填写保留成功的二级子域名
地区: China Top

点击更新

更新完成后，打开在线隧道列表，此时可以看到随机的公网地址已经发生变化，地址名称也变成了保留和固定的二级子域名名称。

最后，我们使用固定的公网地址在任意设备的浏览器中访问，可以看到成功访问的页面，这样一个永久不会变化的二级子域名公网网址即设置好了。

总结

本文完整实战演示了在NAS中通过Docker部署开源工具Neko，成功搭建了一套私有化、可多人协同的远程虚拟浏览器。相较于传统远程桌面、网页跳板工具，Neko依托WebRTC低延迟串流技术，实现了浏览器环境容器化隔离运行，所有浏览操作独立于本机系统，安全性与可控性更强。部署过程中，我们通过调整共享内存、修正WebRTC端口段、配置内网穿透等关键优化，解决了Neko常见的端口冲突、画面黑屏、仅限内网访问等痛点。同时借助cpolar内网穿透，实现了无公网IP外网远程访问，随时随地即可接入多人协同浏览环境。整体部署简单、资源占用低、权限划分清晰，非常适合NAS用户、团队协作演示、内网跳板访问与安全隔离浏览场景，是实用性极高的开源自托管工具。

感谢您对本篇文章的喜爱，有任何问题欢迎留言交流。cpolar官网-安全的内网穿透工具 | 无需公网ip | 远程访问 | 搭建网站

鸽子

我是鸽子，是这个网站的文章编辑之一！喜欢研究各种有趣的开源项目。希望大家喜欢我的文章！