使用 Docker 部署 Neko 自托管虚拟浏览器(Firefox)
Neko 是一个基于 WebRTC 的自托管虚拟浏览器环境,支持多人协作、远程访问和控制。本文将指导你通过 Docker 快速部署 Neko 并完成基本配置。
1. 拉取 Neko 镜像
首先拉取官方提供的 Firefox 版本镜像:
bash
docker pull ghcr.io/m1k1o/neko/firefox:latest
2. 创建数据目录
为 Neko 创建一个数据目录并赋予读写权限:
bash
mkdir -p /data/neko
chmod 777 /data/neko
3. 使用 Docker 命令直接运行
你可以通过 docker run 快速启动一个 Neko 容器:
bash
docker run -d \
--name neko \
-p 8080:8080 \
-p 56000-56100:56000-56100/udp \
-e NEKO_WEBRTC_EPR=56000-56100 \
-e NEKO_WEBRTC_NAT1TO1=你的服务器公网IP \
-e NEKO_MEMBER_MULTIUSER_USER_PASSWORD=neko@123 \
-e NEKO_MEMBER_MULTIUSER_ADMIN_PASSWORD=admin@123 \
ghcr.io/m1k1o/neko/firefox:latest
请将
你的服务器公网IP替换为实际 IP 地址。
4. 使用 Docker Compose(推荐)
为了便于管理和维护,推荐使用 Docker Compose。
4.1 编辑 Compose 文件
bash
vi /data/neko/docker-compose.yaml
写入以下内容:
yaml
services:
neko:
container_name: neko
image: ghcr.io/m1k1o/neko/firefox:latest
restart: unless-stopped
ports:
- "8080:8080"
- "56000-56100:56000-56100/udp"
environment:
NEKO_WEBRTC_EPR: "56000-56100"
NEKO_WEBRTC_NAT1TO1: "你的服务器公网IP"
NEKO_MEMBER_MULTIUSER_USER_PASSWORD: "neko@123"
NEKO_MEMBER_MULTIUSER_ADMIN_PASSWORD: "admin@123"
4.2 启动容器
bash
cd /data/neko/
docker-compose up -d
docker-compose ps
5. 查看容器日志
bash
docker logs -f neko
6. 访问 Neko 服务
在浏览器中访问:
http://你的服务器IP:8080
- 普通用户密码:
neko@123 - 管理员密码:
admin@123
7. Neko 基本使用
7.1 设置中文环境
进入浏览器后,点击地址栏输入 about:config,搜索 intl.accept_languages,将值改为 zh-CN,zh,en,重启浏览器即可。
7.2 切换显示分辨率
在 Neko 管理界面中,可以通过设置调整虚拟浏览器的分辨率,以适应不同终端显示需求。
7.3 获取页面控制权限
- 普通用户只能观看。
- 管理员或获得控制权限的用户可以操作浏览器。
- 在管理面板中可以将某个用户提升为控制者。
8. 注意事项
- 确保防火墙开放了
8080(HTTP)和56000-56100(UDP WebRTC)端口。 NEKO_WEBRTC_NAT1TO1必须填写正确的公网 IP,否则无法正常建立 WebRTC 连接。- 默认密码建议首次登录后立即修改。
结语
通过以上步骤,你已经成功部署了一个自托管的虚拟浏览器环境 Neko。它非常适合团队协作、远程演示、安全上网等场景。如有更多配置需求,可参考 Neko 官方文档。